Plataforma de Lançamento Next.js 16
Next.js 16: Turbopack como padrão (builds 2–5× mais rápidas), Cache Components ('use cache') e proxy.ts para controle explícito.
Quando Usar
✅ Next.js 16, Turbopack, Cache Components, migração com proxy, App Router, React 19.2
❌ Pages Router, Next.js ≤15, perguntas genéricas sobre React
Requisitos
| Ferramenta | Versão |
|---|---|
| Node.js | 20.9.0+ |
| TypeScript | 5.1.0+ |
| React | 19.2+ |
Início Rápido
# Novo projeto
npx create-next-app@latest meu-app
# Atualizar projeto existente
npx @next/codemod@canary upgrade latest
npm install next@latest react@latest react-dom@latest
Recomendado: TypeScript, ESLint, Tailwind, App Router, Turbopack, alias @/*.
Configuração Mínima
// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="pt-BR">
<body>{children}</body>
</html>
)
}
// app/page.tsx
export default function Page() {
return <h1>Olá, Next.js 16!</h1>
}
Configuração
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
reactCompiler: true,
}
export default nextConfig
Mudanças do v15 para o v16
| v15 | v16 |
|---|---|
experimental.turbopack | Padrão |
experimental.ppr | cacheComponents |
middleware.ts (Edge) | proxy.ts (Node) |
params síncrono | await params |
Padrões Principais
1. Componentes de Servidor (Padrão)
export default async function BlogPage() {
const res = await fetch('https://api.exemplo.com/posts')
const posts = await res.json()
return <PostList posts={posts} />
}
2. Cache Components
import { cacheLife } from 'next/cache'
export default async function BlogPage() {
'use cache'
cacheLife('hours')
const posts = await fetch('https://api.exemplo.com/posts').then(r => r.json())
return <PostList posts={posts} />
}
3. Componentes de Cliente
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Contagem: {count}</p>
<button onClick={() => setCount(count + 1)}>+</button>
</div>
)
}
4. Proxy Boundary
// app/proxy.ts
export function proxy(request: NextRequest) {
if (!request.cookies.get('auth') && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}
5. Cache Tags + Server Actions
// app/blog/page.tsx
'use cache'
cacheLife('hours')
cacheTag('blog-posts')
export default async function BlogList() {
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
// app/actions.ts
'use server'
import { updateTag } from 'next/cache'
export async function createPost(data: PostData) {
await db.posts.create(data)
updateTag('blog-posts')
}
6. Streaming com Suspense
export default function Dashboard() {
return (
<div>
<Suspense fallback={<Skeleton />}>
<RevenueCard />
</Suspense>
<Suspense fallback={<Skeleton />}>
<UsersCard />
</Suspense>
</div>
)
}
async function RevenueCard() {
const data = await db.analytics.revenue()
return <div>{data}</div>
}
Conceitos Chave
- Turbopack - Bundler em Rust, compilação incremental, Fast Refresh
- Componentes de Servidor - Padrão em
app/, zero JS no cliente - Componentes de Cliente -
'use client', hooks, APIs do navegador - Cache Components -
'use cache'+cacheLife()para PPR - Proxy Boundary -
proxy.tspara autenticação/reescritas/redirecionamentos - Renderização Parcial (PPR) - Estrutura estática + streaming dinâmico
Checklist de Migração
-
APIs de Requisição Assíncronas
npx @next/codemod@canary async-request-apiAtualizar:
const { slug } = await params -
middleware.ts → proxy.ts
- Renomear arquivo, exportar
proxy - Apenas runtime Node (não Edge)
- Renomear arquivo, exportar
-
Atualizações de Configuração
- Remover flags
experimental.* - Ativar
cacheComponents,reactCompiler - Remover
serverRuntimeConfig/publicRuntimeConfig
- Remover flags
-
Cache Components
- Substituir
experimental.pprporcacheComponents: true - Envolver seções dinâmicas com
<Suspense>
- Substituir
-
Imagens
- Configurar
images.localPatternspara query strings
- Configurar
Consulte references/nextjs16-migration-playbook.md para o guia completo.
Armadilhas Comuns
❌ Misturar 'use cache' com APIs de runtime (cookies(), headers())
❌ Faltar <Suspense> quando Cache Components estão habilitados
❌ Importações de Sass com til (~) sob Turbopack
❌ Executar proxy.ts no runtime Edge
✅ Ler cookies/headers primeiro e passar como props para componentes em cache
✅ Envolver filhos dinâmicos em <Suspense>
✅ Usar importações Sass padrão (sem ~)
✅ Usar runtime Node para o proxy
Guia de Decisão
Habilitar Cache Components? → Sim para conteúdo estático ou semiestático → Não para dashboards totalmente dinâmicos
Onde a autenticação deve viver?
→ proxy.ts para verificações entre rotas
→ Route handlers para lógica específica de API
Quando usar 'use client'?
→ Apenas quando precisar de hooks, estado ou APIs do navegador
→ Manter componentes de apresentação no lado do servidor
Padrões de Produção
E-commerce
// Página de produto com streaming
export default async function Product({ params }) {
const { id } = await params
const product = await db.products.findById(id)
return (
<>
<ProductInfo product={product} />
<Suspense fallback={<ReviewsSkeleton />}>
<Reviews productId={id} />
</Suspense>
</>
)
}
Dashboard Autenticado
// proxy.ts
export function proxy(request: NextRequest) {
const session = request.cookies.get('session')
if (!session && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
}
Consulte references/nextjs16-advanced-patterns.md para mais exemplos.
Desempenho
- Manter Turbopack ativado (desativar com
--webpackapenas se necessário) - Paralelizar requisições com
Promise.all - Usar
<Suspense>para limites de streaming - Ativar cache do sistema de arquivos para repositórios grandes
Segurança
- Usar o pacote
server-only+ React Taint API - Manter autenticação em
proxy.ts - Validar entradas em Server Actions
- Proteger variáveis de ambiente com prefixo
NEXT_PUBLIC_ - Extrair cookies/headers antes de escopos em cache
Implantação
- Vercel: Configuração zero
- Docker/Node:
output: 'standalone' - Monitorar tempos de build (espera-se ganho de 2 a 5 vezes)
- Configurar ciclos de vida de cache para coincidir com o CDN
Arquivos de Referência
- references/nextjs16-reference.md - Instalação/configuração/checklists
- references/nextjs16-migration-playbook.md - Guia de migração com codemods
- references/nextjs16-advanced-patterns.md - Padrões de streaming, cache e autenticação
- references/NEXTJS_16_COMPLETE_GUIDE.md - Documentação completa
- scripts/bootstrap-nextjs16.ps1 - Script de configuração automatizada
- assets/app-router-starter/ - Implementação de referência
Recursos
- Documentação: https://nextjs.org/docs
- GitHub: https://github.com/vercel/next.js
Versão: 1.1.0 | Atualizado em: 2025-12-27