Bonnes Pratiques Next.js
Règle de Lecture Sélective
Commencez par :
references/senior-master-standard.md
references/usage-routing.md
references/quality-checklist.md
Ensuite, chargez uniquement les documents hérités, scripts, ressources ou exemples qui correspondent à la tâche réelle de l'utilisateur.
Principes pour le développement avec Next.js App Router.
1. Composants Serveur vs Client
Arbre de Décision
Est-ce que ça nécessite... ?
│
├── useState, useEffect, gestionnaires d'événements
│ └── Composant Client ('use client')
│
├── Récupération directe de données, pas d'interactivité
│ └── Composant Serveur (par défaut)
│
└── Les deux ?
└── Scinder : parent Serveur + enfant Client
Par Défaut
| Type | Utilisation |
|---|
| Serveur | Récupération de données, mise en page, contenu statique |
| Client | Formulaires, boutons, UI interactive |
2. Modèles de Récupération de Données
Stratégie de Récupération
| Modèle | Utilisation |
|---|
| Par défaut | Statique (mis en cache à la construction) |
| Revalidation | ISR (rafraîchissement basé sur le temps) |
| No-store | Dynamique (à chaque requête) |
Flux de Données
| Source | Modèle |
|---|
| Base de données | Récupération dans Composant Serveur |
| API | fetch avec mise en cache |
| Entrée utilisateur | État client + action serveur |
3. Principes de Routage
Conventions de Fichiers
| Fichier | Objectif |
|---|
page.tsx | UI de la route |
layout.tsx | Mise en page partagée |
loading.tsx | État de chargement |
error.tsx | Limite d'erreur |
not-found.tsx | Page 404 |
Organisation des Routes
| Modèle | Utilisation |
|---|
Groupes de routes (nom) | Organiser sans modifier l'URL |
Routes parallèles @slot | Pages multiples au même niveau |
Interception (.) | Superpositions modales |
4. Routes API
Gestionnaires de Route
| Méthode | Utilisation |
|---|
| GET | Lire des données |
| POST | Créer des données |
| PUT/PATCH | Mettre à jour des données |
| DELETE | Supprimer des données |
Bonnes Pratiques
- Valider les entrées avec Zod
- Retourner les codes de statut appropriés
- Gérer les erreurs avec élégance
- Utiliser l'environnement Edge lorsque c'est possible
5. Principes de Performance
Optimisation des Images
- Utiliser le composant next/image
- Définir priority pour le contenu au-dessus de la ligne de flottaison
- Fournir un placeholder flou
- Utiliser des tailles responsives
Optimisation du Bundle
- Importations dynamiques pour les composants lourds
- Division de code basée sur les routes (automatique)
- Analyser avec bundle analyzer
6. Métadonnées
Statiques vs Dynamiques
| Type | Utilisation |
|---|
| Export statique | Métadonnées fixes |
| generateMetadata | Dynamiques par route |
Balises Essentielles
- title (50-60 caractères)
- description (150-160 caractères)
- Images Open Graph
- URL canonique
7. Stratégie de Mise en Cache
Couches de Cache
| Couche | Contrôle |
|---|
| Requête | options fetch |
| Données | revalidate/tags |
| Route complète | configuration de route |
Revalidation
| Méthode | Utilisation |
|---|
| Basée sur le temps | revalidate: 60 |
| À la demande | revalidatePath/Tag |
| Pas de cache | no-store |
8. Actions Serveur
Cas d'Utilisation
- Soumissions de formulaires
- Mutations de données
- Déclencheurs de revalidation
Bonnes Pratiques
- Marquer avec 'use server'
- Valider toutes les entrées
- Retourner des réponses typées
- Gérer les erreurs
9. Anti-Patrons
| ❌ Ne faites pas | ✅ Faites |
|---|
| 'use client' partout | Serveur par défaut |
| fetch dans les composants client | fetch dans le serveur |
| Ignorer les états de chargement | Utiliser loading.tsx |
| Ignorer les limites d'erreur | Utiliser error.tsx |
| Gros bundles client | Importations dynamiques |
10. Structure du Projet
app/
├── (marketing)/ # Groupe de routes
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # Mise en page du tableau de bord
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
Rappelez-vous : Les Composants Serveur sont la valeur par défaut pour une bonne raison. Commencez par là, ajoutez le client uniquement lorsque c'est nécessaire.
Quand Utiliser
Cette compétence est applicable pour exécuter le flux de travail ou les actions décrits dans l'aperçu.
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue d'expert spécifique à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.