Modèle .gitignore Next.js expliqué

Nextjs.gitignore est presque identique au .gitignore créé par create-next-app. La plupart des règles commencent par / et sont ancrées à la racine du dépôt : dans un monorepo où l'application se trouve dans un sous-dossier, adaptez les chemins ou utilisez aussi le modèle Node.

Next.js lit plusieurs fichiers d'environnement, comme .env, .env.local ou .env.development.local. Ce modèle exclut à la fois .env et .env*.local.

Explication règle par règle

Motif	Ce qui est ignoré et pourquoi
/.next//out//build	Build Next.jsRésultats et cache de next build (.next) et résultats de l'export statique (out). Ils sont recréés lors du déploiement.
/node_modules/.pnp.pnp.js	DépendancesRésultats de l'installation des paquets et fichiers Yarn Plug'n'Play. Comme les règles sont ancrées à la racine, elles ne bloquent pas les node_modules des sous-paquets.
.env.env*.local	Variables d'environnementFichiers d'environnement contenant des valeurs secrètes. Les variables qui commencent par NEXT_PUBLIC_ sont intégrées au build et exposées au navigateur : utilisez les secrets sans ce préfixe, côté serveur uniquement.
.vercelnext-env.d.ts*.tsbuildinfo	Fichiers de déploiement et de types générésInformations de liaison au projet créées par vercel link, fichier de déclarations de types que Next.js régénère en développement et au build, et informations de build incrémental de TypeScript.
*.pem	CertificatsFichiers de certificats et de clés privées (.pem) utilisés pour le développement HTTPS local ou l'intégration de services externes. On ne commite pas de clé privée.
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store	Logs et diversLogs du gestionnaire de paquets, couverture de tests et fichiers du Finder de macOS.

Points d'attention en pratique

• Dans un monorepo (apps/web), les règles ancrées à la racine comme /node_modules ne s'appliquent pas à l'application en sous-dossier. En sélectionnant aussi le modèle Node, les node_modules/ de toute profondeur sont capturés.
• Commitez les fichiers de configuration et le lockfile, comme next.config.js et package-lock.json.
• Au lieu de commiter .env, partagez les noms des variables nécessaires dans le README ou dans .env.example.

Modèle d'origine

# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.# dependencies/node_modules/.pnp.pnp.js# testing/coverage# next.js/.next//out/# production/build# misc.DS_Store*.pem# debugnpm-debug.log*yarn-debug.log*yarn-error.log*# local env files.env*.local.env# vercel.vercel# typescript*.tsbuildinfonext-env.d.ts

Modèles utilisés ensemble

Autres modèles expliqués