CLI Options

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 let the CLI prompt for the rest.

Available Flags

Project Name (Positional)

bunx create-faster <project-name>

The first argument specifies the project name. If omitted, the CLI prompts for it.

Example:

bunx create-faster my-saas

--blueprint <name>

Use a pre-composed starter project. Mutually exclusive with --app, --database, and --orm.

Options: dashboard, dapp-privy, dapp-rainbowkit, lambda-sst, lambda-terraform-aws

Example:

bunx create-faster my-dashboard \
  --blueprint dashboard \
  --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

Example:

--database postgres

--orm <provider>

Select an ORM. Requires --database to be specified.

Options: prisma, drizzle

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.

Example:

--no-install

--linter <name>

Select a linter/formatter.

Options: biome, eslint-prettier, eslint, prettier

Example:

--linter biome

--deployment <name>

Select a deployment platform.

Options: sst, terraform-aws

Example:

--deployment sst

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

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 dashboard --app web:nextjs

# ✓ Valid - Blueprint with linter, tooling, git, pm
bunx create-faster myapp --blueprint dashboard --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 dashboard \
  --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

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
│
└

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