Skip to main content

Environment Management

Green Goods uses one root .env. Package-level environment files are unsupported.

Setup​

  1. Run npm run setup only on a fresh machine before Bun is available; otherwise use the Bun scripts in package.json.
  2. Initialize the local template with bun run env:template:init.
  3. Resolve shared values through the configured 1Password workflow with bun run env:sync.
  4. Validate names, required values, and schema compatibility with bun run env:check.

.env.schema owns variable requirements. .env.template is the shareable shape. Never place secret values in docs, logs, fixtures, package-level files, or generated projections.

If validation fails, fix the root environment source and rerun the check; do not add a package override to bypass it.