Que fait Next.js 16 Launchpad ?
Next.js 16 : Turbopack par défaut (builds 2 à 5 fois plus rapides), composants cache ('use cache'), et proxy.ts pour un contrôle explicite.
Quand l'utiliser
✅ Next.js 16, Turbopack, composants cache, migration proxy, App Router, React 19.2
❌ Pages Router, Next.js ≤15, questions React génériques
Prérequis
| Outil | Version |
|---|---|
| Node.js | 20.9.0+ |
| TypeScript | 5.1.0+ |
| React | 19.2+ |
Démarrage rapide
# Nouveau projet
npx create-next-app@latest mon-app
# Mise à jour d'un projet existant
npx @next/codemod@canary upgrade latest
npm install next@latest react@latest react-dom@latest
Recommandé : TypeScript, ESLint, Tailwind, App Router, Turbopack, alias @/*.
Configuration minimale
// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="fr">
<body>{children}</body>
</html>
)
}
// app/page.tsx
export default function Page() {
return <h1>Bonjour, Next.js 16 !</h1>
}
Configuration
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
reactCompiler: true,
}
export default nextConfig
Changements de la v15 à la v16
| v15 | v16 |
|---|---|
experimental.turbopack | Par défaut |
experimental.ppr | cacheComponents |
middleware.ts (Edge) | proxy.ts (Node) |
params synchrone | await params |
Schémas fondamentaux
1. Composants serveur (par défaut)
export default async function BlogPage() {
const res = await fetch('https://api.example.com/posts')
const posts = await res.json()
return <PostList posts={posts} />
}
2. Composants cache
import { cacheLife } from 'next/cache'
export default async function BlogPage() {
'use cache'
cacheLife('hours')
const posts = await fetch('https://api.example.com/posts').then(r => r.json())
return <PostList posts={posts} />
}
3. Composants client
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Compteur : {count}</p>
<button onClick={() => setCount(count + 1)}>+</button>
</div>
)
}
4. Limite de proxy
// app/proxy.ts
export function proxy(request: NextRequest) {
if (!request.cookies.get('auth') && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}
5. Tags de cache + actions serveur
// app/blog/page.tsx
'use cache'
cacheLife('hours')
cacheTag('articles-du-blog')
export default async function BlogList() {
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
// app/actions.ts
'use server'
import { updateTag } from 'next/cache'
export async function createPost(data: PostData) {
await db.posts.create(data)
updateTag('articles-du-blog')
}
6. Diffusion en continu avec Suspense
export default function Dashboard() {
return (
<div>
<Suspense fallback={<Squelette />}>
<CarteRevenus />
</Suspense>
<Suspense fallback={<Squelette />}>
<CarteUtilisateurs />
</Suspense>
</div>
)
}
async function CarteRevenus() {
const data = await db.analytics.revenue()
return <div>{data}</div>
}
Concepts clés
- Turbopack - Bundler en Rust, compilation incrémentielle, Fast Refresh
- Composants serveur - Par défaut dans
app/, zéro JS client - Composants client -
'use client', hooks, API navigateur - Composants cache -
'use cache'+cacheLife()pour le PPR - Limite de proxy -
proxy.tspour l'authentification, les réécritures et les redirections - Pré-rendu partiel - Coque statique + diffusion dynamique
Checklist de migration
-
API de requêtes asynchrones
npx @next/codemod@canary async-request-apiMettez à jour :
const { slug } = await params -
middleware.ts → proxy.ts
- Renommez le fichier, exportez
proxy - Runtime Node uniquement (pas Edge)
- Renommez le fichier, exportez
-
Mises à jour de configuration
- Supprimez les indicateurs
experimental.* - Activez
cacheComponents,reactCompiler - Supprimez
serverRuntimeConfig/publicRuntimeConfig
- Supprimez les indicateurs
-
Composants cache
- Remplacez
experimental.pprparcacheComponents: true - Enveloppez les sections dynamiques avec
<Suspense>
- Remplacez
-
Images
- Configurez
images.localPatternspour les chaînes de requête
- Configurez
Consultez references/nextjs16-migration-playbook.md pour le guide complet.
Pièges courants
❌ Mélanger 'use cache' avec des API d'exécution (cookies(), headers())
❌ Oublier <Suspense> lorsque les composants cache sont activés
❌ Imports Sass avec tilde sous Turbopack
❌ Exécuter proxy.ts sur le runtime Edge
✅ Lisez d'abord les cookies/en-têtes, transmettez-les comme props aux composants mis en cache
✅ Enveloppez les enfants dynamiques avec <Suspense>
✅ Utilisez des imports Sass standard
✅ Utilisez le runtime Node pour le proxy
Guide de décision
Activer les composants cache ? → Oui pour le contenu statique/semi-statique → Non pour les tableaux de bord entièrement dynamiques
Où va l'authentification ?
→ proxy.ts pour les vérifications inter-itinéraires
→ Gestionnaires d'itinéraires pour la logique spécifique à l'API
Quand utiliser 'use client' ?
→ Uniquement lorsque vous avez besoin de hooks, d'état ou d'API navigateur
→ Gardez les composants de présentation côté serveur
Schémas de production
E-commerce
// Page produit avec diffusion en continu
export default async function Product({ params }) {
const { id } = await params
const product = await db.products.findById(id)
return (
<>
<ProductInfo product={product} />
<Suspense fallback={<SqueletteAvis />}>
<Avis productId={id} />
</Suspense>
</>
)
}
Tableau de bord authentifié
// proxy.ts
export function proxy(request: NextRequest) {
const session = request.cookies.get('session')
if (!session && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/connexion', request.url))
}
}
Consultez references/nextjs16-advanced-patterns.md pour plus de plans.
Performances
- Gardez Turbopack activé (désactivez avec
--webpackuniquement si nécessaire) - Parallélisez les fetchs avec
Promise.all - Utilisez
<Suspense>pour les limites de diffusion - Activez le cache du système de fichiers pour les grands dépôts
Sécurité
- Utilisez le package
server-only+ l'API React Taint - Conservez l'authentification dans
proxy.ts - Validez les entrées dans les actions serveur
- Filtrez les variables d'environnement avec le préfixe
NEXT_PUBLIC_ - Extrayez les cookies/en-têtes avant les portées mises en cache
Déploiement
- Vercel : configuration zéro
- Docker/Node :
output: 'standalone' - Surveillez les temps de build (accélération 2-5× attendue)
- Configurez les cycles de vie du cache pour correspondre au CDN
Fichiers de référence
- references/nextjs16-reference.md - Installation/configuration/listes de contrôle
- references/nextjs16-migration-playbook.md - Guide de migration avec codemods
- references/nextjs16-advanced-patterns.md - Schémas de diffusion, mise en cache, authentification
- references/NEXTJS_16_COMPLETE_GUIDE.md - Documentation complète
- scripts/bootstrap-nextjs16.ps1 - Script de configuration automatisé
- assets/app-router-starter/ - Implémentation de référence
Ressources
- Docs : https://nextjs.org/docs
- GitHub : https://github.com/vercel/next.js
Version : 1.1.0 | Mise à jour : 2025-12-27