Prácticas Recomendadas de Vercel para React
Guía completa de optimización de rendimiento para aplicaciones React y Next.js, mantenida por Vercel. Contiene 45 reglas en 8 categorías, priorizadas por impacto, para guiar la refactorización automatizada y la generación de código.
Cuándo Aplicar
Consulta estas pautas cuando:
- Escribas nuevos componentes React o páginas Next.js
- Implementes la obtención de datos (del lado del cliente o del servidor)
- Revises código en busca de problemas de rendimiento
- Refactorices código React/Next.js existente
- Optimices el tamaño del paquete o los tiempos de carga
Categorías de Reglas por Prioridad
| Prioridad | Categoría | Impacto | Prefijo |
|---|---|---|---|
| 1 | Eliminación de Cascadas | CRÍTICO | async- |
| 2 | Optimización del Tamaño del Paquete | CRÍTICO | bundle- |
| 3 | Rendimiento del Lado del Servidor | ALTO | server- |
| 4 | Obtención de Datos del Lado del Cliente | MEDIO-ALTO | client- |
| 5 | Optimización de Re-renderizados | MEDIO | rerender- |
| 6 | Rendimiento de Renderizado | MEDIO | rendering- |
| 7 | Rendimiento de JavaScript | BAJO-MEDIO | js- |
| 8 | Patrones Avanzados | BAJO | advanced- |
Referencia Rápida
1. Eliminación de Cascadas (CRÍTICO)
async-defer-await- Mueveawaita las ramas donde se usa realmenteasync-parallel- UsaPromise.all()para operaciones independientesasync-dependencies- Usabetter-allpara dependencias parcialesasync-api-routes- Inicia las promesas temprano, usaawaittarde en rutas APIasync-suspense-boundaries- UsaSuspensepara transmitir contenido
2. Optimización del Tamaño del Paquete (CRÍTICO)
bundle-barrel-imports- Importa directamente, evita archivos barrelbundle-dynamic-imports- Usanext/dynamicpara componentes pesadosbundle-defer-third-party- Carga análisis/registro después de la hidrataciónbundle-conditional- Carga módulos solo cuando la función está activadabundle-preload- Precarga al pasar el ratón/enfocar para velocidad percibida
3. Rendimiento del Lado del Servidor (ALTO)
server-cache-react- UsaReact.cache()para deduplicación por solicitudserver-cache-lru- Usa caché LRU para almacenamiento en caché entre solicitudesserver-serialization- Minimiza los datos pasados a componentes del clienteserver-parallel-fetching- Reestructura componentes para paralelizar las obtencionesserver-after-nonblocking- Usaafter()para operaciones no bloqueantes
4. Obtención de Datos del Lado del Cliente (MEDIO-ALTO)
client-swr-dedup- Usa SWR para deduplicación automática de solicitudesclient-event-listeners- Deduplica los oyentes de eventos globales
5. Optimización de Re-renderizados (MEDIO)
rerender-defer-reads- No te suscribas a estado que solo se usa en callbacksrerender-memo- Extrae trabajo costoso en componentes memoizadosrerender-dependencies- Usa dependencias primitivas en efectosrerender-derived-state- Suscríbete a booleanos derivados, no a valores brutosrerender-functional-setstate- UsasetStatefuncional para callbacks establesrerender-lazy-state-init- Pasa una función auseStatepara valores costososrerender-transitions- UsastartTransitionpara actualizaciones no urgentes
6. Rendimiento de Renderizado (MEDIO)
rendering-animate-svg-wrapper- Anima el contenedordiv, no el elemento SVGrendering-content-visibility- Usacontent-visibilitypara listas largasrendering-hoist-jsx- Extrae JSX estático fuera de los componentesrendering-svg-precision- Reduce la precisión de coordenadas SVGrendering-hydration-no-flicker- Usa script en línea para datos solo del clienterendering-activity- Usa el componenteActivitypara mostrar/ocultarrendering-conditional-render- Usa operador ternario, no&¶ condicionales
7. Rendimiento de JavaScript (BAJO-MEDIO)
js-batch-dom-css- Agrupa cambios de CSS mediante clases ocssTextjs-index-maps- Construye unMappara búsquedas repetidasjs-cache-property-access- Almacena en caché las propiedades de objetos en buclesjs-cache-function-results- Almacena en caché los resultados de funciones en unMapa nivel de módulojs-cache-storage- Almacena en caché las lecturas delocalStorage/sessionStoragejs-combine-iterations- Combina múltiplesfilter/mapen un solo buclejs-length-check-first- Verifica la longitud del array antes de una comparación costosajs-early-exit- Salida temprana de funcionesjs-hoist-regexp- Eleva la creación deRegExpfuera de los buclesjs-min-max-loop- Usa un bucle para min/max en lugar desortjs-set-map-lookups- UsaSet/Mappara búsquedas O(1)js-tosorted-immutable- UsatoSorted()para inmutabilidad
8. Patrones Avanzados (BAJO)
advanced-event-handler-refs- Almacena los manejadores de eventos enrefsadvanced-use-latest-useLatestpara referencias de callbacks estables
Cómo Usar
Lee los archivos de reglas individuales para obtener explicaciones detalladas y ejemplos de código:
reglas/async-parallel.md
reglas/bundle-barrel-imports.md
reglas/_sections.md
Cada archivo de regla contiene:
- Una breve explicación de por qué es importante
- Ejemplo de código incorrecto con explicación
- Ejemplo de código correcto con explicación
- Contexto adicional y referencias
Documento Compilado Completo
Para la guía completa con todas las reglas expandidas: AGENTS.md