TechradarDev/docs/app/migration-nextjs-16.md

Migration vers Next.js 16.1.6

Résumé des changements

Migration de Next.js de la version 15.2.4 vers 16.1.6 (dernière version stable).

Modifications apportées

Dépendances mises à jour

• next : 15.2.4 → 16.1.6
• eslint-config-next : 15.2.4 → 16.1.6

Dépendances conservées (compatibles)

• react : ^19 (déjà à jour, compatible avec Next.js 16)
• react-dom : ^19 (déjà à jour, compatible avec Next.js 16)
• @types/react : ^19 (compatible)
• @types/react-dom : ^19 (compatible)
• typescript : ^5 (compatible, minimum requis 5.1.0)

Changements dans Next.js 16

Exigences système

• Node.js : Minimum 20.9.0 (déjà utilisé dans Dockerfile avec Node 20)
• TypeScript : Minimum 5.1.0 (déjà satisfait avec TypeScript 5)
• Browsers : Chrome 111+, Edge 111+, Firefox 111+, Safari 16.4+

Turbopack par défaut

• Turbopack est maintenant stable et utilisé par défaut pour next dev et next build
• Plus besoin du flag --turbopack dans les scripts
• Si vous utilisez une configuration webpack personnalisée, les builds échoueront par défaut
  • Solution : migrer vers Turbopack ou utiliser next build --webpack pour désactiver

Configuration actuelle

Le fichier radar-app/next.config.js actuel est compatible avec Next.js 16 :

const nextConfig = {
  basePath,
  output: "export",
  trailingSlash: true,
  reactStrictMode: true,
  experimental: {
    scrollRestoration: true,
  },
};

Note : L'option experimental.scrollRestoration pourrait être dépréciée dans Next.js 16, mais ne devrait pas causer d'erreur.

Tests à effectuer

1. ✅ Build Docker : Vérifier que le build fonctionne avec la nouvelle version
2. ✅ Serveur de développement : Tester npm run serve-dev
3. ✅ Build de production : Tester npm run build
4. ✅ Page d'accueil : Vérifier le rendu
5. ✅ Page team : Vérifier les visualisations
6. ✅ Navigation : Vérifier tous les liens

Migration automatique (optionnel)

Si des problèmes surviennent, vous pouvez utiliser le codemod officiel :

cd radar-app
npx @next/codemod@canary upgrade latest

Ce codemod gère automatiquement :

• Suppression de experimental_ppr Route Segment Config
• Suppression du préfixe unstable_ des APIs stabilisées
• Migration de la convention middleware dépréciée vers proxy
• Migration de next lint vers ESLint CLI
• Mise à jour de next.config.js pour la nouvelle configuration Turbopack

Notes importantes

• Le projet utilise déjà React 19, qui est compatible avec Next.js 16
• Le Dockerfile utilise Node.js 20, ce qui satisfait l'exigence minimale
• Aucun changement de code source n'est nécessaire pour cette migration
• Les dépendances optionnelles (cytoscape, echarts-for-react) restent inchangées

Date de migration

Migration effectuée le : 2026-02-25