Presets

A preset is a JSON file that describes a complete stack configuration. Instead of answering CLI prompts, pass a preset URL (or local file path) to --preset to scaffold instantly.

Built-in Presets

Hosted at https://create-turbo-stack.dev/s/<name>.json.

minimal

Next.js + UI package + Tailwind 4 + Biome. The simplest starting point.

npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/minimal.json

saas-starter

Full-stack SaaS: Supabase (DB + Auth), tRPC v11, shadcn/ui, i18n, Sentry, PostHog, React Email.

npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/saas-starter.json

api-only

Hono standalone API with Drizzle ORM and Upstash rate limiting. No frontend.

npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/api-only.json

Using a Community Preset

Anyone can host a preset at any URL:

npx create-turbo-stack --preset https://example.com/my-stack.json

Preset Schema

Presets must conform to the preset JSON schema.

{
  "$schema": "https://create-turbo-stack.dev/schema/preset.json",
  "name": "my-preset",
  "version": "1.0.0",
  "basics": {
    "projectName": "my-project",
    "packageManager": "bun",
    "scope": "@my-project",
    "typescript": "strict",
    "linter": "biome",
    "gitInit": true
  },
  "database": { "strategy": "none" },
  "api": { "strategy": "none" },
  "auth": { "provider": "none", "rbac": false, "entitlements": false },
  "css": { "framework": "tailwind4", "ui": "shadcn", "styling": "css-variables" },
  "integrations": {
    "analytics": "none",
    "errorTracking": "none",
    "email": "none",
    "rateLimit": "none",
    "ai": "none",
    "envValidation": true
  },
  "apps": [
    { "name": "web", "type": "nextjs", "port": 3000, "consumes": ["ui"] }
  ],
  "packages": [
    { "name": "ui", "type": "react-library", "producesCSS": true }
  ]
}

Validation

Presets are validated with Zod. Invalid combinations are rejected:

supabase-auth requires database.strategy: "supabase"
i18n only works with web-facing apps (Next.js, SvelteKit, Astro)
App names and ports must be unique
consumes must reference existing packages