CLI Options
The CLI supports flags for non-interactive automation and reproducibility. Use flags to skip prompts and create projects with predefined configurations.
Non-Interactive Mode
Pass flags to create a project without interactive prompts:
bunx create-faster my-project [options]You can combine flags with prompts for a hybrid approach: provide known values via flags and, in an interactive terminal, the CLI prompts for the database, ORM, deployment, linter and tooling you did not set. Without a terminal (CI, scripts, agents) nothing is prompted: those choices stay empty, there is no git and no install unless a flag says otherwise.
To state "no selection" explicitly, pass none to a category flag (--database none, --linter none, --deployment none, --orm none, --tooling none). To skip every prompt no flag answers in a terminal, pass --yes.
Available Flags
Project Directory (Positional)
bunx create-faster [project-dir]The first argument is the project directory: a name, or a relative or absolute path. The project name is its last segment and must be a valid package name (lowercase letters, digits, -, _ and ., starting with a letter or digit). If omitted, the CLI prompts for it, and the prompt accepts a path too.
Example:
bunx create-faster my-saas
bunx create-faster ../out/my-saasThe second command writes the project to ../out/my-saas and names it my-saas.
--blueprint <name>
Use a pre-composed starter project. Mutually exclusive with --app, --database, and --orm.
Options: org-dashboard-nextjs, org-dashboard-tanstack-start, multitenant-saas-nextjs, showcase-nextjs, cloudflare-static-site-nextjs, cloudflare-fullstack-nextjs, dapp-privy-nextjs, dapp-rainbowkit-nextjs, lambda-sst-hono, lambda-terraform-aws-hono
Example:
bunx create-faster my-dashboard \
--blueprint org-dashboard-nextjs \
--linter biome \
--git \
--pm bunBlueprints define the stacks, libraries, database, ORM, and sometimes deployment. You choose the linter, tooling, git, and package manager. See Blueprints for details.
--app <name:stack:libraries>
Define an application to create. Repeatable for multi-app projects.
Format: name:stack or name:stack:library1,library2
Stacks: nextjs, expo, tanstack-start, hono, node
Examples:
--app web:nextjs
--app web:nextjs:shadcn,tanstack-query
--app mobile:expo:nativewind
--app api:hono
--app worker:node
--app web:tanstack-start:shadcnUse multiple --app flags for multi-app monorepos:
bunx create-faster my-saas \
--app web:nextjs:shadcn,mdx \
--app mobile:expo:nativewind \
--app api:hono--database <provider>
Select a database provider.
Options: postgres, mysql, sqlite, d1
With --database d1, --deployment cloudflare is required. sqlite is rejected with --deployment cloudflare (Workers have no filesystem, use d1 instead), --deployment sst and --deployment terraform-aws (Lambda has no persistent writable disk, use postgres or mysql).
Example:
--database postgres--orm <provider>
Select an ORM. Requires --database to be specified.
Options: prisma, drizzle
With --database sqlite, only drizzle is supported.
Example:
--database postgres --orm drizzle--git / --no-git
Initialize a Git repository after generation, or explicitly skip it.
Example:
--git
--no-git--pm <manager>
Select a package manager for dependency installation.
Options: bun, npm, pnpm
Example:
--pm bunIf omitted, the CLI prompts for installation preferences.
--no-install
Skip dependency installation entirely. The formatter step below is skipped too, and the summary lists its command.
Example:
--no-install--no-agent-context
Skip generation of AGENTS.md, CLAUDE.md, and blueprint docs/agents/ files. Agent context is generated by default.
Example:
--no-agent-contextSee Agent Context for details.
--linter <name>
Select a linter/formatter. A linter with a formatter (biome, oxc, prettier, eslint-prettier) formats the generated files right after the dependencies are installed, so the new project passes its own format check. If that step fails, the CLI warns with the command to rerun and still succeeds.
Options: biome, oxc, eslint-prettier, eslint, prettier
Example:
--linter biome--deployment <name>
Select a deployment platform. Generation is stack-aware per app: a Next.js app gets OpenNext config, a Hono app gets a Workers config.
Options: cloudflare, cloudflare-static, sst, terraform-aws
cloudflare-static builds a Next.js static export and serves out/ as Workers static assets. It is Next.js-only and incompatible with server-dependent libraries (better-auth, trpc).
Example:
--deployment cloudflareSee Cloudflare Workers, Cloudflare Workers (static), SST, and Terraform (AWS) for details.
--tooling <name>
Add a development tool. Repeatable for multiple tools.
Options: husky
Example:
--tooling huskyNote: husky requires --git and --linter to be specified.
--version / -V
Print the installed version of create-faster and exit. It needs no other argument and no terminal.
Example:
bunx create-faster --versionDependency Rules
The CLI validates flag combinations to ensure compatibility:
Blueprint is exclusive:
# ❌ Invalid - Blueprint with --app, --database, or --orm
bunx create-faster myapp --blueprint org-dashboard-nextjs --app web:nextjs
# ✓ Valid - Blueprint with linter, tooling, git, pm
bunx create-faster myapp --blueprint org-dashboard-nextjs --linter biome --git --pm bunORM requires Database:
# ❌ Invalid - ORM without database
bunx create-faster myapp --orm drizzle
# ✓ Valid
bunx create-faster myapp --database postgres --orm drizzleHusky requires Git:
# ❌ Invalid - Husky without git
bunx create-faster myapp --tooling husky
# ✓ Valid
bunx create-faster myapp --git --tooling huskyUnique app names (multi-app only):
# ❌ Invalid - Duplicate app names
bunx create-faster myapp --app web:nextjs --app web:expo
# ✓ Valid
bunx create-faster myapp --app web:nextjs --app mobile:expoComplete Examples
Single Next.js App with Modules
bunx create-faster my-app \
--app my-app:nextjs:shadcn,better-auth,tanstack-query \
--database postgres \
--orm drizzle \
--git \
--pm bun \
--linter biome \
--tooling huskynpx create-faster my-app \
--app my-app:nextjs:shadcn,better-auth,tanstack-query \
--database postgres \
--orm drizzle \
--git \
--pm npm \
--linter biome \
--tooling huskypnpm dlx create-faster my-app \
--app my-app:nextjs:shadcn,better-auth,tanstack-query \
--database postgres \
--orm drizzle \
--git \
--pm pnpm \
--linter biome \
--tooling huskyMulti-App SaaS with Turborepo
bunx create-faster my-saas \
--app web:nextjs:shadcn,next-themes,better-auth,tanstack-query \
--app mobile:expo:nativewind \
--app api:hono \
--database postgres \
--orm drizzle \
--git \
--pm bun \
--linter biome \
--tooling huskyThis creates:
- Next.js web app with UI, theming, authentication, and data fetching
- Expo mobile app with Tailwind-like styling
- Hono API server
- Shared database package with Drizzle ORM
- Automatic Turborepo configuration
- Git repository with pre-commit hooks
- Dependencies installed via bun
Blueprint Project
bunx create-faster my-dashboard \
--blueprint org-dashboard-nextjs \
--linter biome \
--tooling husky \
--git \
--pm bunThis creates a complete dashboard application with authentication, sidebar navigation, and charts — without specifying stacks, libraries, or database individually.
Minimal Setup
bunx create-faster my-app \
--app my-app:nextjs \
--pm bunCreates a basic Next.js app with no modules, no database, and automatic dependency installation.
Mixed Interactive Mode
Provide partial flags and let the CLI prompt for missing options:
bunx create-faster my-saas \
--app web:nextjs:shadcn \
--database postgresThis pre-fills the project with a Next.js app and PostgreSQL, then prompts for:
- ORM selection
- Deployment platform
- Linter selection
- Tooling
- Git initialization
- Package manager
--yes
Skip every prompt no flag answers: project categories stay empty, git is off and nothing is installed. The project name and the apps are still asked when no flag gives them.
Example:
bunx create-faster my-app --app my-app:nextjs --yesAuto-Generated Command
After project generation, create-faster displays a copy-paste ready command reflecting your exact configuration:
┌ Recreate this project
│
│ create-faster my-saas \
│ --app web:nextjs:shadcn,better-auth,tanstack-query \
│ --app mobile:expo:nativewind \
│ --app api:hono \
│ --database postgres \
│ --orm drizzle \
│ --git \
│ --pm bun \
│ --linter biome \
│ --tooling husky
│
└The command is exact: running it answers every prompt. It adds --yes when a category, git or the package manager was left empty.
This command is useful for:
- Sharing configurations with team members
- Documentation and onboarding
- Reproducing exact setups for testing
- Creating similar projects with variations
Getting Help
Display all available options and examples:
bunx create-faster --helpThe help output includes:
- Usage syntax
- Complete flag reference
- Practical examples for single and multi-app projects
- Available stacks, databases, and ORMs

