Outillage Next.js
Priorité : P2 (MOYENNE)
Structure
project/
├── .next/ # Artefacts de build
├── next.config.js # Configuration avancée
└── .eslintrc.json # Plugins Next
Directives d'implémentation
- Architecture de build : Utiliser
Turbopack (moderne) ou Webpack (legacy). Activer --turbo pour un développement incrémental plus rapide.
- Minification : S'assurer que
output: 'standalone' est défini dans next.config.js pour des déploiements Docker optimisés. Utiliser les équivalents ProGuard / Uglify pour la réduction des assets.
- Linting : Rendre obligatoire
next lint (plugin ESLint Next.js) et tsc (vérification de types) dans les pipelines CI/CD.
- Optimisation des assets : Inspecter la taille avec
@next/bundle-analyzer. Optimiser les images via next/image et supprimer les dépendances inutilisées.
- Télémétrie : Désactiver via
next telemetry disable si la confidentialité est requise.
- Environnement : Utiliser la gestion
.env dans Next.js (serveur uniquement vs NEXT_PUBLIC_*). Valider les schémas avec Zod à l'exécution.
- CI/CD : Mettre en cache le dossier
.next/cache en CI pour des temps de build 50% plus rapides.
Anti-patrons
- Ne pas utiliser
npm run start pour le développement : Utiliser next dev (ou next dev --turbo).
- Ne pas laisser croître le bundle sans inspection : Analyser avec
@next/bundle-analyzer avant la mise en production.
- Ne pas utiliser de règles ESLint personnalisées à la place du plugin : Utiliser
eslint-plugin-next pour un linting adapté à Next.js.
- Ne pas utiliser
console.log en production : Utiliser des enregistreurs structurés (Pino, Winston).
Références