Skip to main content

​
Prerequisites

  • Node.js 20+
  • pnpm 10+
  • local Postgres/Supabase credentials
  • .env based on project environment template

​
Install and Run

pnpm install
pnpm dev:full
pnpm dev:full runs backend and frontend together.

​
Verify Baseline

pnpm check
pnpm test:unit
pnpm test:integration
pnpm docs:check
Run pnpm test:e2e for UI/auth/public route changes.

​
Common Local URLs

  • app: http://localhost:5173 (Vite default)
  • API: http://localhost:3333/api
  • health: http://localhost:3333/api/health

​
First-Day Safety Rules

  • keep PR scope narrow
  • do not ship behavior changes without docs updates
  • do not touch auth/public routes without tests