Getting Started

Clone → configure → running in 5 minutes.

Prerequisites

Tool	Version	Install
Node.js	22+	nvm install 22
pnpm	9+	npm i -g pnpm
Docker	24+	docs.docker.com
PostgreSQL	15+	via Docker (recommended)
Claude Code	latest	npm i -g @anthropic-ai/claude-code (optional, for AI agents)

1. Clone the template

git clone https://github.com/qwedsazxc78/ai-coding-nexjs-template.git my-saas
cd my-saas

2. Configure environment

cp next-app/.env.example next-app/.env.local

Required env vars:

# Database
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/saas_dev

# NextAuth v5
AUTH_SECRET=your-random-secret-here   # openssl rand -base64 32
NEXTAUTH_URL=http://localhost:3000

# OAuth (optional)
AUTH_GOOGLE_ID=...
AUTH_GOOGLE_SECRET=...

3. Start the database

# Using Docker Compose (recommended)
docker compose up -d db

4. Install dependencies and run migrations

cd next-app
pnpm install
pnpm db:generate    # generate Drizzle migrations
pnpm db:migrate     # apply migrations
pnpm db:seed        # seed test users (dev only)

5. Start the dev server

pnpm dev

Open http://localhost:3000.

Test credentials (after seeding):

• Admin: admin@example.com / Admin123!
• User: user@example.com / User123!

6. Install a module (optional)

# Install the landing page module
npx shadcn@latest add @saas/landing

# Install the account settings module
npx shadcn@latest add @saas/account

See the Module Catalog for all available modules.

Next Steps

• API Guide — understand route handlers and Server Actions
• Module Catalog — browse installable modules
• AI Agent Team — automate development with Claude Code
• Deploy Guide — deploy to Zeabur