Getting Started
Create your first project with create-turbo-stack
Quick Start
npx create-turbo-stack my-projectThe CLI will guide you through:
- Package manager — bun, pnpm, npm, or yarn
- Organization scope — e.g.
@my-project - Database — Supabase, Drizzle, Prisma, or none
- API layer — tRPC v11, Hono, Next.js Routes, or none
- Authentication — Supabase Auth, Better Auth, Clerk, NextAuth, Lucia, or none
- CSS framework — Tailwind 4, vanilla, or CSS Modules
- UI library — shadcn/ui or none
- Linter — Biome, oxlint + Prettier, or ESLint + Prettier
- Apps — Add one or more apps (Next.js, Hono, Vite, etc.)
- Packages — Add shared packages (UI, utils, etc.)
- Integrations — Sentry, PostHog, React Email, Vercel AI SDK
After confirmation, the CLI generates all files, initializes git, and installs dependencies.
Using a Preset
Skip the prompts with a preset:
--preset takes a URL or a local file path:
# Built-in presets (hosted)
npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/minimal.json
npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/saas-starter.json
npx create-turbo-stack my-app --preset https://create-turbo-stack.dev/s/api-only.json
# A local file, or any community URL
npx create-turbo-stack my-app --preset ./my-stack.json
npx create-turbo-stack my-app --preset https://example.com/my-stack.jsonProject Structure
A generated project looks like this:
my-project/
├── apps/
│ └── web/ # Next.js app
│ ├── src/app/
│ │ ├── globals.css # Tailwind + @source directives
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── package.json # catalog: deps
│ └── tsconfig.json # extends @scope/typescript-config
├── packages/
│ ├── typescript-config/ # Shared TS configs
│ ├── env/ # Environment validation
│ └── ui/ # Shared UI components
│ ├── src/
│ │ ├── index.ts
│ │ └── globals.css
│ └── package.json
├── package.json # Root with catalog + workspaces
├── turbo.json # Task pipeline
├── biome.json # Linter config (or .oxlintrc.json / eslint.config.mjs)
└── .turbo-stack.json # CLI config (tracks selections)What's Next
cd my-project
bun devYour monorepo is ready. Add more apps or packages anytime:
npx create-turbo-stack add app
npx create-turbo-stack add package
npx create-turbo-stack add security # a ready-made registry packagePull ready-made workspace packages with cts add <name>, or
configure the project further via project config.