Melhores Práticas do Next.js
Princípios para desenvolvimento com o App Router do Next.js.
1. Componentes de Servidor vs. Cliente
Árvore de Decisão
Precisa de...?
│
├── useState, useEffect, manipuladores de eventos
│ └── 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 (armazenado em cache na build) |
| Revalidate | ISR (atualização baseada em tempo) |
| No-store | Dinâmico (a cada requisição) |
Fluxo de Dados
| Origem | Padrão |
|---|
| Banco de dados | Fetch no Componente Servidor |
| API | fetch com cache |
| Entrada do usuário | Estado no 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 (.) | Modais overlay |
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 entrada com Zod
- Retornar códigos de status adequados
- Tratar erros de forma elegante
- Usar Edge runtime quando possível
5. Princípios de Performance
Otimização de Imagens
- Usar o componente next/image
- Definir priority para conteúdo acima da dobra
- Fornecer placeholder de desfoque
- Usar tamanhos responsivos
Otimização de Bundle
- Imports dinâmicos para componentes pesados
- Code splitting baseado em rotas (automático)
- 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 Cache
Camadas de Cache
| Camada | Controle |
|---|
| Requisição | Opções de fetch |
| Dados | revalidate/tags |
| Rota completa | Configuração de 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ário
- Mutações de dados
- Gatilhos de revalidação
Melhores Práticas
- Marcar com 'use server'
- Validar todas as entradas
- Retornar respostas tipadas
- Tratar erros
9. Anti-Padrões
| ❌ Não Faça | ✅ Faça |
|---|
| 'use client' em tudo | Servidor por padrão |
| Fetch em componentes cliente | Fetch no servidor |
| Pular estados de carregamento | Usar loading.tsx |
| Ignorar error boundaries | Usar error.tsx |
| Bundles cliente grandes | Imports dinâmicos |
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 eles, adicione cliente apenas quando necessário.