Avec vinext, faire tourner Next.js sur Vite vers Workers

À qui cela s’adresse

Cette compétence convient à qui écrit déjà Next.js, veut passer à Vite et prendre Cloudflare Workers comme cible de déploiement principale. Officiellement : faire tourner une appli Next.js sur Vite, premier atterrissage Cloudflare Workers. Elle convient aussi à qui s’apprête à créer un répertoire d’exemple sur cette machine et accepte que la commande create officielle écrive sur le disque.

Le texte source dit aussi qu’elle peut aller avec Claude Code, OpenCode, Cursor, Codex et beaucoup d’autres outils de code IA. C’est une liste d’exemples, pas un soutien limité à ces quatre. Si vous ne faites qu’une page statique, ou si la cible n’est pas Workers, restez à la lecture.

Elle ne convient pas non plus à traiter une appli de production en ligne comme « on échange et ça tourne ». Officiellement clair : aujourd’hui elle peut porter pas mal d’applis Next.js consistantes, mais ce n’est pas encore un substitut plug-and-play de chaque appli ou charge de production. Le dépôt officiel est https://github.com/cloudflare/vinext Opérez avec les commandes déjà écrites sur cette page.

Première tentative en 3 minutes

Ne suivez que le chemin de nouveau projet écrit par l’officiel.

Préalable : cette machine peut exécuter pnpm, le répertoire actuel peut créer un dossier, et vous acceptez clairement une init locale. Confirmez d’abord : la commande ci-dessous créera un nouveau répertoire nommé my-app. Si vous ne voulez pas encore écrire sur le disque, ne l’exécutez pas.

Emplacement d’installation : ouvrez un terminal dans le répertoire du nouveau projet, confirmez les effets de bord, puis :

pnpm create vinext-app@latest my-app

Contrôle à faible risque : une fois le répertoire apparu, lisez seulement les notes et la config. Ne déployez pas, ne changez pas un dépôt en ligne. Si vous avez ouvert un projet Next.js existant, la phrase suivante du texte source est de dire migrate this project to vinext dans un outil pris en charge ; à la première tentative, arrêtez-vous à reformuler ce que cette phrase changerait — ne laissez pas encore l’outil modifier des fichiers.

Signal de réussite : my-app apparaît dans le répertoire actuel, et vous voyez un projet Next.js-on-Vite construit par vinext. Si la commande échoue, n’ajoutez pas un installeur absent ; revenez à la page officielle et recoupez le texte.

Cas d’usage

Cas 1 : depuis zéro, monter un projet Next.js sur Vite orienté Cloudflare Workers. La commande officielle est pnpm create vinext-app@latest my-app. Convient à qui veut d’abord un répertoire local inspectable, puis décider de continuer. Avant d’agir, confirmez l’absence d’un dossier du même nom. Si le texte source n’écrit pas comment sauter l’install ou changer la cible, n’en supposez pas l’interrupteur.

Cas 2 : évaluer si un projet Next.js existant doit passer à vinext. Le texte source dit : ouvrir ce projet dans un outil pris en charge et dire migrate this project to vinext. La première fois, faites lister les fichiers à changer, n’autorisez l’écriture qu’après confirmation. Le texte source ne donne pas la liste des routes, fetches ou middlewares couverts ; vous n’allez que jusqu’à « lancer l’évaluation avec la formule officielle » et ne complétez pas une table de compatibilité absente.

Limites d’usage

Le chemin principal officiel est pnpm create vinext-app@latest my-app. N’écrivez pas un installeur absent dans le chemin principal. Côté déploiement, le texte source n’écrit Cloudflare Workers que comme première cible ; il ne prouve pas une poussée telle quelle vers une plateforme non nommée.

La limite de capacité est claire : aujourd’hui elle peut porter pas mal d’applis Next.js consistantes, mais ce n’est pas encore un substitut plug-and-play de chaque appli ou charge de production. Ne l’utilisez pas pour promettre une bascule zéro changement d’un site en ligne.

La liste d’outils est Claude Code, OpenCode, Cursor, Codex et beaucoup d’autres outils de code IA — un exemple, pas une liste fermée. Une seule formule de migration est écrite. Secrets, variables d’environnement et étapes de publication production ne sont pas développés ; ne les complétez pas. La page officielle est https://github.com/cloudflare/vinext Si un outil propose une commande en désaccord avec cette page, cette page prime.