Skip to main content

Developer Experience

Paved Path

  • Local dev: pnpm + Turborepo, 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

VSCode recommendations:

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

lint-staged:

{
"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.