Bringing community and environmental actions onchain to better measure, track and reward impact.
Green Goods is an offline-first platform for documenting ecological and social work and proving impact on-chain. Operators approve gardener submissions, and the protocol anchors results in Ethereum attestation infrastructure.
git clone https://github.com/greenpill-dev-guild/green-goods.git
cd green-goods
bun setup # Checks deps, installs packages, creates .env
bun dev # Starts all services via PM2Prereqs: Node 22+, Bun, and Git. Docker is needed for local indexer work. Foundry is needed for contract work.
For local development on the standard 1Password CLI, keep OP_ENABLE_ENVIRONMENT_LOAD=false and put root-only op://... references such as ETHERSCAN_API_KEY_OP_REF=op://vault/item/field in .env. CI and service-account flows can still use OP_ENVIRONMENT for bulk loading.
Core local URLs: Client PWA (localhost:3001) • Admin (localhost:3002) • Docs (localhost:3003) • Indexer (localhost:8080) • Storybook (localhost:6006)
📖 docs.greengoods.app — Full documentation for users and developers
- Developer Getting Started — Setup, env bootstrap, local services, and first-run workflow
- Prompting Green Goods — Short repo-specific guide for working effectively with agents
- Architecture — System design, boundaries, and diagrams
- Builder API Index — Package APIs, contracts, and shared surfaces
- Operations — Build, deploy, environment, and workflow references
- How to Contribute — Contributor workflow and expectations
If you are working in this repo with Codex, Claude Code, or another coding agent, start here:
- Prompting Green Goods — the short prompt shape that matches this repo
- AGENTS.md — runtime rules and repo invariants
- CLAUDE.md — commands, patterns, and working conventions
Run bun format && bun lint && bun run test before opening PRs.