BuildSmiths StarterKit
v2.0 Now Available

The AI-Native SaaS Starter

A minimalist Foundation for 2026. Next.js 16, Server Actions, and a unique Blueprint Architecture designed for AI code generation.

View Demo DashboardGitHub

Get Started in 5 Minutes

Everything you need to run locally is included.

Quickstart Guide
Defines the environment for both you and your AI agent.

Installation Checkpoints

bash
# 1. Clone & Enter
git clone https://github.com/buildsmiths/buildsmiths-nextjs-postgres-base.git my-saas
cd my-saas

# 2. Install & Configure
npm install
cp .env.example .env.local

# 3. Initialize Database (ensure Postgres is running)
npm run db:schema
npm run db:seed    # Optional: Adds test users

# 4. Start Development
npm run dev

Codebase Structure

app/Next.js App Router (Pages & API)
blueprints/Feature specs (Markdown)
components/React components (UI & Logic)
db/SQL migrations (schema.sql)
lib/Core access, auth, db, payments optional
scripts/Database management scripts
What's Included
  • NextAuth v4 pre-configured security.
  • Postgres Schema for Users & Subs.
  • Stripe Integration (Optional).
  • Dashboard UI (Shadcn/Tailwind).
Tech Stack
  • Next.js 16 App Router
  • Postgres (Raw SQL, no ORM)
  • Tailwind v4 + Shadcn

Explore the "Blueprints" pattern.

View Blueprints
Source Code

Open source and free to use. Licensed under MIT.

buildsmiths/buildsmiths-nextjs-postgres-base
Star on GitHub

Contributions welcome!

The "Blueprint" Architecture

We don't just give you code; we give you the instructions to build it with AI. Found in blueprints/features/, these markdown specs are designed to be fed into Copilot or Cursor.

blueprints/features/ai-sdk.md

Omni-Model AI Chat

Standardized Vercel AI SDK setup using OpenRouter. Switch between Claude 3.5 and GPT-4o via env vars without touching code.

> "Implement the AI SDK Blueprint. Install `ai` and `@ai-sdk/openai`..."
blueprints/features/async-jobs.md

Zero-Dependency Queue

A reliable Postgres-backed job queue for background tasks (emails, data processing) without adding Redis complexity.

> "Implement the Async Jobs Blueprint. Create a migration SQL file..."