Todo List

Full-stack task board on TanStack Start - Trello-like boards, lists and cards. Live demo

Stack

• 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

Engineering highlights

• CI runs against an ephemeral Neon branch per run, not a shared test DB - decision #26
• Migrations run on ephemeral CI branches before tests, on preview via vercel-build, and on master in CI - decision #45, decision #47
• Previews share one Neon staging branch, migrated by vercel-build before the build - decision #55
• Ownership is checked on every request via a join, not a separate query, with integration tests covering IDOR - decision #10, decision #48
• Optimistic updates with a deferred-commit delete + Undo toast, instead of instant hard delete - decision #5
• Sentry wired with source maps via the Vite plugin, plus Vercel Analytics with normalized URLs - decision #35, decision #38
• E2E coverage on Playwright for auth, route guards and data isolation, run as its own CI job - [decision #28](DECISIONS.md#28-2026-09-23--e2e-на-playwright-p0-authгварды изоляция), decision #31
• Agent-assisted workflow: the owner approves a spec and accepts the PR on preview; an implementer subagent builds the feature to green CI, a verifier subagent reviews it and walks the scenarios - CONTRIBUTING.md, decision #56, CODING.md

Architecture

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

Getting started

npm ci
npm run db:migrate
npm run dev

Requires a .env with DATABASE_URL, DATABASE_URL_UNPOOLED (Neon connection strings) and BETTER_AUTH_SECRET.

Tests:

npm run test:unit
npm run test:integration
npm run test:e2e

Docs

• DOCUMENTATION.md - project map
• DECISIONS.md - decision log (ADR)
• CONTRIBUTING.md - GitHub workflow
• CODING.md - code review lessons