Deploy de Next.js com Static Export no Cloudflare Pages

Por que Static Export?

O Next.js oferece várias estratégias de deploy, mas o static export (output: "export") é perfeito para sites que não precisam de servidor:

• Zero custo de servidor — HTML estático servido por CDN
• Performance máxima — sem cold starts, sem SSR delay
• Cloudflare Pages grátis — 100k requests/dia no free tier
• Deploy simples — next build gera a pasta out/, upload e pronto

Configuração

// next.config.ts
const nextConfig: NextConfig = {
  output: "export",
  trailingSlash: true,
  images: { unoptimized: true },
};

Limitações

Com static export, você não pode usar:

• Middleware
• API Routes
• Server Actions
• ISR (Incremental Static Regeneration)
• next/image otimizado (precisa unoptimized: true)

Deploy no Cloudflare Pages

# Instalar wrangler
npm install -D wrangler

# Build + deploy
next build && npx wrangler pages deploy out \
  --project-name=meu-site \
  --branch=main

Custom Domain

1. No dashboard do Cloudflare, vá em Pages → seu projeto → Custom domains
2. Adicione seu domínio
3. Configure o CNAME no DNS apontando para seu-projeto.pages.dev

É simples assim. Em menos de 5 minutos, seu site Next.js está no ar com CDN global, SSL automático e zero custo.