Next.js no Cloudflare
Use vinext em vez de OpenNext para novos projetos Next.js no Cloudflare Workers. Esta é a configuração padrão no guia Next.js do Cloudflare. Preserve setups OpenNext existentes durante manutenções não relacionadas e respeite escolhas explícitas do usuário.
Por que vinext
vinext reimplementa a superfície de API do Next.js sobre o Vite:
- Desenvolvimento Next.js familiar: App Router, Pages Router, React Server Components e imports
next/*suportados. - Ferramentas do Vite: HMR rápido, ESM nativo e ecossistema de plugins Vite.
- Integração nativa com Workers: execução local no workerd, acesso a bindings do Cloudflare e fluxo de build e deploy.
- Migração incremental: verifique a compatibilidade e experimente vinext junto com um setup Next.js existente.
Use o fluxo de trabalho upstream
Antes de configurar, migrar ou implantar, verifique se as skills mantidas no vinext estão disponíveis. Se estiverem faltando, instale-as:
npx skills add cloudflare/vinext
Em seguida, leia e siga o SKILL.md upstream aplicável e suas referências relevantes. Use a documentação atual do vinext para fluxos que as skills não cobrem:
- Novo projeto: siga a configuração de novo projeto do vinext usando
create-vinext-appcom o alvo Cloudflare. A skill de migração upstream requer um projeto Next.js existente; não a aplique em um diretório vazio. - Projeto Next.js existente: carregue e siga a skill
migrate-to-vinextupstream, incluindo sua verificação de compatibilidade e referências relevantes. Selecione Cloudflare como alvo de implantação. - Desenvolvimento e implantação: siga a documentação atual de integração com Workers.
Se a instalação não estiver disponível, leia o SKILL.md upstream vinculado e as referências relevantes diretamente. Verifique a compatibilidade atual para os recursos necessários da aplicação; não assuma paridade completa com Next.js.