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 :

Terminal
npx create-next-app@latest [nom-du-projet] [options]

Référence

Les options suivantes sont disponibles :

OptionsDescription
-h ou --helpAffiche toutes les options disponibles
-v ou --versionAffiche le numéro de version
--no-*Annule les options par défaut. Ex. --no-eslint
--ts ou --typescriptInitialise un projet TypeScript (par défaut)
--js ou --javascriptInitialise un projet JavaScript
--tailwindInitialise avec une configuration Tailwind CSS (par défaut)
--eslintInitialise avec une configuration ESLint
--appInitialise un projet avec le routeur d'application
--apiInitialise un projet avec uniquement des gestionnaires de route
--src-dirInitialise dans un répertoire src/
--turbopackActive Turbopack par défaut pour le développement
--import-alias <alias-à-configurer>Spécifie l'alias d'import à utiliser (par défaut "@/*")
--emptyInitialise un projet vide
--use-npmDemande explicitement au CLI d'utiliser npm
--use-pnpmDemande explicitement au CLI d'utiliser pnpm
--use-yarnDemande explicitement au CLI d'utiliser Yarn
--use-bunDemande 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-preferencesRéinitialise explicitement les préférences stockées
--skip-installIgnore explicitement l'installation des paquets
--yesUtilise 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 :

Terminal
npx create-next-app@latest

Vous serez ensuite invité à répondre aux questions suivantes :

Terminal
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 / Oui

Une 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 :

Terminal
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 :

Terminal
npx create-next-app@latest --example "https://github.com/.../" [nom-de-votre-projet]

On this page