Internal template

Start the project, not the setup.

The house stack, wired together and documented: Next.js on Vercel, Supabase, Drizzle, Tailwind and shadcn, with the interactions and transitions already settled. Clone it and write the feature.

The design system is already decided

Four semantic hues, two fill weights each, one motion curve. A /styleguide route renders every token and component from the same source the product uses, so it is the reference and the regression test at once.

The boring parts are wired

Validated environment variables, an access boundary that denies by default, SSO and magic-link sign-in, a health check, and a cron route that refuses everything when its secret is unset.

One pattern per problem

Server actions returning { ok, message }. Forms that work before hydration. Optimistic writes that take themselves back. Every convention documented where you will read it, next to the code.

What's inside

Framework
Next.js App Router, React 19, TypeScript strict
Styling
Tailwind v4, shadcn/ui, three-face type system
Data
Supabase Postgres via Drizzle, typed schema, seed script
Auth
Supabase Auth — SSO providers plus one-time email links
Hosting
Vercel, syd1, cron and env contract set up

Cloning this for a new project?

Read the README, then the styleguide. Between them they cover every decision you would otherwise have to make again.

Open the styleguide