Com vinext, correr Next.js no Vite rumo a Workers

Para quem serve

Esta competência serve a quem já escreve Next.js, quer passar ao Vite e tomar Cloudflare Workers como destino principal de implantação. Oficialmente: correr uma app Next.js no Vite, primeiro aterramento Cloudflare Workers. Serve também a quem vai criar um diretório de exemplo nesta máquina e aceita que o comando create oficial escreve no disco.

O texto de origem também diz que pode ir com Claude Code, OpenCode, Cursor, Codex e muitas outras ferramentas de código IA. É uma lista de exemplo, não suporte só dessas quatro. Se só faz uma página estática, ou o destino não é Workers, fique na leitura.

Tampouco serve tratar uma app de produção em direto como «troca e corre». Oficialmente claro: hoje consegue sustentar bastantes apps Next.js de peso, mas ainda não é um substituto plug-and-play de cada app ou carga de produção. O repositório oficial é https://github.com/cloudflare/vinext Opere com comandos já escritos nessa página.

Concluir a primeira tentativa em 3 minutos

Siga só o caminho de projeto novo que o oficial escreve.

Pré-requisito: esta máquina consegue executar pnpm, o diretório atual pode criar uma pasta, e aceita com clareza um init local. Confirme primeiro: o comando abaixo criará um diretório novo chamado my-app. Se ainda não quiser escrever no disco, não o execute.

Local de instalação: abra um terminal no diretório do projeto novo, confirme os efeitos secundários e depois:

pnpm create vinext-app@latest my-app

Verificação de baixo risco: quando o diretório aparecer, veja só as notas e a config. Não implante nem mude um repositório em direto. Se abriu um projeto Next.js existente, a frase seguinte do texto de origem é dizer migrate this project to vinext numa ferramenta suportada; na primeira tentativa, pare em restabelecer o que essa frase mudaria — não deixe ainda a ferramenta alterar ficheiros.

Sinal de sucesso: aparece my-app no diretório atual e vê-se um projeto Next.js-on-Vite feito pelo vinext. Se o comando falhar, não acrescente um instalador que não apareceu; volte à página oficial e confronte o texto.

Casos de uso

Caso 1: do zero, montar um projeto Next.js no Vite virado a Cloudflare Workers. O comando oficial é pnpm create vinext-app@latest my-app. Serve a quem quer primeiro um diretório local inspecionável e depois decidir se continua. Antes de agir, confirme que não há uma pasta com o mesmo nome. Se o texto de origem não escrever como saltar a instalação ou mudar o destino, não assuma esse interruptor.

Caso 2: avaliar se um projeto Next.js existente deve passar ao vinext. O texto de origem diz: abrir esse projeto em qualquer ferramenta suportada e dizer migrate this project to vinext. Na primeira vez, faça listar os ficheiros que mudaria e só permita escrever após confirmar. O texto de origem não dá a lista de rotas, obtenção de dados ou middleware cobertos; só chega a «arrancar a avaliação com a frase oficial» e não complete uma tabela de compatibilidade não escrita.

Limites de uso

O caminho principal oficial é pnpm create vinext-app@latest my-app. Não escreva um instalador não aparecido no caminho principal. No lado da implantação, o texto de origem só escreve Cloudflare Workers como primeiro destino; não prova que possa empurrar tal qual para uma plataforma sem nome.

O limite de capacidade está claro: hoje consegue sustentar bastantes apps Next.js de peso, mas ainda não é um substituto plug-and-play de cada app ou carga de produção. Não o use para prometer um corte a zero alterações de um sítio em direto.

A lista de ferramentas é Claude Code, OpenCode, Cursor, Codex e muitas outras ferramentas de código IA — um exemplo, não uma lista fechada. Só uma frase de migração está escrita. Segredos, variáveis de ambiente e passos de publicação em produção não são desenvolvidos; não os complete. A página oficial é https://github.com/cloudflare/vinext Se uma ferramenta sugerir um comando em desacordo com essa página, essa página manda.