skills/nextjs-react-expert/SKILL.md
Otimização de performance de React e Next.js pela Engenharia da Vercel. Use ao construir componentes React, otimizar a performance, eliminar waterfalls, reduzir o tamanho do bundle, revisar código para problemas de performance ou implementar otimizações no lado do servidor/cliente.
npx skillsauth add lucasfdigital/orchard react-best-practicesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Pela Engenharia da Vercel - 57 regras de otimização priorizadas por impacto. Filosofia: Elimine waterfalls primeiro, otimize bundles depois, então faça micro-otimizações.
Leia APENAS as seções relevantes para a sua tarefa! Verifique o mapa de conteúdo abaixo e selecione o que precisa.
🔴 Para revisões de performance: Comece pelas seções CRÍTICAS (1-2), depois passe para ALTA/MÉDIA.
| Arquivo | Impacto | Regras | Quando Ler |
| :--- | :--- | :--- | :--- |
| 1-async-eliminating-waterfalls.md | 🔴 CRÍTICO | 5 regras | Carregamento de página lento, chamadas de API sequenciais, waterfalls de coleta de dados |
| 2-bundle-bundle-size-optimization.md | 🔴 CRÍTICO | 5 regras | Tamanho de bundle grande, Time to Interactive (TTI) lento, problemas de Primeiro Carregamento (First Load) |
| 3-server-server-side-performance.md | 🟠 ALTO | 7 regras | SSR lento, otimização de rotas de API, waterfalls no lado do servidor |
| 4-client-client-side-data-fetching.md| 🟡 MÉDIO-ALTO | 4 regras | Gerenciamento de dados no cliente, padrões SWR, desduplicação |
| 5-rerender-re-render-optimization.md | 🟡 MÉDIO | 12 regras | Re-renders excessivos, performance do React, memoização |
| 6-rendering-rendering-performance.md | 🟡 MÉDIO | 9 rules | Gargalos de renderização, virtualização, otimização de imagens |
| 7-js-javascript-performance.md | ⚪ BAIXO-MÉDIO | 12 regras | Micro-otimizações, cache, performance de loops |
| 8-advanced-advanced-patterns.md | 🔵 VARIÁVEL | 3 regras | Padrões avançados de React, useLatest, init-once |
Total: 57 regras distribuídas em 8 categorias
Qual é o seu problema de performance?
🐌 Carregamento lento de página / Longo Time to Interactive
→ Leia a Seção 1: Eliminando Waterfalls
→ Leia a Seção 2: Otimização do Tamanho do Bundle
📦 Tamanho do bundle grande (> 200KB)
→ Leia a Seção 2: Otimização do Tamanho do Bundle
→ Verifique: Imports dinâmicos, barrel imports, tree-shaking
🖥️ Renderização no lado do servidor (SSR) lenta
→ Leia a Seção 3: Performance no Lado do Servidor
→ Verifique: Coleta de dados paralela, streaming
🔄 Muitos re-renders / Lag na UI
→ Leia a Seção 5: Otimização de Re-render
→ Verifique: React.memo, useMemo, useCallback
🎨 Problemas de performance na renderização
→ Leia a Seção 6: Performance de Renderização
→ Verifique: Virtualização, layout thrashing
🌐 Problemas de coleta de dados no lado do cliente
→ Leia a Seção 4: Coleta de Dados no Lado do Cliente
→ Verifique: Desduplicação SWR, localStorage
✨ Precisa de padrões avançados
→ Leia a Seção 8: Padrões Avançados
Use esta ordem ao realizar uma otimização abrangente:
1️⃣ CRÍTICO (Maiores ganhos - Faça primeiro):
├─ Seção 1: Eliminando Waterfalls
│ └─ Cada waterfall adiciona latência total de rede (100-500ms+)
└─ Seção 2: Otimização do Tamanho do Bundle
└─ Afeta o Time to Interactive e o Largest Contentful Paint
2️⃣ ALTO (Impacto significativo - Faça em segundo):
└─ Seção 3: Performance no Lado do Servidor
└─ Elimina waterfalls no servidor, tempos de resposta mais rápidos
3️⃣ MÉDIO (Ganhos moderados - Faça em terceiro):
├─ Seção 4: Coleta de Dados no Lado do Cliente
├─ Seção 5: Otimização de Re-render
└─ Seção 6: Performance de Renderização
4️⃣ BAIXO (Polimento - Faça por último):
├─ Seção 7: Performance de JavaScript
└─ Seção 8: Padrões Avançados
| Necessidade | Skill |
| :--- | :--- |
| Padrões de design de API | @[skills/api-patterns] |
| Otimização de banco de dados | @[skills/database-design] |
| Estratégias de teste | @[skills/testing-patterns] |
| Princípios de design UI/UX | @[skills/frontend-design] |
| Padrões de TypeScript | @[skills/typescript-expert] |
| Implantação e DevOps | @[skills/deployment-procedures] |
Antes de lançar para produção:
Crítico (Deve Corrigir):
Alta Prioridade:
Média Prioridade:
Baixa Prioridade (Polimento):
NÃO FAÇA:
await sequencial para operações independentes.index.ts) no código da aplicação.FAÇA:
Promise.all().const Comp = dynamic(() => import('./Pesado')).import { especifico } from 'biblioteca/especifico'.Iniciante (Foco no Crítico): → Seção 1: Eliminando Waterfalls → Seção 2: Otimização do Tamanho do Bundle
Intermediário (Adicione Alta Prioridade): → Seção 3: Performance no Lado do Servidor → Seção 5: Otimização de Re-render
Avançado (Otimização Completa): → Todas as seções + Seção 8: Padrões Avançados
| Script | Propósito | Comando |
| :--- | :--- | :--- |
| scripts/react_performance_checker.py | Auditoria de performance automatizada | python scripts/react_performance_checker.py <caminho_do_projeto> |
Impacto: Cada waterfall adiciona mais de 100-500ms de latência. Conceitos Chave: Coleta paralela, Promise.all(), boundaries de Suspense, preloading.
Impacto: Afeta diretamente o Time to Interactive e o Largest Contentful Paint. Conceitos Chave: Imports dinâmicos, tree-shaking, evitar barrel imports.
Impacto: Respostas do servidor mais rápidas, melhor SEO. Conceitos Chave: Coleta paralela no servidor, streaming, otimização de rotas de API.
Impacto: Reduz requisições redundantes, melhor UX. Conceitos Chave: Desduplicação SWR, cache no localStorage, event listeners.
Impacto: UI mais fluida, menos computação desperdiçada. Conceitos Chave: React.memo, useMemo, useCallback, estrutura de componentes.
Impacto: Melhor eficiência de renderização. Conceitos Chave: Virtualização, otimização de imagem, layout thrashing.
Impacto: Melhorias incrementais em caminhos críticos. Conceitos Chave: Otimização de loops, cache, hoisting de RegExp.
Impacto: Casos de uso específicos. Conceitos Chave: Hook useLatest, padrões init-once, referências de handlers de eventos.
Regras de Ouro:
Mentalidade de Performance:
await em sequência = waterfall potencial.import = inchaço potencial do bundle.Fonte: Engenharia da Vercel Data: Janeiro de 2026 Versão: 1.0.0 Total de Regras: 57 distribuídas em 8 categorias
development
Princípios de teste de aplicações web. E2E, Playwright, estratégias de auditoria profunda.
development
Revisar o código da UI para conformidade com as Web Interface Guidelines. Use quando solicitado para "revisar minha UI", "checar acessibilidade", "auditar design", "revisar UX" ou "verificar meu site em relação às melhores práticas".
testing
Princípios avançados de análise de vulnerabilidade. OWASP 2025, Segurança da Cadeia de Suprimentos (Supply Chain), mapeamento de superfície de ataque e priorização de riscos.
testing
Padrões e princípios de teste. Estratégias de testes unitários, de integração e mocking.