Práticas Recomendadas do Next.js
Princípios para desenvolvimento com Next.js App Router.
1. Componentes de Servidor vs Cliente
Árvore de Decisão
Precisa de...?
│
├── useState, useEffect, event handlers
│ └── Componente Cliente ('use client')
│
├── Busca de dados direta, sem interatividade
│ └── Componente Servidor (padrão)
│
└── Ambos?
└── Dividir: Pai Servidor + Filho Cliente
Por Padrão
| Tipo | Uso |
|---|
| Servidor | Busca de dados, layout, conteúdo estático |
| Cliente | Formulários, botões, UI interativa |
2. Padrões de Busca de Dados
Estratégia de Fetch
| Padrão | Uso |
|---|
| Padrão | Estático (cacheado na build) |
| Revalidate | ISR (atualização baseada em tempo) |
| No-store | Dinâmico (a cada requisição) |
Fluxo de Dados
| Fonte | Padrão |
|---|
| Banco de Dados | Fetch no Componente Servidor |
| API | fetch com caching |
| Input do usuário | State do cliente + server action |
3. Princípios de Roteamento
Convenções de Arquivos
| Arquivo | Propósito |
|---|
page.tsx | UI da rota |
layout.tsx | Layout compartilhado |
loading.tsx | Estado de carregamento |
error.tsx | Boundary de erro |
not-found.tsx | Página 404 |
Organização de Rotas
| Padrão | Uso |
|---|
Grupos de rota (nome) | Organizar sem afetar a URL |
Rotas paralelas @slot | Múltiplas páginas no mesmo nível |
Interceptação (.) | Overlays modais |
4. Rotas de API
Manipuladores de Rota
| Método | Uso |
|---|
| GET | Ler dados |
| POST | Criar dados |
| PUT/PATCH | Atualizar dados |
| DELETE | Remover dados |
Melhores Práticas
- Validar input com Zod
- Retornar códigos de status corretos
- Tratar erros graciosamente
- Usar Edge runtime quando possível
5. Princípios de Performance
Otimização de Imagens
- Usar componente next/image
- Definir prioridade para conteúdo acima da dobra
- Fornecer placeholder de blur
- Usar tamanhos responsivos
Otimização de Bundle
- Importações dinâmicas para componentes pesados
- Divisão de código baseada em rota (automática)
- Analisar com bundle analyzer
6. Metadados
Estático vs Dinâmico
| Tipo | Uso |
|---|
| Export estático | Metadados fixos |
| generateMetadata | Dinâmico por rota |
Tags Essenciais
- title (50-60 caracteres)
- description (150-160 caracteres)
- Imagens Open Graph
- URL canônica
7. Estratégia de Caching
Camadas de Cache
| Camada | Controle |
|---|
| Requisição | opções do fetch |
| Dados | revalidate/tags |
| Rota completa | configuração da rota |
Revalidação
| Método | Uso |
|---|
| Baseada em tempo | revalidate: 60 |
| Sob demanda | revalidatePath/Tag |
| Sem cache | no-store |
8. Server Actions
Casos de Uso
- Submissões de formulários
- Mutações de dados
- Gatilhos de revalidação
Melhores Práticas
- Marcar com 'use server'
- Validar todos os inputs
- Retornar respostas tipadas
- Tratar erros
9. Anti-Padrões
| ❌ Não Faça | ✅ Faça |
|---|
| 'use client' em todo lugar | Servidor por padrão |
| Fetch em componentes cliente | Fetch no servidor |
| Pular estados de carregamento | Use loading.tsx |
| Ignorar boundaries de erro | Use error.tsx |
| Grandes bundles cliente | Importações dinâmicas |
10. Estrutura do Projeto
app/
├── (marketing)/ # Grupo de rota
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # Layout do dashboard
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
Lembre-se: Componentes Servidor são o padrão por um motivo. Comece por lá, adicione cliente apenas quando necessário.
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituto para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.