Buildsmiths
v2.0 Now AvailableMIT License

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 DashboardGet Started in 5 Minutes

AI Coding Context

AI Context

Hi! I am using the BuildSmiths StarterKit. Here is my context:

Stack

  • Next.js 16
  • Postgres (pg - raw SQL)
  • Tailwind v4
  • Shadcn UI
  • NextAuth v4

Feature Blueprints

  • Stripe Billing
    Subscription tiers and webhooks.
  • Google Auth
    Production OAuth configuration.
  • AI SDK
    Integration for LLM features.
Installation

Quickstart Guide

Everything you need to run locally is included.

bash

# 1. Clone & Enter

git clone https://github.com/buildsmiths/buildsmiths-nextjs-postgres-stripe.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

AI-First

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.

🤖

Omni-Model AI Chat

blueprints/features/ai-sdk.md

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`..."
âš¡

Zero-Dependency Queue

blueprints/features/async-jobs.md

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..."

Codebase Structure

  • app/Next.js App Router
  • blueprints/Feature specs (MD)
  • components/React UI & Logic
  • db/SQL migrations
  • lib/Core logic
  • scripts/DB management
  • tests/Vitest suite

What's Included

  • ✅ NextAuth v4 pre-configured security
  • ✅ Postgres Schema for Users & Subs
  • ✅ Stripe Integration (Optional)
  • ✅ Dashboard UI (Shadcn/Tailwind)
  • ✅ Vitest suite with in-memory DB