Green Goods

Measures, tracks, and rewards the impact on gardens with a simple Progressive Web App.
https://github.com/greenpill-dev-guild/green-goods

Category: Biosphere
Sub Category: Biodiversity Citizen Science

Keywords

attestations biodiversity biodiversity-monitoring community conservation environment ethereum foundry greenpill impact ipfs public-goods pwa regenerative smart-contracts solidity tailwindcss typescript vite web3

Keywords from Contributors

optimize archiving measur transforms observation compose generic conversion animals projection

Last synced: about 20 hours ago
JSON representation

Repository metadata

Bringing community and environmental actions onchain to better measure, track and reward impact on local communities with a simple PWA.

https://github.com/greenpill-dev-guild/green-goods/blob/develop/

          # Green Goods

Green Goods is an offline-first, single-chain platform for documenting conservation work and proving impact on-chain. Operators approve gardener submissions, and the protocol anchors the results in Ethereum attestation infrastructure.

## Quick Start

```bash
git clone https://github.com/your-org/green-goods.git
cd green-goods
bun install

cp .env.example .env          # All packages share the root env file
vi .env                       # Populate keys (Base Sepolia is the default chain: 84532)

bun dev                       # Starts client, admin, indexer via pm2
```

Useful follow-ups:

- `bun dev:stop` — stop the pm2 services
- `bun exec pm2 logs ` — stream logs for `client`, `admin`, or `indexer`

## Common Commands

```bash
# Format, lint, test across the workspace
bun format && bun lint && bun test

# Build everything or target a package
bun build
bun --filter client build

# Contracts: compile, test, deploy through the wrappers
bun --filter contracts build
bun --filter contracts test
bun --filter contracts deploy:testnet    # runs deploy.js with the correct profile
```

Scripts live in `package.json`; contract-specific flows are described in the Contracts Handbook.

## Documentation

- [System Architecture](./docs/developer/architecture.md) — full system map and package summaries (GitBook canonical doc)
- [Developer Getting Started](./docs/developer/getting-started.md) — environment setup, testing, troubleshooting
- [Contracts Handbook](./docs/developer/contracts-handbook.md) — deployment, upgrades, schema care, validation
- [Product Overview](./docs/features/overview.md) — product architecture and data flow
- [Karma GAP Integration](./docs/developer/karma-gap.md) — appendix for the GAP attestation bridge

Package-specific READMEs:

- `packages/client/README.md` — offline-first PWA
- `packages/admin/README.md` — operator dashboard
- `packages/indexer/README.md` — Envio indexer
- `packages/contracts/README.md` — foundry project layout and scripts

## Contributing

- Stick to conventional commits (`feat(client): …`)
- Run `bun format && bun lint && bun test` before opening PRs
- Keep environment-only secrets in the root `.env` and never add package-level `.env` files

For more project background, automation guidelines, and tooling policies see `AGENTS.md` and the package-specific agent guides.

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 513
Total Committers: 7
Avg Commits per committer: 73.286
Development Distribution Score (DDS): 0.101

Commits in past year: 408
Committers in past year: 5
Avg Commits per committer in past year: 81.6
Development Distribution Score (DDS) in past year: 0.047

Name Email Commits
Afo c****t@a****o 461
0xWildhare s****9@g****m 31
dependabot[bot] 4****] 6
Cursor Agent c****t@c****m 6
Athus a****o@g****m 5
Alexander Mangel c****r@g****m 3
mrcn m****a@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 153
Total pull requests: 97
Average time to close issues: 4 months
Average time to close pull requests: 7 days
Total issue authors: 8
Total pull request authors: 3
Average comments per issue: 0.08
Average comments per pull request: 1.08
Merged pull request: 68
Bot issues: 0
Bot pull requests: 16

Past year issues: 62
Past year pull requests: 69
Past year average time to close issues: 23 days
Past year average time to close pull requests: 11 days
Past year issue authors: 8
Past year pull request authors: 3
Past year average comments per issue: 0.08
Past year average comments per pull request: 1.1
Past year merged pull request: 44
Past year bot issues: 0
Past year bot pull requests: 12

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/greenpill-dev-guild/green-goods

Top Issue Authors

  • Oba-One (127)
  • c-georgen (14)
  • marcaumdesign (4)
  • cauetomaz (3)
  • moose-code (2)
  • Cygnusfear (1)
  • NFTthat (1)
  • kitblake (1)

Top Pull Request Authors

  • Oba-One (75)
  • dependabot[bot] (16)
  • Cygnusfear (6)

Top Issue Labels

  • story (30)
  • design (21)
  • contract (20)
  • component (19)
  • state-logic (17)
  • documentation (14)
  • api (9)
  • bug (4)
  • infrastructure (4)
  • javascript (3)
  • enhancement (1)
  • good first issue (1)
  • impact-reporting (1)
  • priority: high (1)
  • size: large (1)
  • status: ready (1)
  • sprint: active (1)

Top Pull Request Labels

  • component (20)
  • contract (20)
  • api (17)
  • state-logic (17)
  • javascript (16)
  • dependencies (16)
  • documentation (3)
  • enhancement (2)
  • infrastructure (2)
  • database (2)

Score: 6.249975242259484