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

--app <name:stack:modules>

Define an application to create. Repeatable for multi-app projects.

Format: name:stack or name:stack:module1,module2

Examples:

--app web:nextjs
--app web:nextjs:shadcn,tanstack-query
--app mobile:expo:nativewind
--app api:hono

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

Initialize a Git repository after generation.

Example:

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

--extras <items>

Add development tools as a comma-separated list.

Options: biome, husky

Example:

--extras biome,husky

Note: husky requires --git to be specified.

Dependency Rules

The CLI validates flag combinations to ensure compatibility:

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

# ✓ Valid
bunx create-faster myapp --git --extras 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 \
  --extras biome,husky

npx create-faster my-app \
  --app my-app:nextjs:shadcn,better-auth,tanstack-query \
  --database postgres \
  --orm drizzle \
  --git \
  --pm npm \
  --extras biome,husky

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

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
• Git initialization
• Extras
• 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 \
│    --extras biome,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