Skill
Vercel React Best Practices
Crédito: vercel-labs no GitHub (vercel-labs/agent-skills) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026
32 mil estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
--- name: vercel-react-best-practices description: Diretrizes de otimização de desempenho para React e Next.js, da Vercel Engineering. Esta skill deve ser usada ao escrever, revisar ou refatorar código React/Next.js para garantir padrões de desempenho ideais. Acionada em tarefas que envolvem componentes React, páginas Next.js, busca de dados, otimização de bundle ou melhorias de desempenho. license: MIT metadata: author: vercel version: "1.0.0" --- # Vercel React Best Practices Guia completo de otimização de desempenho para aplicações React e Next.js, mantido pela Vercel. Contém 70 regras em 8 categorias, priorizadas por impacto, para orientar refatorações automatizadas e a geração de código. ## Quando aplicar Consulte estas diretrizes quando: - Escrever novos componentes React ou páginas Next.js - Implementar busca de dados (no cliente ou no servidor) - Revisar código em busca de problemas de desempenho - Refatorar código React/Next.js existente - Otimizar o tamanho do bundle ou os tempos de carregamento ## Categorias de regras por prioridade | Prioridade | Categoria | Impacto | Prefixo | |------------|-----------|---------|---------| | 1 | Eliminar waterfalls | CRÍTICO | `async-` | | 2 | Otimização do tamanho do bundle | CRÍTICO | `bundle-` | | 3 | Desempenho no servidor | ALTO | `server-` | | 4 | Busca de dados no cliente | MÉDIO-ALTO | `client-` | | 5 | Otimização de re-renderizações | MÉDIO | `rerender-` | | 6 | Desempenho de renderização | MÉDIO | `rendering-` | | 7 | Desempenho de JavaScript | BAIXO-MÉDIO | `js-` | | 8 | Padrões avançados | BAIXO | `advanced-` | ## Referência rápida ### 1. Eliminar waterfalls (CRÍTICO) - `async-cheap-condition-before-await` - Verifique condições síncronas baratas antes de aguardar flags ou valores remotos - `async-defer-await` - Mova o await para os ramos em que ele é realmente usado - `async-parallel` - Use Promise.all() para operações independentes - `async-dependencies` - Use better-all para dependências parciais - `async-api-routes` - Inicie as promises cedo e aguarde tarde nas rotas de API - `async-suspense-boundaries` - Use Suspense para fazer streaming do conteúdo ### 2. Otimização do tamanho do bundle (CRÍTICO) - `bundle-barrel-imports` - Importe diretamente, evite arquivos barrel - `bundle-analyzable-paths` - Prefira caminhos de importação e de sistema de arquivos analisáveis estaticamente, para evitar bundles e traces amplos - `bundle-dynamic-imports` - Use next/dynamic para componentes pesados - `bundle-defer-third-party` - Carregue analytics/logging após a hidratação - `bundle-conditional` - Carregue módulos apenas quando a funcionalidade for ativada - `bundle-preload` - Faça preload no hover/foco para dar sensação de velocidade ### 3. Desempenho no servidor (ALTO) - `server-auth-actions` - Autentique as server actions como as rotas de API - `server-cache-react` - Use React.cache() para deduplicação por requisição - `server-cache-lru` - Use cache LRU para cache entre requisições - `server-dedup-props` - Evite serialização duplicada nas props de RSC - `server-hoist-static-io` - Eleve I/O estático (fontes, logotipos) ao nível do módulo - `server-no-shared-module-state` - Evite estado mutável de requisição no nível do módulo em RSC/SSR - `server-serialization` - Minimize os dados passados a componentes de cliente - `server-parallel-fetching` - Reestruture os componentes para paralelizar as buscas - `server-parallel-nested-fetching` - Encadeie as buscas aninhadas de cada item dentro de Promise.all - `server-after-nonblocking` - Use after() para operações não bloqueantes ### 4. Busca de dados no cliente (MÉDIO-ALTO) - `client-swr-dedup` - Use SWR para deduplicação automática de requisições - `client-event-listeners` - Deduplique os listeners de eventos globais - `client-passive-event-listeners` - Use listeners passivos para scroll - `client-localstorage-schema` - Versione e minimize os dados do localStorage ### 5. Otimização de re-renderizações (MÉDIO) - `rerender-defer-reads` - Não assine estado usado apenas em callbacks - `rerender-memo` - Extraia trabalho caro para componentes memoizados - `rerender-memo-with-default-value` - Eleve as props padrão não primitivas - `rerender-dependencies` - Use dependências primitivas nos effects - `rerender-derived-state` - Assine booleanos derivados, não valores brutos - `rerender-derived-state-no-effect` - Derive o estado durante a renderização, não em effects - `rerender-functional-setstate` - Use setState funcional para callbacks estáveis - `rerender-lazy-state-init` - Passe uma função ao useState para valores caros - `rerender-simple-expression-in-memo` - Evite memo para primitivos simples - `rerender-split-combined-hooks` - Divida hooks com dependências independentes - `rerender-move-effect-to-event` - Coloque a lógica de interação nos manipuladores de evento - `rerender-transitions` - Use startTransition para atualizações não urgentes - `rerender-use-deferred-value` - Adie renderizações caras para manter a entrada responsiva - `rerender-use-ref-transient-values` - Use refs para valores transitórios e frequentes - `rerender-no-inline-components` - Não defina componentes dentro de componentes ### 6. Desempenho de renderização (MÉDIO) - `rendering-animate-svg-wrapper` - Anime o div que envolve, não o elemento SVG - `rendering-content-visibility` - Use content-visibility em listas longas - `rendering-hoist-jsx` - Extraia JSX estático para fora dos componentes - `rendering-svg-precision` - Reduza a precisão das coordenadas do SVG - `rendering-hydration-no-flicker` - Use script inline para dados exclusivos do cliente - `rendering-hydration-suppress-warning` - Suprima divergências esperadas - `rendering-activity` - Use o componente Activity para mostrar/ocultar - `rendering-conditional-render` - Use ternário, não &&, em condicionais - `rendering-usetransition-loading` - Prefira useTransition para o estado de carregamento - `rendering-resource-hints` - Use as dicas de recursos do React DOM para preload - `rendering-script-defer-async` - Use defer ou async em tags script ### 7. Desempenho de JavaScript (BAIXO-MÉDIO) - `js-batch-dom-css` - Agrupe alterações de CSS por classes ou cssText - `js-index-maps` - Monte um Map para buscas repetidas - `js-cache-property-access` - Guarde em cache as propriedades de objetos em laços - `js-cache-function-results` - Guarde em cache os resultados de funções em um Map no nível do módulo - `js-cache-storage` - Guarde em cache as leituras de localStorage/sessionStorage - `js-combine-iterations` - Combine vários filter/map em um único laço - `js-length-check-first` - Verifique o tamanho do array antes de comparações caras - `js-early-exit` - Retorne cedo nas funções - `js-hoist-regexp` - Eleve a criação de RegExp para fora dos laços - `js-min-max-loop` - Use um laço para mín/máx em vez de ordenar - `js-set-map-lookups` - Use Set/Map para buscas O(1) - `js-tosorted-immutable` - Use toSorted() para imutabilidade - `js-flatmap-filter` - Use flatMap para mapear e filtrar em uma só passada - `js-request-idle-callback` - Adie o trabalho não crítico para o tempo ocioso do navegador ### 8. Padrões avançados (BAIXO) - `advanced-effect-event-deps` - Não coloque resultados de `useEffectEvent` nas dependências de effects - `advanced-event-handler-refs` - Guarde os manipuladores de evento em refs - `advanced-init-once` - Inicialize a aplicação uma vez por carregamento - `advanced-use-latest` - useLatest para refs de callback estáveis ## Como usar Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código: ``` rules/async-parallel.md rules/bundle-barrel-imports.md ``` Cada arquivo de regra contém: - Uma breve explicação de por que ela importa - Um exemplo de código incorreto, com explicação - Um exemplo de código correto, com explicação - Contexto adicional e referências ## Documento compilado completo Para o guia completo com todas as regras expandidas: `AGENTS.md`
Funciona com:Claude

