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 #57
- Ownership is checked on every request via a join, not a separate query, with integration tests covering IDOR - decision #48
- 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
- E2E coverage on Playwright for auth, route guards and data isolation, run as its own CI job - decision #28, decision #31
- 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
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
docker compose up -d
npm run db:migrate
npm run dev
Requires 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
Docs
