Stop copy-pasting boilerplate. Start building.

An opinionated Next.js scaffold with the integrations you probably need.

npx create-loadout

Works on Mac, Windows, and Linux.

Why I Built This

Every new SaaS project starts the same way. Create the Next.js app. Add Tailwind. Set up shadcn. Copy your auth config from the last project. Wire up the database. Add Stripe. Configure error tracking. Set up analytics.

It's the same 2-4 hours every time. And every time, you're copy-pasting from old projects, fixing the inevitable drift, and wondering if you remembered everything.

Loadout gives you a fully-wired Next.js app in under a minute.

You pick your integrations. It scaffolds everything — services, API routes, typed env vars, even a CLAUDE.md so your AI assistant knows how the project is structured.

No more boilerplate archaeology. Just start building.

What You Get

your-app/
├── app/                    # Next.js App Router
├── components/             # React components + shadcn/ui
├── actions/                # Server actions
├── services/               # Business logic (DI-ready)
├── dao/                    # Data access layer (Drizzle ORM)
├── models/                 # DTOs, views, schemas, state
├── lib/
│   ├── config.ts           # Type-safe env vars
│   └── db/                 # Database client + schema
├── CLAUDE.md               # AI assistant context
├── .env.example            # Documented env template
└── .env.local              # Your secrets (gitignored)

Every integration follows the same pattern:

• Services for business logic
• Type-safe configuration
• Ready-to-use API routes where needed
• Zero magic — just clean, readable code

Available Integrations

| | Integration | What You Get | | :-: | ------------------ | ------------------------------------------ | | 🔐 | Clerk | Authentication + user service | | 🗄️ | Neon + Drizzle | Serverless Postgres with full CRUD example | | 🤖 | AI SDK | OpenAI / Anthropic / Google | | 📧 | Resend | Email service + React email templates | | 📬 | Postmark | Transactional email with top deliverability | | 🔥 | Firecrawl | Web scraping service | | ⏰ | Inngest | Background jobs | | 📁 | UploadThing | File uploads | | 💳 | Stripe | Payment service with checkout + billing | | 📊 | PostHog | Product analytics | | 🐛 | Sentry | Error tracking |

Always included: TypeScript, Tailwind, shadcn/ui, Zod, Zustand, Luxon

How It Works

Interactive Mode

npx create-loadout

Answer the prompts — project name, integrations, AI provider — and you're done.

Non-Interactive Mode

Skip the prompts entirely with CLI flags:

npx create-loadout my-app --clerk --neon-drizzle --stripe

All available flags:

--clerk              Clerk authentication
--neon-drizzle       Neon + Drizzle database
--ai-sdk             Vercel AI SDK
--ai-provider <p>    AI provider (openai, anthropic, google)
--resend             Resend email
--postmark           Postmark email
--firecrawl          Firecrawl web scraping
--inngest            Inngest background jobs
--uploadthing        UploadThing file uploads
--stripe             Stripe payments
--posthog            PostHog analytics
--sentry             Sentry error tracking

Add integrations to an existing project:

npx create-loadout --add --posthog --sentry

Use a config file:

npx create-loadout --config loadout.json

{
  "name": "my-app",
  "integrations": ["clerk", "neon-drizzle", "stripe"],
  "aiProvider": "anthropic"
}

List all integrations as JSON:

npx create-loadout --list

Start Building

cd your-app
npm run dev

Fill in .env.local and you're live.

MCP Server for Claude Code

Loadout ships an MCP server so Claude Code agents can scaffold and extend projects programmatically.

Register

claude mcp add create-loadout -- npx -y -p create-loadout create-loadout-mcp

Available Tools

| Tool | Description | |------|-------------| | list_integrations | List all integrations with metadata, env vars, and constraints | | create_project | Scaffold a new Next.js project with selected integrations | | add_integrations | Add integrations to an existing project | | detect_project | Check if a directory is a Next.js project, list installed/available integrations |

Architecture

Generated projects follow a layered architecture:

UI Components (app/, components/)
        ↓
Server Actions (actions/*.actions.ts)
        ↓
Services (services/*.service.ts)
        ↓
DAOs (dao/*.dao.ts + Drizzle ORM)
        ↓
Neon (Serverless Postgres)

Services use constructor-based dependency injection with singleton exports — optimized for Next.js serverless.

Development

git clone https://github.com/KylerD/loadout.git
cd loadout
npm install
npm run dev

# Build and test locally
npm run build
npm link
create-loadout

License

MIT