Communitygithub.com

Anhvu1107/nextjs-best-practices

Utilisez cette compétence lorsque l'utilisateur mentionne les bonnes pratiques Next.js, demande à construire, déboguer, réviser, documenter, automatiser, tester, configurer, migrer ou prendre des décisions dans ce domaine, ou si la tâche dépend clairement des bonnes pratiques Next.js ; couvre les principes d'App Router.

Qu'est-ce que nextjs-best-practices ?

Cette compétence fournit un guide structuré et complet des bonnes pratiques de développement avec Next.js App Router. Elle est conçue pour aider les développeurs à prendre des décisions éclairées sur l'architecture des composants, les modèles de récupération de données, l'organisation des routes, les performances, la mise en cache et les actions serveur. Elle inclut des arbres de décision, des tableaux de référence rapide, et des anti-patrons à éviter. La compétence s'appuie sur des documents de référence (standard senior, routage, checklist qualité) et applique un workflow intégré avant la sortie finale. Elle est destinée à être utilisée dans des environnements comme Claude Code, Cursor ou Codex.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/nextjs-best-practices

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

TypeUtilisation
ServeurRécupération de données, mise en page, contenu statique
ClientFormulaires, boutons, UI interactive

2. Modèles de Récupération de Données

Stratégie de Récupération

ModèleUtilisation
Par défautStatique (mis en cache à la construction)
RevalidationISR (rafraîchissement basé sur le temps)
No-storeDynamique (à chaque requête)

Flux de Données

SourceModèle
Base de donnéesRécupération dans Composant Serveur
APIfetch avec mise en cache
Entrée utilisateurÉtat client + action serveur

3. Principes de Routage

Conventions de Fichiers

FichierObjectif
page.tsxUI de la route
layout.tsxMise en page partagée
loading.tsxÉtat de chargement
error.tsxLimite d'erreur
not-found.tsxPage 404

Organisation des Routes

ModèleUtilisation
Groupes de routes (nom)Organiser sans modifier l'URL
Routes parallèles @slotPages multiples au même niveau
Interception (.)Superpositions modales

4. Routes API

Gestionnaires de Route

MéthodeUtilisation
GETLire des données
POSTCréer des données
PUT/PATCHMettre à jour des données
DELETESupprimer 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

TypeUtilisation
Export statiqueMétadonnées fixes
generateMetadataDynamiques 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

CoucheContrôle
Requêteoptions fetch
Donnéesrevalidate/tags
Route complèteconfiguration de route

Revalidation

MéthodeUtilisation
Basée sur le tempsrevalidate: 60
À la demanderevalidatePath/Tag
Pas de cacheno-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' partoutServeur par défaut
fetch dans les composants clientfetch dans le serveur
Ignorer les états de chargementUtiliser loading.tsx
Ignorer les limites d'erreurUtiliser error.tsx
Gros bundles clientImportations 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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when working with Remotion code, video compositions, rendering logic, timing, media assets, or React-based motion workflows.

Skills associés