Next.js e Turbopack

Next.js 16+ usa o Turbopack por padrão para desenvolvimento local: um bundler incremental escrito em Rust que acelera significativamente o início do desenvolvimento e as atualizações rápidas.

Quando Usar

• Turbopack (dev padrão): Use para o desenvolvimento do dia a dia. Inicialização a frio e HMR mais rápidos, especialmente em aplicações grandes.
• Webpack (dev legado): Use apenas se encontrar um bug no Turbopack ou se depender de um plugin exclusivo do webpack em desenvolvimento. Desative com --webpack (ou --no-turbopack dependendo da sua versão do Next.js; verifique a documentação da sua versão).
• Produção: O comportamento do build de produção (next build) pode usar Turbopack ou webpack dependendo da versão do Next.js; verifique a documentação oficial do Next.js para sua versão.

Use quando: estiver desenvolvendo ou depurando aplicações Next.js 16+, diagnosticando lentidão na inicialização do dev ou HMR, ou otimizando bundles de produção.

Como Funciona

• Turbopack: Bundler incremental para o dev do Next.js. Usa cache do sistema de arquivos para que as reinicializações sejam muito mais rápidas (por exemplo, 5–14x em projetos grandes).
• Padrão em dev: A partir do Next.js 16, next dev é executado com Turbopack, a menos que desativado.
• Cache do sistema de arquivos: Reinicializações reutilizam o trabalho anterior; o cache geralmente fica em .next; nenhuma configuração extra é necessária para uso básico.
• Bundle Analyzer (Next.js 16.1+): Bundle Analyzer experimental para inspecionar a saída e encontrar dependências pesadas; ative via configuração ou flag experimental (veja a documentação do Next.js para sua versão).

Exemplos

Comandos

next dev
next build
next start

Uso

Execute next dev para desenvolvimento local com Turbopack. Use o Bundle Analyzer (veja a documentação do Next.js) para otimizar a divisão de código (code-splitting) e reduzir dependências grandes. Prefira o App Router e componentes de servidor sempre que possível.

Nomenclatura de Arquivos de Middleware

O Next.js 16 introduziu proxy.ts como o nome do arquivo de middleware, substituindo a convenção mais antiga de middleware.ts:

• Next.js 16+: use proxy.ts na raiz do projeto
• Pré-Next.js 16: use middleware.ts na raiz do projeto

A mudança no nome do arquivo está ligada à versão do Next.js, não a qual bundler (Turbopack ou webpack) está em uso. Sempre verifique a documentação oficial para a versão que você está consultando.

Não marque proxy.ts como um arquivo de middleware com nome incorreto ou ausente em projetos Next.js 16. O arquivo está correto e é intencional. Sugerir uma renomeação para middleware.ts quebrará a execução do middleware.

Referência: Documentação de proxy do Next.js

Melhores Práticas

• Mantenha-se em uma versão recente do Next.js 16.x para um comportamento estável do Turbopack e do cache.
• Se o desenvolvimento estiver lento, certifique-se de estar usando o Turbopack (padrão) e que o cache não está sendo limpo desnecessariamente.
• Para problemas de tamanho do bundle de produção, use as ferramentas oficiais de análise de bundle do Next.js para sua versão.