Convex Stack Template

A reusable, project-agnostic starter for building fullstack apps with:

• pnpm 10 + Turborepo
• Next.js (App Router) web starter
• Tailwind v4 + shared theme tokens
• shadcn/ui-ready primitives in packages/ui
• Convex backend starter
• Better Auth 1.5.3 + @convex-dev/better-auth baseline
• T3 env validation via @t3-oss/env-nextjs
• Shared validators/auth/backend packages
• Agent standards + Codex task workflow guidance

Workspace Layout

• apps/web: Next.js app shell + client wiring + validated env
• packages/backend: Convex schema/functions/auth baseline
• packages/auth: Better Auth client/env helpers
• packages/ui: reusable UI primitives + theme layer
• packages/validators: reusable zod validators
• tooling/*: shared TS/ESLint/Prettier/Tailwind configs
• agent-os/standards: team execution standards
• .codex: Codex project workflow guidance

First Run

1. cp .env.example .env
2. pnpm install
3. pnpm -F @template/backend run convex:dev (in one terminal)
4. pnpm dev

Detailed checklist: docs/first-run-checklist.md. Quality gates: docs/template-quality-gates.md.