Install
pnpm create vinext-app@latest my-appPara quién es
Esta habilidad encaja con quien ya escribe Next.js, quiere pasar a Vite y tomar Cloudflare Workers como destino principal de despliegue. Oficialmente: correr una app Next.js sobre Vite, primer aterrizaje Cloudflare Workers. También encaja con quien va a crear un directorio de ejemplo en esta máquina y acepta que el comando create oficial escribe a disco.
El texto de origen también dice que puede ir con Claude Code, OpenCode, Cursor, Codex y muchas otras herramientas de código IA. Es una lista de ejemplo, no soporte solo de esas cuatro. Si solo haces una página estática, o el destino no es Workers, quédate en la lectura.
Tampoco encaja tratar una app de producción en vivo como «se cambia y corre». Oficialmente claro: hoy puede sostener bastantes apps Next.js de peso, pero aún no es un sustituto plug-and-play de cada app o carga de producción. El repositorio oficial es https://github.com/cloudflare/vinext Opera con comandos ya escritos en esa página.
Completar el primer intento en 3 minutos
Sigue solo el camino de proyecto nuevo que escribe lo oficial.
Requisito: esta máquina puede ejecutar pnpm, el directorio actual puede crear una carpeta, y aceptas con claridad un init local. Confirma primero: el comando de abajo creará un directorio nuevo llamado my-app. Si aún no quieres escribir a disco, no lo ejecutes.
Ubicación de instalación: abre una terminal en el directorio del proyecto nuevo, confirma los efectos secundarios y luego:
pnpm create vinext-app@latest my-app
Comprobación de bajo riesgo: cuando aparezca el directorio, mira solo las notas y la config. No despliegues ni cambies un repositorio en vivo. Si abriste un proyecto Next.js existente, la frase siguiente del texto de origen es decir migrate this project to vinext en una herramienta admitida; en el primer intento, detente en restablecer qué cambiaría esa frase — no dejes aún que la herramienta cambie archivos.
Señal de éxito: aparece my-app en el directorio actual y se ve un proyecto Next.js-on-Vite hecho por vinext. Si el comando falla, no añadas un instalador que no apareció; vuelve a la página oficial y contrasta el texto.
Casos de uso
Caso 1: desde cero, montar un proyecto Next.js sobre Vite orientado a Cloudflare Workers. El comando oficial es pnpm create vinext-app@latest my-app. Encaja con quien quiere primero un directorio local comprobable y luego decidir si sigue. Antes de actuar, confirma que no hay una carpeta del mismo nombre. Si el texto de origen no escribe cómo saltar la instalación o cambiar el destino, no asumas ese interruptor.
Caso 2: evaluar si un proyecto Next.js existente debe pasar a vinext. El texto de origen dice: abrir ese proyecto en cualquier herramienta admitida y decir migrate this project to vinext. La primera vez, haz que liste los archivos que cambiaría y permite escribir solo tras confirmar. El texto de origen no da la lista de rutas, obtención de datos o middleware cubiertos; solo llegas a «arrancar la evaluación con la frase oficial» y no completes una tabla de compatibilidad no escrita.
Límites de uso
El camino principal oficial es pnpm create vinext-app@latest my-app. No escribas un instalador no aparecido en el camino principal. En despliegue, el texto de origen solo escribe Cloudflare Workers como primer destino; no prueba que puedas empujar tal cual a una plataforma sin nombre.
El límite de capacidad está claro: hoy puede sostener bastantes apps Next.js de peso, pero aún no es un sustituto plug-and-play de cada app o carga de producción. No lo uses para prometer un corte a cero cambios de un sitio en vivo.
La lista de herramientas es Claude Code, OpenCode, Cursor, Codex y muchas otras herramientas de código IA: un ejemplo, no una lista cerrada. Solo una frase de migración está escrita. Secretos, variables de entorno y pasos de publicación en producción no se desarrollan; no los completes. La página oficial es https://github.com/cloudflare/vinext Si una herramienta sugiere un comando que discrepa de esa página, esa página manda.