saas-init

CLI scaffolding tool that generates production-ready SaaS projects on top of Next.js.

Install

npm install -g saas-init

Or use directly without installing:

npx saas-init init

Usage

saas-init init

The CLI walks you through a short prompt sequence:

1. Project name (lowercase, npm-valid, e.g. my-app)
2. Output directory (default: ./<project-name>)
3. Auth provider
4. Database
5. Payments (optional)
6. Email (optional)
7. Summary — confirm before any files are written

After confirming, saas-init generates the project files and optionally runs pnpm install in the output directory.

What's Included

Every generated project comes with:

• Landing Page: Production-ready landing page with multiple sections (hero, problem agitate, value proposition, social proof, transformation, CTA, footer). Fully customizable via template variables.
• Docker: Pre-configured Dockerfile and docker-compose.yml for easy containerization.
• GitHub Actions: Automated CI workflow for testing and linting on every push and PR.

Supported Stack Options

Category	Options
Auth	Clerk, NextAuth, Supabase Auth
Database	Postgres (Drizzle), SQLite (Drizzle), Supabase
Payments	Stripe, Lemon Squeezy, None
Email	Resend, Postmark, None

Adding a New Provider

1. Add templates under templates/<category>/<provider>/. Use {{key}} placeholders for variables that come from ProjectConfig.

2. Create a generator at src/generators/<category>/<provider>.ts that exports:

   export async function generate(config: ProjectConfig, outDir: string): Promise<void>

   Inside it, use the file utilities to copy templates and merge dependencies:

   import path from 'path'
   import fs from 'fs-extra'
   import { writeTemplate, appendEnv } from '../../utils/files.js'
   import { mergeDeps } from '../../utils/deps.js'
   import { TEMPLATES_ROOT } from '../../utils/paths.js'
   
   const TEMPLATES_DIR = path.join(TEMPLATES_ROOT, '<category>/<provider>')
   
   export async function generate(config: ProjectConfig, outDir: string): Promise<void> {
     await writeTemplate(
       path.join(TEMPLATES_DIR, 'lib/client.ts'),
       path.join(outDir, 'lib/client.ts'),
       {}
     )
     const pkgPath = path.join(outDir, 'package.json')
     const pkg = await fs.readJson(pkgPath)
     pkg.dependencies = mergeDeps(pkg.dependencies ?? {}, { '<package>': '^1.0.0' })
     await fs.writeJson(pkgPath, pkg, { spaces: 2 })
     await appendEnv(outDir, { MY_API_KEY: '' })
   }

3. Register the generator in src/generators/index.ts by adding it to the relevant map (e.g. authGenerators, databaseGenerators, etc.).

4. Add the new value to the relevant union type in src/types.ts and the matching zod enum in projectConfigSchema.

5. Add a prompt option in src/prompts/<category>.ts.

6. Write tests in tests/generators/<category>/<provider>.test.ts following the patterns of existing generator tests.

Requirements

• Node.js >= 18
• pnpm (for generated projects)