acb475d5d0
- Mise à jour de Next.js vers 16.1.6 (dernière version stable) - Mise à jour de eslint-config-next vers 16.1.6 - Ajout documentation migration-nextjs-16.md Co-authored-by: Cursor <cursoragent@cursor.com>
90 lines
2.9 KiB
Markdown
90 lines
2.9 KiB
Markdown
# 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 :
|
|
|
|
```javascript
|
|
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 :
|
|
|
|
```bash
|
|
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
|