Skip to content

EXTENDING.md

Latest commit

 

History

History
77 lines (53 loc) · 1.51 KB

EXTENDING.md

File metadata and controls

77 lines (53 loc) · 1.51 KB

Extending the Starter

Owner: Nick Last Verified: 2026-03-05 Status: Active

Add a New Domain

  1. Scaffold:
pnpm scaffold:domain --name accounts --wire
  1. Refine generated files to your product logic.
  2. Update docs/product-specs/accounts.md with real acceptance criteria.
  3. Run pnpm check:all.

Bootstrap a Monorepo Workforce Starter

  1. Scaffold a Next.js app and FastAPI service:
pnpm scaffold:workforce --web studio --api core
  1. Install JS dependencies:
pnpm install
  1. Start the Next app:
pnpm --dir apps/studio dev
  1. Start the FastAPI service (optional):
cd services/core
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
uvicorn app.main:app --reload --port 8000

Run Multiple App Workspaces Together

If you have several JS apps under apps/*, run them together:

pnpm dev:all

The command prints and uses deterministic local ports so each app is reachable without manual coordination.

Add New Guardrails

  1. Implement script under scripts/.
  2. Expose command in package.json.
  3. Add CI workflow or extend existing workflow.
  4. Add tests in tests/.

Add New Evidence Contracts

  1. Add endpoint/signal in app runtime.
  2. Extend verifier scripts under scripts/verify-*.ts.
  3. Output machine-readable artifact under artifacts/.
  4. Update review checklist in docs/REVIEW_LOOP.md.

Keep Docs Healthy

  • Link every new doc from an index.
  • Keep Last Verified current.
  • Run pnpm doc:garden regularly.