init
Scaffold a new Next.js project with the ds-start foundation stack.
Usage
npx ds-start init <project-name> [flags]Scaffolds a new Next.js project in the specified directory with the full foundation stack. When no module flags are provided, an interactive wizard guides you through three build paths.
Interactive Wizard
Running init without module flags launches the wizard:
$ npx ds-start init my-app
? What do you want to build?
> Recommended production starter
App with auth
Base appRecommended production starter
Applies the recommended preset — Prisma + Postgres, Better Auth, transactional email, and GitHub Actions CI — then asks about optional extras:
? What do you want to build? Recommended production starter
? Add Stripe billing? No
? Add file uploads? No
? Add form renderer? No
? Add Zustand? No
? Add Vercel deployment workflow? No
? Install dependencies? Yes
┌─────────────────────────────────────┐
│ Scaffold my-app with: │
│ - Next.js base │
│ - Prisma + Postgres │
│ - Better Auth │
│ - Transactional email │
│ - GitHub Actions CI │
│ │
│ Initialize git: yes │
│ Install dependencies: yes │
└─────────────────────────────────────┘
? Continue? YesApp with auth
Choose Better Auth or Clerk, then select additional modules:
? What do you want to build? App with auth
? Auth provider? Better Auth
? Database adapter? Prisma + Postgres
? Add Stripe billing? No
? Add transactional email? Yes
? Add file uploads? No
? Add form renderer? No
? Add Zustand? No
? Add GitHub Actions CI? Yes
? Add Vercel deployment workflow? No
? Install dependencies? Yes
┌─────────────────────────────────────┐
│ Scaffold my-app with: │
│ - Next.js base │
│ - Prisma + Postgres │
│ - Better Auth │
│ - Transactional email │
│ - GitHub Actions CI │
│ │
│ Initialize git: yes │
│ Install dependencies: yes │
└─────────────────────────────────────┘
? Continue? YesBase app
Scaffolds the foundation with no modules. Same result as --base:
? What do you want to build? Base app
? Install dependencies? Yes
┌─────────────────────────────────────┐
│ Scaffold my-app with: │
│ - Next.js base │
│ │
│ Initialize git: yes │
│ Install dependencies: yes │
└─────────────────────────────────────┘
? Continue? YesNon-interactive Paths
Skip prompts with recommended defaults
npx ds-start init my-app -yApplies the recommended production preset (Prisma, Better Auth, email, GitHub Actions CI) without prompts.
Minimal scaffold
npx ds-start init my-app --baseFoundation only, no modules. Cannot be combined with module flags.
Examples
Full Stack
npx ds-start init my-app --prisma --auth --stripe --email --github-workflowsClerk Stack
npx ds-start init my-app --clerk --stripe --email --file-uploadsAPI-Focused
npx ds-start init my-app --prisma --github-workflowsEverything
npx ds-start init my-app --prisma --auth --stripe --email --file-uploads --zustand --forms --github-workflows --vercel-deployWhat It Creates
The init command generates a complete Next.js project with:
- Next.js App Router with TypeScript (strict mode)
- Tailwind CSS 4 + shadcn/ui
- Bun as the package manager
- oxlint + oxfmt configuration
- Environment validation setup
- Any selected optional modules
- Agent instructions and workflows