Menu

create-next-app

Die create-next-app CLI ermöglicht es Ihnen, eine neue Next.js-Anwendung mit der Standard-Vorlage oder einem Beispiel aus einem öffentlichen GitHub-Repository zu erstellen. Es ist der einfachste Weg, um 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 --helpAlle verfügbaren Optionen anzeigen
-v oder --versionVersionsnummer ausgeben
--no-*Standardoptionen negieren. Z.B. --no-eslint
--ts oder --typescriptAls TypeScript-Projekt initialisieren (Standard)
--js oder --javascriptAls JavaScript-Projekt initialisieren
--tailwindMit Tailwind CSS-Konfiguration initialisieren (Standard)
--eslintMit ESLint-Konfiguration initialisieren
--appAls App Router-Projekt initialisieren
--src-dirInnerhalb eines src/-Verzeichnisses initialisieren
--turbopackTurbopack standardmäßig für Entwicklung aktivieren
--import-alias <Alias-zu-konfigurieren>Import-Alias festlegen (Standard "@/*")
--emptyEin leeres Projekt initialisieren
--use-npmDer CLI explizit mitteilen, die Anwendung mit npm zu installieren
--use-pnpmDer CLI explizit mitteilen, die Anwendung mit pnpm zu installieren
--use-yarnDer CLI explizit mitteilen, die Anwendung mit Yarn zu installieren
--use-bunDer CLI explizit mitteilen, die Anwendung mit Bun zu installieren
-e oder --example [Name] [GitHub-URL]Ein Beispiel, mit dem die App initialisiert werden soll
--example-path <Pfad-zum-Beispiel>Den Pfad zum Beispiel separat angeben
--reset-preferencesDer CLI explizit mitteilen, gespeicherte Einstellungen zurückzusetzen
--skip-installDer CLI explizit mitteilen, das Installieren von Paketen zu überspringen
--yesVorherige Einstellungen oder Standardwerte für alle Optionen verwenden

Beispiele

Mit der Standard-Vorlage

Um eine neue App mit der Standard-Vorlage zu erstellen, führen Sie folgenden Befehl in Ihrem Terminal aus:

Terminal
npx create-next-app@latest

Sie werden dann zu folgenden Eingaben aufgefordert:

Terminal
What is your project named?  my-app
Would you like to use TypeScript?  No / Yes
Would you like to use ESLint?  No / Yes
Would you like to use Tailwind CSS?  No / Yes
Would you like your code inside a `src/` directory?  No / Yes
Would you like to use App Router? (recommended)  No / Yes
Would you like to use Turbopack for `next dev`?  No / Yes
Would you like to customize the import alias (`@/*` by default)?  No / Yes

Sobald Sie die Eingaben getätigt haben, 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 die --example-Option. Beispiel:

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

Eine Liste aller verfügbaren Beispiele mit Einrichtungsanweisungen 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]