Upgrading

Core Idea

Use o comando next upgrade para atualizar Next.js para a versão latest ou canary; versões anteriores a 16.1.0 exigem um codemod separado.

Key Concepts

• next upgrade: comando nativo (16.1.0+) para atualizar para a última versão estável.
• @next/codemod@canary upgrade latest: método necessário para versões anteriores a 16.1.0.
• Manual upgrade: instalar next@latest react@latest react-dom@latest eslint-config-next@latest diretamente.
• next@canary: instala a versão canary mais recente; use apenas quando já estiver na última versão estável e tudo funcionando.
• Canary features: forbidden, unauthorized, forbidden.js, unauthorized.js, authInterrupts (features de autenticação disponíveis só em canary no momento da doc).

Code Examples

pnpm next upgrade

npx @next/codemod@canary upgrade latest

pnpm i next@latest react@latest react-dom@latest eslint-config-next@latest

• O que demonstra: Três caminhos de upgrade: comando nativo, codemod (versões antigas), e instalação manual de pacotes.

Key Takeaways

1. A partir de 16.1.0, next upgrade é o caminho recomendado; antes disso, use o codemod upgrade latest.
2. Upgrade manual exige atualizar next, react, react-dom e eslint-config-next juntos.
3. Canary é para testar features futuras (ex.: forbidden/unauthorized) antes do lançamento estável.
4. Consulte os guias de versão específicos (16, 15, 14) para instruções detalhadas de migração entre major versions.

Connects To

• Version guides (16, 15, 14): instruções detalhadas para upgrades entre major versions.
• ai-coding-agents (ch022): upgrading também atualiza a documentação bundled usada por agentes de IA.