create-next-app
Die create-next-app-CLI ermöglicht es Ihnen, schnell 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:
npx create-next-app@latest [Projektname] [Optionen]Referenz
Die folgenden Optionen sind verfügbar:
| Optionen | Beschreibung |
|---|---|
-h oder --help | Zeigt alle verfügbaren Optionen an |
-v oder --version | Gibt die Versionsnummer aus |
--no-* | Negiert Standardoptionen, z.B. --no-eslint |
--ts oder --typescript | Initialisiert als TypeScript-Projekt (Standard) |
--js oder --javascript | Initialisiert als JavaScript-Projekt |
--tailwind | Initialisiert mit Tailwind CSS-Konfiguration (Standard) |
--eslint | Initialisiert mit ESLint-Konfiguration |
--app | Initialisiert als App-Router-Projekt |
--src-dir | Initialisiert in einem src/-Verzeichnis |
--turbo | Aktiviert Turbopack standardmäßig für die Entwicklung |
--import-alias <alias-to-configure> | Gibt den zu verwendenden Import-Alias an (Standard "@/*") |
--empty | Initialisiert ein leeres Projekt |
--use-npm | Weist die CLI explizit an, die Anwendung mit npm zu bootstrappen |
--use-pnpm | Weist die CLI explizit an, die Anwendung mit pnpm zu bootstrappen |
--use-yarn | Weist die CLI explizit an, die Anwendung mit Yarn zu bootstrappen |
--use-bun | Weist die CLI explizit an, die Anwendung mit Bun zu bootstrappen |
-e oder --example [name] [github-url] | Ein Beispiel, mit dem die App gebootstrappt werden soll |
--example-path <pfad-zum-beispiel> | Gibt den Pfad zum Beispiel separat an |
--reset-preferences | Weist die CLI explizit an, alle gespeicherten Präferenzen zurückzusetzen |
--skip-install | Weist die CLI explizit an, die Paketinstallation zu überspringen |
--yes | Verwendet vorherige Präferenzen oder Standardwerte für alle Optionen |
Beispiele
Mit der Standardvorlage
Um eine neue App mit der Standardvorlage zu erstellen, führen Sie folgenden Befehl in Ihrem Terminal aus:
npx create-next-app@latestSie werden dann nach folgenden Eingaben gefragt:
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 / JaNachdem Sie die Eingaben beantwortet 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 mit folgendem Befehl:
npx create-next-app@latest --example [Ihr-Projektname] [Beispielname]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 URL des GitHub-Repos. Zum Beispiel:
npx create-next-app@latest --example [Ihr-Projektname] "https://github.com/.../"