NextBase

Documentation

Start quickly, then adapt deliberately.

NextBase is meant to be understandable on day one. The docs page covers the initial setup path, the scripts that matter, and the structure intended to survive real product work.

Start With NextBaseRead the Docs
Setup
Install dependencies, add the required environment variables, push the database schema, and start the dev server.
This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.
Auth + Email
Email/password auth, verification, and password reset flows are wired for local SMTP with Mailpit and production delivery with Resend.
This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.
Quality Gates
Use lint, typecheck, build, component tests, and Playwright smoke tests as the minimum bar before shipping.
This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.
Architecture
The app is split around App Router layouts, typed env parsing, Drizzle schema ownership, and reusable UI primitives.
This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.