Les projets React (qu'ils soient Create React App, Next.js, Vite ou Remix) sont construits sur Node.js et partagent les mêmes besoins gitignore — plus les répertoires de build spécifiques aux frameworks comme .next, dist ou build.
Ce modèle combine le gitignore Node.js avec les règles Next.js et les patterns courants IDE/OS. Il couvre npm, yarn et pnpm, les artefacts de build, les fichiers d'environnement et tout ce dont vous avez besoin pour un dépôt React propre.
Comment utiliser
1. Examinez les modèles présélectionnés (Node.js + Next.js + VS Code + OS)
2. Supprimez Next.js si vous ne l'utilisez pas, ou ajoutez d'autres modèles
3. Cliquez sur « Copier » ou « Télécharger »
4. Placez-le à la racine de votre projet
Questions frequentes
Dois-je ignorer le dossier build ou dist ?
Oui. Les fichiers de build (build/, dist/, .next/, out/) sont générés à partir du code source et ne devraient pas être en contrôle de version. Ils peuvent être reconstruits à partir des sources à tout moment.
Ai-je besoin d'un .gitignore différent pour CRA, Next.js ou Vite ?
La base Node.js est la même. La différence est le nom du répertoire de build : CRA utilise build/, Next.js utilise .next/ et out/, Vite utilise dist/. Ce modèle couvre tous ces cas.
Dois-je committer .env.local ?
Non. Les fichiers comme .env.local contiennent des secrets spécifiques à votre machine. Commitez plutôt un fichier .env.example qui liste les variables requises sans les vraies valeurs.
Que contient le dossier .next et pourquoi l'ignorer ?
Le dossier .next contient les fichiers de build Next.js : pages compilées, cache webpack et fichiers statiques générés. Il est recréé à chaque build et ne doit pas être versionné car il est spécifique à l'environnement.
Dois-je ignorer node_modules dans un projet React ?
Absolument. Le dossier node_modules peut contenir des dizaines de milliers de fichiers et plusieurs centaines de mégaoctets. Utilisez npm install ou yarn pour le recréer à partir de package.json et du fichier lock.
Comment gérer les fichiers de configuration de l'éditeur ?
Les fichiers .vscode/ peuvent être partagés (configuration du projet) ou ignorés (préférences personnelles). Ce modèle inclut VS Code par défaut. Pour les fichiers personnels comme settings.json locaux, créez un .gitignore personnel.
Le fichier yarn.lock doit-il être ignoré ?
Non, au contraire ! Les fichiers lock (yarn.lock, package-lock.json, pnpm-lock.yaml) doivent être committés. Ils garantissent que tous les membres de l'équipe utilisent exactement les mêmes versions de dépendances.