Environment Bootstrap

Use this skill when

Use when first cloning a fork to a fresh machine, after rotating secrets in Vercel, when running into missing/undefined env errors locally, or before invoking bun run dev for the first time on a fork.

Workflow

  1. Make sure the working tree is linked to the right Vercel project (vercel link).
  2. Run scripts/bootstrap-env.sh to pull .env.local from Vercel and validate it against the env contract in setup-product/assets/env-contract.json.
  3. Confirm there are no raw process.env.* fallbacks in code via bun run env:check.
  4. Run integration-specific inspectors (stripe-setup, resend-domain-setup, db-health) to spot missing secrets per integration.
  5. Run bun run factory:check to confirm the fork still satisfies its contracts.

Skill graph

Read references/graph.md for routing. Related skills: setup-product, vercel-deployment, db-health, stripe-setup, resend-domain-setup.

References

Scripts

See scripts/README.md. Execute scripts when the workflow calls for deterministic inspection or validation.

Assets

See assets/README.md for templates/checklists.