Developer Experience

Paved Path

• Local dev: pnpm + Turbo, Firebase Emulator Suite, Vercel CLI
• Pre‑commit: husky + lint‑staged (Prettier, ESLint, Jest on changed files)
• Docs: Docusaurus in /docs
• ADRs: /docs/adr/ (Markdown). RFCs: /docs/rfc/
• Preview deployments on PRs (Vercel)
• VSCode settings and recommended extensions committed

{
  "recommendations": [
    "esbenp.prettier-vscode",
    "dbaeumer.vscode-eslint",
    "bradlc.vscode-tailwindcss",
    "orta.vscode-jest"
  ]
}

{
  "lint-staged": {
    "**/*.{ts,tsx,js,jsx,md,css}": [
      "prettier -w",
      "eslint --max-warnings=0",
      "jest -o --bail --findRelatedTests"
    ]
  }
}

LLM Notes

• Generate docs in Markdown/MDX compatible with Docusaurus. Prefer small, composable PRs.