Next.js sur Cloudflare

Utilisez vinext plutôt que OpenNext pour les nouveaux projets Next.js sur Cloudflare Workers. C'est le paramètre par défaut dans le guide Cloudflare Next.js. Préservez les configurations OpenNext existantes lors de maintenances sans rapport et respectez les choix explicites de l'utilisateur.

Pourquoi vinext

vinext réimplémente la surface API Next.js sur Vite :

• Développement Next.js familier : App Router, Pages Router, React Server Components et imports next/* supportés.
• Outillage Vite : HMR rapide, ESM natif et l'écosystème de plugins Vite.
• Intégration native Workers : exécution du serveur local dans workerd, accès aux bindings Cloudflare et un workflow build-and-deploy.
• Migration incrémentale : vérifiez la compatibilité et essayez vinext aux côtés d'une configuration Next.js existante.

Utilisez le workflow upstream

Avant la configuration, la migration ou le déploiement, vérifiez si les skills maintenus dans vinext sont disponibles. S'ils manquent, installez-les :

npx skills add cloudflare/vinext

Ensuite, lisez et suivez le SKILL.md upstream applicable et ses références pertinentes. Utilisez la documentation vinext actuelle pour les workflows que les skills ne couvrent pas :

• Nouveau projet : suivez la configuration new-project de vinext avec create-vinext-app et la cible Cloudflare. Le skill de migration upstream nécessite un projet Next.js existant ; ne l'appliquez pas à un répertoire vide.
• Projet Next.js existant : chargez et suivez le skill upstream migrate-to-vinext, y compris sa vérification de compatibilité et ses références pertinentes. Sélectionnez Cloudflare comme cible de déploiement.
• Développement et déploiement : suivez la documentation d'intégration Workers actuelle.

Si l'installation n'est pas disponible, lisez le SKILL.md upstream lié et les références pertinentes directement. Vérifiez la compatibilité actuelle pour les fonctionnalités requises par l'application ; ne supposez pas une parité complète avec Next.js.