Présentation détaillée
Ce Skill aide à choisir le point de départ d'une revue des performances React ou Next.js. La version référencée répartit 70 règles en huit catégories. Les enchaînements de requêtes et la taille du bundle viennent en premier, suivis du travail serveur, des données côté client, des rendus répétés, du coût du rendu, de JavaScript et des modèles avancés. Cet ordre permet d'examiner les dépendances et le chargement avant de consacrer du temps à de petites réécritures locales.
SKILL.md constitue l'index. Les fichiers du dossier rules/ expliquent les modèles avec des exemples de code inadapté puis corrigé ; AGENTS.md rassemble les recommandations développées. Par exemple, async-parallel concerne les opérations indépendantes, tandis que bundle-barrel-imports traite de la structure des imports. Il faut lire l'explication concernée avant de l'appliquer à un composant et tenir compte des dépendances de données, des autorisations et de la version du framework.
Éléments à préparer
- La version de React ou Next.js, les fichiers des pages et composants concernés et la tâche à examiner.
- Le code associé aux requêtes et aux imports ; les diagnostics de bundle ou de performance existants peuvent être utiles.
- Le comportement à préserver, notamment les dépendances, les limites serveur/client et les autorisations.
Résultats attendus
- Des pistes de revue reliées à des règles précises et à leurs catégories d'impact.
- Des modèles et exemples de code issus des règles pour évaluer un changement.
- Des améliorations possibles à vérifier avec le build, les tests de comportement et les mesures du projet.
Marche à suivre
- Définir la page ou le composant cible, la version du framework et le problème de comportement ou de chargement.
- Commencer par les requêtes en cascade et la taille du bundle, puis choisir les autres catégories adaptées au code.
- Lire le fichier de règle ou son développement dans AGENTS.md plutôt que la seule ligne de l'index.
- Vérifier la proposition selon les dépendances réelles, la portée des requêtes, les autorisations et les API disponibles.
- Si vous modifiez votre projet, limiter le changement et comparer le comportement ainsi que les diagnostics dans les mêmes conditions.
Limites et vérifications
- Les opérations parallélisées sont indépendantes ; l'ordre nécessaire aux données et aux autorisations reste intact.
- Les imports et le chargement différé respectent la séparation entre serveur et client.
- Le cache n'introduit pas d'état mutable partagé entre requêtes ni de mélange des données des utilisateurs.
- Le projet dispose des API React ou Next.js de la règle retenue.
- Les tests et mesures étayent la proposition ; une catégorie d'impact n'est pas un gain déjà mesuré.
Questions fréquentes
Est-ce réservé aux projets Next.js ?
La source couvre React et Next.js. Les règles sur l'état des composants, les nouveaux rendus et JavaScript peuvent s'appliquer à du code React. Les actions serveur et les modèles propres à un framework demandent l'environnement correspondant. Il faut sélectionner les règles pertinentes.
Puis-je copier uniquement SKILL.md ?
Le document d'entrée renvoie aux règles individuelles et à AGENTS.md. L'assistant doit pouvoir consulter le paquet complet pour accéder aux explications et aux exemples derrière l'index.
Le paquet fournit-il un score de performance pour mon application ?
Il fournit des recommandations et des exemples, pas une mesure de votre application. Utilisez vos propres outils de build et de diagnostic pour comparer une proposition à la version initiale dans des conditions cohérentes.
Installer ce Skill
Ajoutez ce Skill depuis sa source GitHub vérifiée avec la Skills CLI.
npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practicesInformations sur la source
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Vercel React Best Practices
Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 70 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Writing new React components or Next.js pages
- Implementing data fetching (client or server-side)
- Reviewing code for performance issues
- Refactoring existing React/Next.js code
- Optimizing bundle size or load times
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Eliminating Waterfalls | CRITICAL | async- |
| 2 | Bundle Size Optimization | CRITICAL | bundle- |
| 3 | Server-Side Performance | HIGH | server- |
| 4 | Client-Side Data Fetching | MEDIUM-HIGH | client- |
| 5 | Re-render Optimization | MEDIUM | rerender- |
| 6 | Rendering Performance | MEDIUM | rendering- |
| 7 | JavaScript Performance | LOW-MEDIUM | js- |
| 8 | Advanced Patterns | LOW | advanced- |
Quick Reference
1. Eliminating Waterfalls (CRITICAL)
async-cheap-condition-before-await- Check cheap sync conditions before awaiting flags or remote valuesasync-defer-await- Move await into branches where actually usedasync-parallel- Use Promise.all() for independent operationsasync-dependencies- Use better-all for partial dependenciesasync-api-routes- Start promises early, await late in API routesasync-suspense-boundaries- Use Suspense to stream content
2. Bundle Size Optimization (CRITICAL)
bundle-barrel-imports- Import directly, avoid barrel filesbundle-analyzable-paths- Prefer statically analyzable import and file-system paths to avoid broad bundles and tracesbundle-dynamic-imports- Use next/dynamic for heavy componentsbundle-defer-third-party- Load analytics/logging after hydrationbundle-conditional- Load modules only when feature is activatedbundle-preload- Preload on hover/focus for perceived speed
3. Server-Side Performance (HIGH)
server-auth-actions- Authenticate server actions like API routesserver-cache-react- Use React.cache() for per-request deduplicationserver-cache-lru- Use LRU cache for cross-request cachingserver-dedup-props- Avoid duplicate serialization in RSC propsserver-hoist-static-io- Hoist static I/O (fonts, logos) to module levelserver-no-shared-module-state- Avoid module-level mutable request state in RSC/SSRserver-serialization- Minimize data passed to client componentsserver-parallel-fetching- Restructure components to parallelize fetchesserver-parallel-nested-fetching- Chain nested fetches per item in Promise.allserver-after-nonblocking- Use after() for non-blocking operations
4. Client-Side Data Fetching (MEDIUM-HIGH)
client-swr-dedup- Use SWR for automatic request deduplicationclient-event-listeners- Deduplicate global event listenersclient-passive-event-listeners- Use passive listeners for scrollclient-localstorage-schema- Version and minimize localStorage data
5. Re-render Optimization (MEDIUM)
rerender-defer-reads- Don't subscribe to state only used in callbacksrerender-memo- Extract expensive work into memoized componentsrerender-memo-with-default-value- Hoist default non-primitive propsrerender-dependencies- Use primitive dependencies in effectsrerender-derived-state- Subscribe to derived booleans, not raw valuesrerender-derived-state-no-effect- Derive state during render, not effectsrerender-functional-setstate- Use functional setState for stable callbacksrerender-lazy-state-init- Pass function to useState for expensive valuesrerender-simple-expression-in-memo- Avoid memo for simple primitivesrerender-split-combined-hooks- Split hooks with independent dependenciesrerender-move-effect-to-event- Put interaction logic in event handlersrerender-transitions- Use startTransition for non-urgent updatesrerender-use-deferred-value- Defer expensive renders to keep input responsivererender-use-ref-transient-values- Use refs for transient frequent valuesrerender-no-inline-components- Don't define components inside components
6. Rendering Performance (MEDIUM)
rendering-animate-svg-wrapper- Animate div wrapper, not SVG elementrendering-content-visibility- Use content-visibility for long listsrendering-hoist-jsx- Extract static JSX outside componentsrendering-svg-precision- Reduce SVG coordinate precisionrendering-hydration-no-flicker- Use inline script for client-only datarendering-hydration-suppress-warning- Suppress expected mismatchesrendering-activity- Use Activity component for show/hiderendering-conditional-render- Use ternary, not && for conditionalsrendering-usetransition-loading- Prefer useTransition for loading staterendering-resource-hints- Use React DOM resource hints for preloadingrendering-script-defer-async- Use defer or async on script tags
7. JavaScript Performance (LOW-MEDIUM)
js-batch-dom-css- Group CSS changes via classes or cssTextjs-index-maps- Build Map for repeated lookupsjs-cache-property-access- Cache object properties in loopsjs-cache-function-results- Cache function results in module-level Mapjs-cache-storage- Cache localStorage/sessionStorage readsjs-combine-iterations- Combine multiple filter/map into one loopjs-length-check-first- Check array length before expensive comparisonjs-early-exit- Return early from functionsjs-hoist-regexp- Hoist RegExp creation outside loopsjs-min-max-loop- Use loop for min/max instead of sortjs-set-map-lookups- Use Set/Map for O(1) lookupsjs-tosorted-immutable- Use toSorted() for immutabilityjs-flatmap-filter- Use flatMap to map and filter in one passjs-request-idle-callback- Defer non-critical work to browser idle time
8. Advanced Patterns (LOW)
advanced-effect-event-deps- Don't putuseEffectEventresults in effect depsadvanced-event-handler-refs- Store event handlers in refsadvanced-init-once- Initialize app once per app loadadvanced-use-latest- useLatest for stable callback refs
How to Use
Read individual rule files for detailed explanations and code examples:
rules/async-parallel.md
rules/bundle-barrel-imports.mdEach rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md

