Flags reference

Overview

This page provides a comprehensive reference of all available flags for create-nextjs-dapp, including their syntax, types, defaults, and usage.

Configuration Flags

--chain

string

default:"evm (with --yes)"

Specify which blockchain to build on.Accepted values: evm, solanaShort flag: -cSyntax:

--chain evm
--chain solana
-c evm
--chain=solana

Interactive default: Prompts user to selectNon-interactive default (—yes): evmValidation: Must be one of the valid chain values. Invalid chains exit with error.Source: src/cli/args.ts:49-69

--wallet

string

default:"First available for chain"

Specify which wallet provider to integrate.EVM providers: rainbowkit, connectkit, privy, dynamic, reown, thirdweb, getparaSolana providers: wallet-adapter, privy, dynamic, reown, thirdwebShort flag: -wSyntax:

--wallet rainbowkit
--wallet dynamic
-w privy
--wallet=connectkit

Interactive default: Prompts user to select from chain-compatible providersNon-interactive default (—yes): First provider for selected chain:

EVM: rainbowkit
Solana: wallet-adapter

Validation:

Must be a valid wallet provider
Must support the selected chain
Incompatible combinations exit with error in --yes mode
In interactive mode, prompts for compatible provider

Examples:

# Valid - RainbowKit supports EVM
npx create-nextjs-dapp my-dapp --chain evm --wallet rainbowkit

# Invalid - RainbowKit doesn't support Solana
npx create-nextjs-dapp my-dapp --chain solana --wallet rainbowkit
# Error: RainbowKit doesn't support Solana

Source: src/cli/args.ts:28-48, src/cli/prompts.ts:96-111

Automation Flags

--yes

boolean

default:"false"

Skip all interactive prompts and use default values.Short flag: -ySyntax:

--yes
-y

Behavior:

Uses default values for all missing options
Exits with error on conflicts instead of prompting
Exits with error on incompatible wallet/chain combinations

Default values when using —yes:

Project name: my-dapp
Chain: evm
Wallet: rainbowkit (EVM) or wallet-adapter (Solana)
Git: Not initialized
Install: Not installed

Use case: CI/CD pipelines, automated testing, quick prototypingExamples:

# Use all defaults
npx create-nextjs-dapp my-dapp --yes

# Override chain default
npx create-nextjs-dapp my-dapp --yes --chain solana

# Fully automated setup
npx create-nextjs-dapp prod-dapp --yes --git --install

Source: src/cli/args.ts:70-71, src/cli/prompts.ts:30

--git

boolean

default:"false"

Initialize a Git repository in the project directory.Syntax:

--git

Behavior:

Runs git init in project directory
Creates initial commit with scaffolded files
Includes Next.js .gitignore configuration

Requirements: Git must be installed and available in PATHExamples:

npx create-nextjs-dapp my-dapp --git
npx create-nextjs-dapp my-dapp --git --install

Source: src/cli/args.ts:72-73

--install

boolean

default:"false"

Automatically install dependencies after project creation.Syntax:

--install

Behavior:

Installs dependencies using detected or specified package manager
Shows installation progress
Validates successful installation

Package manager selection:

Uses --use-* flag if specified
Otherwise, detects from lock files
Falls back to npm if no lock files found

Examples:

# Use detected package manager
npx create-nextjs-dapp my-dapp --install

# Specify package manager
npx create-nextjs-dapp my-dapp --install --use-pnpm

# With other automation flags
npx create-nextjs-dapp my-dapp --install --git --yes

Source: src/cli/args.ts:74-75

Package Manager Flags

--use-npm

boolean

default:"Auto-detected"

Use npm as the package manager.Syntax:

--use-npm

Behavior:

Sets package manager to npm
Updates package.json scripts accordingly
Used by --install flag if specified

Mutual exclusivity: Only one --use-* flag should be provided. Last flag wins.Examples:

npx create-nextjs-dapp my-dapp --use-npm
npx create-nextjs-dapp my-dapp --use-npm --install

Source: src/cli/args.ts:76-77

--use-yarn

boolean

default:"Auto-detected"

Use Yarn as the package manager.Syntax:

--use-yarn

Behavior:

Sets package manager to Yarn
Updates package.json scripts accordingly
Used by --install flag if specified

Requirements: Yarn must be installed globally or available in PATHExamples:

npx create-nextjs-dapp my-dapp --use-yarn
npx create-nextjs-dapp my-dapp --use-yarn --install

Source: src/cli/args.ts:78-79

--use-pnpm

boolean

default:"Auto-detected"

Use pnpm as the package manager.Syntax:

--use-pnpm

Behavior:

Sets package manager to pnpm
Updates package.json scripts accordingly
Used by --install flag if specified

Requirements: pnpm must be installed globally or available in PATHExamples:

npx create-nextjs-dapp my-dapp --use-pnpm
npx create-nextjs-dapp my-dapp --use-pnpm --install

Source: src/cli/args.ts:80-81

--use-bun

boolean

default:"Auto-detected"

Use Bun as the package manager and runtime.Syntax:

--use-bun

Behavior:

Sets package manager to Bun
Updates package.json scripts accordingly
Used by --install flag if specified

Requirements: Bun must be installed and available in PATHExamples:

