Next.js Tooling
Prioridade: P2 (MÉDIA)
Estrutura
project/
├── .next/ # Artefatos de build
├── next.config.js # Configuração avançada
└── .eslintrc.json # Plugins Next
Diretrizes de Implementação
- Arquitetura de Build: Use
Turbopack (moderno) ou Webpack (legado). Ative --turbo para desenvolvimento incremental mais rápido.
- Minificação: Certifique-se de definir
output: 'standalone' no next.config.js para deploys otimizados em Docker. Use equivalentes de ProGuard / Uglify para redução de assets.
- Linting: Torne obrigatório o uso de
next lint (plugin ESLint do Next.js) e tsc (typecheck) nos pipelines de CI/CD.
- Otimização de Assets: Inspecione o tamanho com
@next/bundle-analyzer. Otimize imagens via next/image e remova dependências não utilizadas.
- Telemetria: Desative com
next telemetry disable se a privacidade for necessária.
- Ambiente: Use gerenciamento de
.env no Next.js (somente servidor vs NEXT_PUBLIC_*). Valide esquemas com Zod em tempo de execução.
- CI/CD: Armazene em cache a pasta
.next/cache no CI para tempos de build 50%+ mais rápidos.
Anti-Padrões
- Não usar
npm run start para desenvolvimento: Use next dev (ou next dev --turbo).
- Não ignorar o crescimento do bundle: Analise com
@next/bundle-analyzer antes de publicar.
- Não criar regras ESLint personalizadas em vez do plugin: Use
eslint-plugin-next para linting consciente do Next.js.
- Não usar
console.log em produção: Use loggers estruturados (Pino, Winston).
Referências