Technology Stack

Every dependency must have a reason · reference (live explorer lands in Phase H)

RC

Next.js 16.3.6

Selected

Frontend

App framework (RSC, routing, SSR)

Tailwind CSS v4

Selected

Frontend

Design tokens + utility styling

shadcn/ui

Selected

Frontend

Owned accessible primitives

Lucide React

Selected

Frontend

Icon system

Route Handlers + Server Actions

Selected

Backend

API + mutations, Zod-validated

Zod

Selected

Backend

Input validation on every mutation

PostgreSQL (Supabase)

Selected

Database

System of record, RLS boundary

Drizzle ORM

Selected

Database

Typed schema, migrations, queries

Supabase Auth

Selected

Auth

Email+password, magic link, OAuth stubs

Supabase Storage

Selected

Storage

Private buckets, no local-FS uploads

Vitest + Playwright

Selected

Testing

Unit + E2E + a11y smoke

GitHub Actions → Vercel

Selected

CI/CD

Lint/typecheck/test/build/e2e gates

Vercel

Selected

Hosting

Web runtime at roadmapchurch.crdo.site

Sentry + Vercel Observability

Planned

Monitoring

Errors + logs + traces