Quick Start

ds-start scaffolds a production foundation and lets you compose functional blocks (email, forms, auth, …) via presets or add. See Philosophy.

New Project

Scaffold a new Next.js project with the foundation stack:

npx ds-start init my-app

The interactive wizard asks what you want to build:

? What do you want to build?
> Recommended production starter
  App with auth
  Base app

Choose a build path and the wizard walks you through the rest — auth provider, optional modules, and a confirmation summary before scaffolding.

For CI or scripts, use flags directly:

npx ds-start init my-app --prisma --auth --stripe --email

Add a Module

Run from inside a supported Next.js project to install a module:

npx ds-start add email

Auto-merges package.json, .gitignore, and .env.schema. Prompts only for real file conflicts. Dependencies are not auto-installed — run bun install after adding modules.

Example Configurations

Recommended defaults (no prompts)

npx ds-start init my-app -y

Applies the recommended production preset: Prisma, Better Auth, email, and GitHub Actions CI.

Minimal scaffold

npx ds-start init my-app --base

Foundation only, no modules.

Full Stack

npx ds-start init my-app --prisma --auth --stripe --email --github-workflows

Clerk Stack

npx ds-start init my-app --clerk --stripe --email --file-uploads

API-Focused

npx ds-start init my-app --prisma --github-workflows

Everything

npx ds-start init my-app --prisma --auth --stripe --email --file-uploads --zustand --forms --github-workflows --vercel-deploy