CLI
L'interface en ligne de commande (CLI) create-next-app vous permet de créer rapidement une nouvelle application Next.js en utilisant le modèle par défaut ou un exemple provenant d'un dépôt Github public. C'est la façon la plus simple de commencer avec Next.js.
Utilisation de base :
npx create-next-app@latest [nom-du-projet] [options]Référence
Les options suivantes sont disponibles :
| Options | Description |
|---|---|
-h ou --help | Afficher toutes les options disponibles |
-v ou --version | Afficher le numéro de version |
--no-* | Négation des options par défaut. Ex. --no-eslint |
--ts ou --typescript | Initialiser un projet TypeScript (par défaut) |
--js ou --javascript | Initialiser un projet JavaScript |
--tailwind | Initialiser avec la configuration Tailwind CSS (par défaut) |
--eslint | Initialiser avec la configuration ESLint |
--app | Initialiser un projet avec le routeur d'application |
--src-dir | Initialiser dans un répertoire src/ |
--turbo | Activer Turbopack par défaut pour le développement |
--import-alias <alias-à-configurer> | Spécifier l'alias d'import à utiliser (par défaut "@/*") |
--empty | Initialiser un projet vide |
--use-npm | Demander explicitement au CLI d'utiliser npm |
--use-pnpm | Demander explicitement au CLI d'utiliser pnpm |
--use-yarn | Demander explicitement au CLI d'utiliser Yarn |
--use-bun | Demander explicitement au CLI d'utiliser Bun |
-e ou --example [nom] [url-github] | Un exemple pour initialiser l'application |
--example-path <chemin-vers-exemple> | Spécifier séparément le chemin vers l'exemple |
--reset-preferences | Réinitialiser explicitement les préférences stockées |
--skip-install | Ignorer explicitement l'installation des paquets |
--yes | Utiliser les préférences précédentes ou les valeurs par défaut |
Exemples
Avec le modèle par défaut
Pour créer une nouvelle application en utilisant le modèle par défaut, exécutez la commande suivante dans votre terminal :
npx create-next-app@latestVous serez alors invité à répondre aux questions suivantes :
Quel est le nom de votre projet ? mon-app
Souhaitez-vous utiliser TypeScript ? Non / Oui
Souhaitez-vous utiliser ESLint ? Non / Oui
Souhaitez-vous utiliser Tailwind CSS ? Non / Oui
Souhaitez-vous placer votre code dans un répertoire `src/` ? Non / Oui
Souhaitez-vous utiliser le routeur d'application ? (recommandé) Non / Oui
Souhaitez-vous utiliser Turbopack pour `next dev` ? Non / Oui
Souhaitez-vous personnaliser l'alias d'import (`@/*` par défaut) ? Non / OuiUne fois les questions répondues, un nouveau projet sera créé avec votre configuration choisie.
Avec un exemple officiel Next.js
Pour créer une nouvelle application en utilisant un exemple officiel Next.js, utilisez l'option --example avec la commande suivante :
npx create-next-app@latest --example [nom-de-votre-projet] [nom-de-l-exemple]Vous pouvez consulter la liste de tous les exemples disponibles ainsi que les instructions d'installation dans le dépôt Next.js.
Avec n'importe quel exemple Github public
Pour créer une nouvelle application en utilisant n'importe quel exemple Github public, utilisez l'option --example avec l'URL du dépôt Github. Par exemple :
npx create-next-app@latest --example [nom-de-votre-projet] "https://github.com/.../"