Developer Guide
Welcome to the @saas Next.js Template developer documentation. This guide covers everything you need to develop, test, deploy, and extend the template.
Quick Navigation
| Section | Description |
|---|---|
| Quick Start | Clone → configure → run in 5 minutes |
| API Guide | Route handlers, Server Actions, auth patterns |
| Testing | Vitest unit + Playwright e2e, coverage gate |
| Deployment | Zeabur deployment, env vars, zero-downtime |
| Changelog | Version history and migration notes |
Guides
| Guide | Description |
|---|---|
| Quick Start (Guide) | Step-by-step first run |
| First Epic Walkthrough | Full epic pipeline demo |
| Deploy Guide | Production deployment checklist |
| Fork Security Setup | Secure your fork for production |
| Memory System | How agent memory tiers work |
| AI Agent Team | 12 agents — roles and invocation |
| Custom Agents | Author your own Claude Code agents |
| Autopilot Mode | Confidence-gated auto-execution |
Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 App Router |
| UI | React 19 + TypeScript + Tailwind v4 + shadcn/ui |
| Auth | NextAuth v5 (JWT, stateless) |
| Database | Drizzle ORM + PostgreSQL 15 |
| RBAC | 3-tier: viewer / editor / admin |
| Billing | PaymentProvider abstraction (Stripe + ECPay) |
| Tests | Vitest + Playwright (>=80% coverage gate) |
| Deploy | Zeabur (one service, next-app/) |
| AI Dev | Claude Code + 12 specialized agents |