Full-stack task board on TanStack Start - Trello-like boards, lists and cards. Live demo
- TanStack Start - SSR, server functions
- TanStack Router + TanStack Query
- React 19
- Better Auth
- Drizzle ORM + Neon Postgres
- Tailwind CSS v4 + shadcn/ui
- Vitest + Playwright
- Sentry, Vercel Analytics
- Integration and E2E each migrate an isolated Neon branch before running in CI. Previews share
stagingand migrate it before building. Production migrations run in CI after checks pass onmaster. Decision #26, decision #57, decision #27 - Board operations check the user's role before accessing the repository. SQL also limits access to boards the user owns or has joined. Integration tests cover access isolation. Decision #83
- Optimistic edits, server-confirmed creation and immediate soft delete with Undo - decision #55, decision #56
- Sentry wired with source maps via the Vite plugin, plus Vercel Analytics with normalized URLs - decision #38
- Playwright covers auth, route guards and data isolation in a separate CI job. Decision #28, decision #81
- Agent-assisted workflow: the owner approves a spec and accepts the PR on preview; an implementer subagent builds the feature and CI checks it -
CONTRIBUTING.md,CODING.md
flowchart LR
Browser -->|HTTPS| Vercel[Vercel: TanStack Start SSR + server functions]
Vercel --> Neon[(Neon Postgres)]
Vercel --> BetterAuth[Better Auth]
Vercel --> Sentry[Sentry]
GHA[GitHub Actions] -->|ephemeral branch| Neon
VercelPreview[Vercel preview deploy] -->|preview branch| Neon
npm ci
docker compose up -d
npm run db:migrate
npm run devRequires Docker and a .env with DATABASE_URL=postgresql://postgres:postgres@localhost:5432/main and BETTER_AUTH_SECRET. Local development uses Docker Postgres; CI, previews and production use Neon.
For integration and e2e, set DATABASE_URL=postgresql://postgres:postgres@localhost:5432/test in .env.test and .env.e2e; set BETTER_AUTH_SECRET in .env.e2e. Migrate the test database on a fresh volume, then run tests:
npx drizzle-kit migrate --config=drizzle.config.test.ts
npm run test:unit
npm run test:integration
npm run test:e2e- DOCUMENTATION.md - project map
- DECISIONS.md - decision log (ADR)
- CONTRIBUTING.md - GitHub workflow
- CODING.md - code review lessons