Create FasterCreate Faster

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-saas

The 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 bun

Blueprints 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:shadcn

Use 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 bun

If 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-context

See 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 cloudflare

See 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 husky

Note: 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 --version

Dependency 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 bun

ORM requires Database:

# ❌ Invalid - ORM without database
bunx create-faster myapp --orm drizzle

# ✓ Valid
bunx create-faster myapp --database postgres --orm drizzle

Husky requires Git:

# ❌ Invalid - Husky without git
bunx create-faster myapp --tooling husky

# ✓ Valid
bunx create-faster myapp --git --tooling husky

Unique 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:expo

Complete 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 husky
npx create-faster my-app \
  --app my-app:nextjs:shadcn,better-auth,tanstack-query \
  --database postgres \
  --orm drizzle \
  --git \
  --pm npm \
  --linter biome \
  --tooling husky
pnpm dlx create-faster my-app \
  --app my-app:nextjs:shadcn,better-auth,tanstack-query \
  --database postgres \
  --orm drizzle \
  --git \
  --pm pnpm \
  --linter biome \
  --tooling husky

Multi-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 husky

This 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 bun

This 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 bun

Creates 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 postgres

This 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 --yes

Auto-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 --help

The help output includes:

  • Usage syntax
  • Complete flag reference
  • Practical examples for single and multi-app projects
  • Available stacks, databases, and ORMs

On this page