npx create-nextjs-dapp my-dapp --use-bun
npx create-nextjs-dapp my-dapp --use-bun --install

Source: src/cli/args.ts:82-83

Utility Flags

--help

boolean

Display help information and exit.Short flag: -hSyntax:

--help
-h

Output includes:

Command syntax
All available options with descriptions
Complete wallet provider list organized by chain
Usage examples for common scenarios
Links to documentation

Exit code: 0Example output:

create-nextjs-dapp v0.1.0

Create a Next.js dApp with your preferred wallet provider.

Usage:
  npx create-nextjs-dapp [project-name] [options]

Options:
  -c, --chain <chain>     Blockchain to use (evm, solana)
  ...

Source: src/cli/args.ts:18-21, src/cli/output.ts:30-91

--version

boolean

Display version number and exit.Short flag: -vSyntax:

--version
-v

Output format: create-nextjs-dapp v0.1.0Exit code: 0Version source: Read from package.json at runtimeExample:

$ npx create-nextjs-dapp --version
create-nextjs-dapp v0.1.0

Source: src/cli/args.ts:23-26, src/cli/output.ts:96-98

Flag Combinations

Common Patterns

Quick Start with Defaults

npx create-nextjs-dapp my-dapp --yes

Equivalent to:

npx create-nextjs-dapp my-dapp --chain evm --wallet rainbowkit

Production Setup

npx create-nextjs-dapp production-dapp \
  --chain evm \
  --wallet rainbowkit \
  --git \
  --install \
  --use-pnpm

Solana Development

npx create-nextjs-dapp solana-app \
  --chain solana \
  --wallet dynamic \
  --git \
  --install

Testing Different Providers

# Test with RainbowKit
npx create-nextjs-dapp test-rainbowkit \
  --wallet rainbowkit \
  --yes

# Test with Privy
npx create-nextjs-dapp test-privy \
  --wallet privy \
  --yes

CI/CD Pipeline

npx create-nextjs-dapp $PROJECT_NAME \
  --yes \
  --chain "$CHAIN" \
  --wallet "$WALLET" \
  --git \
  --use-pnpm

Flag Validation

Validation Rules

Unknown flags - Exit with error (src/cli/args.ts:84-85)

npx create-nextjs-dapp my-dapp --unknown
# Error: Unknown option "--unknown".

Missing values - Exit with error (src/cli/args.ts:30-31, 51-52)

npx create-nextjs-dapp my-dapp --chain
# Error: Missing value for --chain. Expected one of: evm, solana

Invalid values - Exit with error with suggestions (src/cli/args.ts:34-37, 54-58)

npx create-nextjs-dapp my-dapp --chain bitcoin
# Error: Invalid chain "bitcoin".
#   Valid options: evm, solana

Case insensitive - Values are normalized to lowercase (src/cli/args.ts:29, 50)

# These are equivalent:
npx create-nextjs-dapp my-dapp --chain EVM
npx create-nextjs-dapp my-dapp --chain evm

Wallet/chain compatibility - Validated before project generation (src/cli/prompts.ts:96-111)

npx create-nextjs-dapp my-dapp --chain solana --wallet getpara
# Error: GetPara (Capsule) doesn't support Solana.
#   Available providers for Solana: wallet-adapter, privy, dynamic, reown, thirdweb

Quick Reference Table

Flag	Short	Type	Default	Description
`--chain`	`-c`	string	`evm`	Blockchain selection
`--wallet`	`-w`	string	First available	Wallet provider
`--yes`	`-y`	boolean	`false`	Skip prompts
`--git`	-	boolean	`false`	Initialize Git
`--install`	-	boolean	`false`	Install dependencies
`--use-npm`	-	boolean	Auto-detect	Use npm
`--use-yarn`	-	boolean	Auto-detect	Use Yarn
`--use-pnpm`	-	boolean	Auto-detect	Use pnpm
`--use-bun`	-	boolean	Auto-detect	Use Bun
`--help`	`-h`	boolean	-	Show help
`--version`	`-v`	boolean	-	Show version

create command

Main command documentation and usage

Command Options

Detailed option documentation with examples

CLI Commands

Overview

Configuration Flags

Automation Flags

Package Manager Flags

Utility Flags

Flag Combinations

Common Patterns

Quick Start with Defaults

Production Setup

Solana Development

Testing Different Providers

CI/CD Pipeline

Flag Validation

Validation Rules

Quick Reference Table

create command

Command Options

Build docs developers (and LLMs) love

CLI Commands

​Overview

​Configuration Flags

​Automation Flags

​Package Manager Flags

​Utility Flags

​Flag Combinations

​Common Patterns

​Quick Start with Defaults

​Production Setup

​Solana Development

​Testing Different Providers

​CI/CD Pipeline

​Flag Validation

​Validation Rules

​Quick Reference Table

​Related

create command

Command Options

Build docs developers (and LLMs) love

Overview

Configuration Flags

Automation Flags

Package Manager Flags

Utility Flags

Flag Combinations

Common Patterns

Quick Start with Defaults

Production Setup

Solana Development

Testing Different Providers

CI/CD Pipeline

Flag Validation

Validation Rules

Quick Reference Table

Related