Applications Next.js 16
Construisez correctement des applications Next.js 16 avec un design distinctif.
Changements Cassants Critiques (Next.js 16)
1. params et searchParams sont Maintenant des Promesses
C'EST L'ERREUR LA PLUS COURANTE.
// FAUX - Motif Next.js 15 (ÉCHOUERA)
export default function Page({ params }: { params: { id: string } }) {
return <div>ID: {params.id}</div>
}
// CORRECT - Motif Next.js 16
export default async function Page({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
return <div>ID: {id}</div>
}
2. Les Composants Clients Nécessitent le Hook use()
"use client"
import { use } from "react"
export default function ClientPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = use(params)
return <div>ID: {id}</div>
}
3. searchParams est Aussi Asynchrone
export default async function Page({
searchParams,
}: {
searchParams: Promise<{ page?: string }>
}) {
const { page } = await searchParams
return <div>Page: {page ?? "1"}</div>
}
Motifs Fondamentaux
Configuration du Projet
npx create-next-app@latest my-app --typescript --tailwind --eslint
cd my-app
# Ajouter shadcn/ui
npx shadcn@latest init
npx shadcn@latest add button form dialog table sidebar
Mise en Page App Router
// app/layout.tsx
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body className="min-h-screen">
{children}
</body>
</html>
)
}
Routes Dynamiques
// app/tasks/[id]/page.tsx
export default async function TaskPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
const task = await getTask(id)
return (
<main>
<h1>{task.title}</h1>
</main>
)
}
Actions Serveur
// app/actions.ts
"use server"
import { revalidatePath } from "next/cache"
export async function createTask(formData: FormData) {
const title = formData.get("title") as string
await db.insert(tasks).values({ title })
revalidatePath("/tasks")
}
// Utilisation dans un composant
<form action={createTask}>
<input name="title" />
<button type="submit">Create</button>
</form>
Routes API
// app/api/tasks/route.ts
import { NextResponse } from "next/server"
export async function GET() {
const tasks = await db.select().from(tasksTable)
return NextResponse.json(tasks)
}
export async function POST(request: Request) {
const body = await request.json()
const task = await db.insert(tasksTable).values(body).returning()
return NextResponse.json(task, { status: 201 })
}
Middleware → proxy.ts
// proxy.ts (remplace middleware.ts dans Next.js 16)
import { NextRequest } from "next/server"
export function proxy(request: NextRequest) {
// Vérification d'authentification
const token = request.cookies.get("token")
if (!token && request.nextUrl.pathname.startsWith("/dashboard")) {
return Response.redirect(new URL("/login", request.url))
}
}
export const config = {
matcher: ["/dashboard/:path*"],
}
Récupération de Données
Composant Serveur (Par Défaut)
// Ceci s'exécute sur le serveur - peut utiliser async/await directement
async function TaskList() {
const tasks = await fetch("https://api.example.com/tasks", {
cache: "no-store", // SSR, ou
// next: { revalidate: 60 } // ISR
}).then(r => r.json())
return (
<ul>
{tasks.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Composant Client
"use client"
import useSWR from "swr"
const fetcher = (url: string) => fetch(url).then(r => r.json())
export function ClientTaskList() {
const { data, error, isLoading } = useSWR("/api/tasks", fetcher)
if (isLoading) return <div>Loading...</div>
if (error) return <div>Error loading tasks</div>
return (
<ul>
{data.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Structure du Projet
app/
├── layout.tsx # Mise en page racine
├── page.tsx # Page d'accueil
├── globals.css # Styles globaux
├── api/ # Routes API
│ └── tasks/route.ts
├── tasks/
│ ├── page.tsx # /tasks
│ └── [id]/page.tsx # /tasks/:id
├── actions.ts # Actions serveur
└── proxy.ts # Proxy de requête (middleware)
components/
├── ui/ # Composants shadcn/ui
└── task-list.tsx # Composants d'application
lib/
├── db.ts # Connexion à la base de données
└── utils.ts # Utilitaires
Next.js DevTools MCP
Utilisez le serveur next-devtools-mcp pour les diagnostics en cours d'exécution et l'automatisation du développement.
Configuration
claude mcp add next-devtools npx next-devtools-mcp@latest
Ou dans settings.json :
{
"mcpServers": {
"next-devtools": {
"type": "stdio",
"command": "npx",
"args": ["next-devtools-mcp@latest"]
}
}
}
Outils Disponibles
| Outil | Objectif |
|---|---|
init | Établir le contexte avec les outils et bonnes pratiques disponibles |
nextjs_docs | Rechercher et récupérer la documentation officielle Next.js |
browser_eval | Automatiser les tests navigateur avec Playwright |
nextjs_index | Découvrir les serveurs de développement Next.js en cours d'exécution |
nextjs_call | Exécuter les outils MCP sur les serveurs de développement en cours |
upgrade_nextjs_16 | Mise à niveau automatisée avec les codemods |
enable_cache_components | Configurer les Composants de Cache pour Next.js 16 |
Cas d'Utilisation Clés
1. Obtenir les Erreurs en Temps Réel
"Quelles sont les erreurs de build dans mon application Next.js ?"
"Montre-moi les erreurs TypeScript dans le projet actuel"
2. Déboguer les Problèmes d'Exécution
"Vérifie les logs du serveur de développement pour les erreurs"
"Quelles erreurs d'exécution se produisent sur la page du tableau de bord ?"
3. Assistance à la Mise à Niveau
"Mets à niveau ce projet vers Next.js 16"
"Active les composants de cache pour cette application"
4. Recherche Documentaire
"Comment utiliser le composant Image dans Next.js 16 ?"
"Quelle est la bonne façon de gérer les routes dynamiques ?"
Point de Terminaison MCP Next.js 16
Next.js 16+ expose un point de terminaison MCP intégré à http://localhost:3000/_next/mcp (ou le port de votre serveur de développement). Le devtools MCP découvre et se connecte automatiquement aux serveurs en cours d'exécution.
Vérification
Exécutez : python3 scripts/verify.py
Attendu : ✓ building-nextjs-apps skill ready
En Cas d'Échec de la Vérification
- Vérifiez que le dossier references/ contient nextjs-16-patterns.md
- Arrêtez-vous et signalez si l'échec persiste
Compétences Connexes
- styling-with-shadcn - Composants UI pour applications Next.js
- fetching-library-docs - Documentation Next.js la plus récente :
--library-id /vercel/next.js --topic routing - configuring-better-auth - OAuth/SSO pour applications Next.js
Références
- references/nextjs-16-patterns.md - Motifs Next.js 16 complets
- references/frontend-design.md - Directives esthétiques pour une UI distinctive
- references/datetime-patterns.md - Gestion UTC/fuseaux horaires pour les entrées datetime-local