create-next-app
L'interface en ligne de commande create-next-app vous permet de créer 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 manière 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 | Affiche toutes les options disponibles |
-v ou --version | Affiche le numéro de version |
--no-* | Annule les options par défaut. Ex. --no-eslint |
--ts ou --typescript | Initialise un projet TypeScript (par défaut) |
--js ou --javascript | Initialise un projet JavaScript |
--tailwind | Initialise avec une configuration Tailwind CSS (par défaut) |
--eslint | Initialise avec une configuration ESLint |
--app | Initialise un projet avec le routeur d'application |
--api | Initialise un projet avec uniquement des gestionnaires de route |
--src-dir | Initialise dans un répertoire src/ |
--turbopack | Active Turbopack par défaut pour le développement |
--import-alias <alias-à-configurer> | Spécifie l'alias d'import à utiliser (par défaut "@/*") |
--empty | Initialise un projet vide |
--use-npm | Demande explicitement au CLI d'utiliser npm |
--use-pnpm | Demande explicitement au CLI d'utiliser pnpm |
--use-yarn | Demande explicitement au CLI d'utiliser Yarn |
--use-bun | Demande explicitement au CLI d'utiliser Bun |
-e ou --example [nom] [url-github] | Un exemple pour initialiser l'application |
--example-path <chemin-vers-exemple> | Spécifie le chemin vers l'exemple séparément |
--reset-preferences | Réinitialise explicitement les préférences stockées |
--skip-install | Ignore explicitement l'installation des paquets |
--yes | Utilise 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 avec le modèle par défaut, exécutez la commande suivante dans votre terminal :
npx create-next-app@latestVous serez ensuite 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 avec un exemple officiel Next.js, utilisez l'option --example. Par exemple :
npx create-next-app@latest --example [nom-de-l-exemple] [nom-de-votre-projet]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 avec 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 "https://github.com/.../" [nom-de-votre-projet]