create-next-app CLI

Die create-next-app CLI ermöglicht es Ihnen, eine neue Next.js-Anwendung mit der Standardvorlage oder einem Beispiel aus einem öffentlichen GitHub-Repository zu erstellen. Es ist der einfachste Weg, mit Next.js zu beginnen.

Grundlegende Verwendung:

Terminal
npx create-next-app@latest [Projektname] [Optionen]

Referenz

Die folgenden Optionen sind verfügbar:

OptionenBeschreibung
-h oder --helpZeigt alle verfügbaren Optionen an
-v oder --versionGibt die Versionsnummer aus
--no-*Negiert Standardoptionen, z.B. --no-eslint
--ts oder --typescriptInitialisiert als TypeScript-Projekt (Standard)
--js oder --javascriptInitialisiert als JavaScript-Projekt
--tailwindInitialisiert mit Tailwind CSS-Konfiguration (Standard)
--eslintInitialisiert mit ESLint-Konfiguration
--appInitialisiert als App-Router-Projekt
--apiInitialisiert ein Projekt nur mit Route Handlers
--src-dirInitialisiert innerhalb eines src/-Verzeichnisses
--turbopackAktiviert Turbopack standardmäßig für die Entwicklung
--import-alias <zu-konfigurierender-alias>Gibt den zu verwendenden Import-Alias an (Standard "@/*")
--emptyInitialisiert ein leeres Projekt
--use-npmWeist die CLI explizit an, die Anwendung mit npm zu booten
--use-pnpmWeist die CLI explizit an, die Anwendung mit pnpm zu booten
--use-yarnWeist die CLI explizit an, die Anwendung mit Yarn zu booten
--use-bunWeist die CLI explizit an, die Anwendung mit Bun zu booten
-e oder --example [Name] [GitHub-URL]Ein Beispiel, mit dem die App gebootet werden soll
--example-path <Pfad-zum-Beispiel>Gibt den Pfad zum Beispiel separat an
--reset-preferencesSetzt gespeicherte Präferenzen zurück
--skip-installÜberspringt die Paketinstallation
--yesVerwendet vorherige Präferenzen oder Standardwerte

Beispiele

Mit der Standardvorlage

Um eine neue App mit der Standardvorlage zu erstellen, führen Sie folgenden Befehl im Terminal aus:

Terminal
npx create-next-app@latest

Sie werden dann nach folgenden Eingaben gefragt:

Terminal
Wie soll Ihr Projekt heißen?  meine-app
Möchten Sie TypeScript verwenden?  Nein / Ja
Möchten Sie ESLint verwenden?  Nein / Ja
Möchten Sie Tailwind CSS verwenden?  Nein / Ja
Möchten Sie Ihren Code in einem `src/`-Verzeichnis haben?  Nein / Ja
Möchten Sie den App Router verwenden? (empfohlen)  Nein / Ja
Möchten Sie Turbopack für `next dev` verwenden?  Nein / Ja
Möchten Sie den Import-Alias anpassen (`@/*` standardmäßig)?  Nein / Ja

Nach Beantwortung der Fragen wird ein neues Projekt mit Ihrer gewählten Konfiguration erstellt.

Mit einem offiziellen Next.js-Beispiel

Um eine neue App mit einem offiziellen Next.js-Beispiel zu erstellen, verwenden Sie das --example-Flag. Beispiel:

Terminal
npx create-next-app@latest --example [Beispielname] [Ihr-Projektname]

Eine Liste aller verfügbaren Beispiele sowie Setup-Anleitungen finden Sie im Next.js-Repository.

Mit einem beliebigen öffentlichen GitHub-Beispiel

Um eine neue App mit einem beliebigen öffentlichen GitHub-Beispiel zu erstellen, verwenden Sie die --example-Option mit der GitHub-Repo-URL. Beispiel:

Terminal
npx create-next-app@latest --example "https://github.com/.../" [Ihr-Projektname]

On this page