Buildsmiths
Quickstart

Initialize Protocol

Everything you need to launch locally is pre-configured. Drop straight into the forge.

1

Clone & Enter

Pull the repository and move into your new workspace directory.

2

Install & Configure

Install dependencies and set up your local environment variables.

3

Database Sync

Push the schema to your local Postgres instance and seed initial test data.

terminal
# 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
$ npm run db:schema
$ npm run db:seed # Optional mock data
# 4. Start Development
$ npm run dev
Architecture

A Stack That Doesn't Fight You

We stripped away the noise. What's left is pure, scalable, AI-friendly infrastructure.

Next.js 16 App Router

Server Components and Actions by default. Maximum performance, zero hydration waterfalls.

Raw Postgres

No heavy ORM overhead unless you want it. Pure SQL migrations and straightforward schema design for absolute control.

NextAuth v4 Pre-Set

Bulletproof authentication ready out of the box. OAuth, Magic Links, and session management fully wired.

blueprints/features/ai-sdk.md

The "Blueprint" Pattern

Stop copy-pasting. We give you exact markdown instructions crafted for LLMs. Feed perfectly-scoped specs into Copilot or Cursor to generate features—like Stripe integrations, AI chat, or async job queues—in seconds.

> "Implement the AI SDK Blueprint. Follow the instructions to install the Vercel AI SDK and connect OpenRouter..."

Core Deliverables

  • Shadcn + Tailwind UI
  • Stripe Subscriptions
  • Modular File Structure
  • Vitest & In-Memory DB

Ready to ship your next product?

The Buildsmiths ecosystem is powered by this exact open-source stack. Grab the code, boot the server, and start forging.