Pular para o conteúdo
UseIA
0
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
Salvar

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`