Todo List
Full-stack task board on TanStack Start - Trello-like boards, lists and cards. Live demo
Stack
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
