Communitygithub.com

ASoudy/AGS - Bonnes pratiques Next.js App Router

Principes du Next.js App Router : composants serveur, récupération de données et schémas de routage.

Qu'est-ce que AGS - Bonnes pratiques Next.js App Router ?

Cette compétence fournit un guide complet des meilleures pratiques pour le développement avec le Next.js App Router. Elle couvre les décisions clés entre les composants serveur et client, les schémas de récupération de données, les conventions de fichiers pour le routage, les API Routes, les principes de performance, la gestion des métadonnées, les stratégies de cache, les actions serveur et les anti-patrons. Le résumé aide les développeurs à comprendre quand utiliser chaque type de composant, comment organiser le code et comment optimiser les performances et la maintenabilité d'une application Next.js. Il est utile pour tout développeur travaillant avec Next.js 13+ et le App Router, et fournit des instructions claires et structurées, sous forme de tableaux et de listes, pour une implémentation rapide et correcte.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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

Principes pour le développement avec le Next.js App Router.


1. Composants serveur vs client

Arbre de décision

L'élément a besoin...?
│
├── useState, useEffect, gestionnaires d'événements
│   └── Composant client ('use client')
│
├── Récupération directe de données, aucune interactivité
│   └── Composant serveur (par défaut)
│
└── Les deux ?
    └── Séparer : parent serveur + enfant client

Par défaut

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

2. Schémas de récupération de données

Stratégie de récupération

SchémaUtilisation
Par défautStatique (mis en cache à la construction)
RevalidateISR (rafraîchissement basé sur le temps)
No-storeDynamique (chaque requête)

Flux de données

SourceSchéma
Base de donnéesRécupération dans un composant serveur
APIfetch avec mise en cache
Saisie 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

SchémaUtilisation
Groupes de routes (nom)Organiser sans modifier l'URL
Routes parallèles @slotPlusieurs pages 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 des codes de statut appropriés
  • Gérer les erreurs avec grâce
  • Utiliser le runtime Edge lorsque c'est possible

5. Principes de performance

Optimisation des images

  • Utiliser le composant next/image
  • Définir la priorité pour le contenu au-dessus de la ligne de flottaison
  • Fournir un espace réservé flou
  • Utiliser des tailles responsives

Optimisation du bundle

  • Imports dynamiques pour les composants lourds
  • Division de code basée sur les routes (automatique)
  • Analyser avec l'analyseur de bundle

6. Métadonnées

Statique vs dynamique

TypeUtilisation
Export statiqueMétadonnées fixes
generateMetadataDynamique 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 de fetch
Donnéesrevalidate/tags
Route complèteconfiguration de route

Revalidation

MéthodeUtilisation
Basée sur le tempsrevalidate: 60
À la demanderevalidatePath/Tag
Sans 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

❌ À éviter✅ À faire
'use client' partoutServeur par défaut
Récupérer dans les composants clientRécupérer dans le serveur
Ignorer les états de chargementUtiliser loading.tsx
Ignorer les limites d'erreurUtiliser error.tsx
Gros bundles clientImports 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/
│   └── [ressource]/
│       └── route.ts
└── components/
    └── ui/

Rappel : Les composants serveur sont le choix par défaut pour une bonne raison. Commencez par là, ajoutez du client uniquement lorsque c'est nécessaire.

Quand utiliser

Cette compétence est applicable pour exécuter le workflow 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 révision experte 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.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills associés