create-next-app CLI

Core Idea

The easiest way to scaffold a new Next.js application, using the default template or any public GitHub example repo.

Key Concepts

• Basic usage: npx create-next-app@latest [project-name] [options] (or pnpm create next-app, yarn create next-app, bun create next-app).
• --yes: use previous preferences or defaults for all options (non-interactive).
• --example [name] [github-url]: bootstrap from an official example or any public GitHub URL.
• --agents-md: includes AGENTS.md and CLAUDE.md to guide coding agents (default).
• Linter choice: ESLint (traditional, @next/eslint-plugin-next), Biome (fast, combines lint+format), or None.

Code Examples

npx create-next-app@latest

• O que demonstra: comando básico interativo.

npx create-next-app@latest --example [example-name] [your-project-name]

• O que demonstra: bootstrap a partir de um exemplo oficial do repositório Next.js.

Reference Tables

Options	Description
-h or --help	Show all available options
-v or --version	Output the version number
--no-*	Negate default options (e.g. --no-ts)
--ts or --typescript	Initialize as TypeScript project (default)
--js or --javascript	Initialize as JavaScript project
--tailwind	Initialize with Tailwind CSS config (default)
--react-compiler	Initialize with React Compiler enabled
--eslint	Initialize with ESLint config
--biome	Initialize with Biome config
--no-linter	Skip linter configuration
--app	Initialize as App Router project
--api	Initialize a project with only route handlers
--src-dir	Initialize inside a src/ directory
--turbopack	Force enable Turbopack (default)
--webpack	Force enable Webpack
--import-alias <alias>	Specify import alias (default @/*)
--empty	Initialize an empty project
--use-npm/--use-pnpm/--use-yarn/--use-bun	Force package manager
-e or --example [name] [github-url]	Example to bootstrap with
--example-path <path>	Path to the example within the repo
--reset-preferences	Reset any stored preferences
--skip-install	Skip installing packages
--disable-git	Disable git initialization
--agents-md	Include AGENTS.md and CLAUDE.md (default)
--yes	Use previous preferences/defaults for all options

Key Takeaways

1. Prompts padrão recomendam TypeScript, ESLint, Tailwind CSS, App Router e AGENTS.md.
2. Biome é alternativa moderna ao ESLint que combina lint+format numa ferramenta só.
3. --example aceita tanto nome oficial quanto qualquer URL pública de repo GitHub.

Connects To

• next CLI (ch432): próximo passo depois de criar o projeto.