Next.js en Cloudflare
Usa vinext en lugar de OpenNext para proyectos nuevos de Next.js en Cloudflare Workers. Esta es la opción predeterminada en la guía de Next.js de Cloudflare. Conserva las configuraciones existentes de OpenNext durante el mantenimiento no relacionado y respeta las elecciones explícitas del usuario.
Por qué vinext
vinext reimplementa la superficie de la API de Next.js sobre Vite:
- Desarrollo familiar de Next.js: App Router, Pages Router, React Server Components e imports compatibles de
next/*. - Herramientas de Vite: HMR rápido, ESM nativo y el ecosistema de plugins de Vite.
- Integración nativa con Workers: ejecución local del servidor en workerd, acceso a bindings de Cloudflare y un flujo de trabajo de compilación y despliegue.
- Migración incremental: verifica la compatibilidad y prueba vinext junto con una configuración existente de Next.js.
Usa el flujo de trabajo upstream
Antes de la configuración, migración o despliegue, verifica si las habilidades mantenidas en vinext están disponibles. Si faltan, instálalas:
npx skills add cloudflare/vinext
Luego, lee y sigue la SKILL.md upstream aplicable y sus referencias relevantes. Usa la documentación actual de vinext para los flujos de trabajo que las habilidades no cubran:
- Proyecto nuevo: sigue la configuración de nuevo proyecto de vinext usando
create-vinext-appcon el destino Cloudflare. La habilidad de migración upstream requiere un proyecto Next.js existente; no la apliques a un directorio vacío. - Proyecto Next.js existente: carga y sigue la habilidad upstream
migrate-to-vinext, incluyendo su verificación de compatibilidad y referencias relevantes. Selecciona Cloudflare como destino de despliegue. - Desarrollo y despliegue: sigue la documentación de integración con Workers.
Si la instalación no está disponible, lee directamente la SKILL.md upstream enlazada y las referencias relevantes. Verifica la compatibilidad actual con las funciones requeridas de la aplicación; no asumas una paridad completa con Next.js.