Quitter Vercel sans renoncer à Next.js avec OpenNext
Votre projet Next.js tourne sur Vercel, la facture monte, et vous aimeriez basculer vers Cloudflare. Mais une peur vous retient : casser quelque chose. Server Components, ISR, Middleware : vous ne savez pas ce qui, dans votre projet, dépend en réalité de l'infrastructure Vercel, ni ce qui survivra à la bascule.
Cette masterclass vous donne la méthode en cinq étapes pour décider si la migration vers OpenNext sur Cloudflare Workers est faisable, et préparer la bascule sans rien casser : le verrou, l'audit de compatibilité, la cartographie du faisable, le calcul de l'économie, le plan d'actions ordonné.
Ce que cet exercice ne peut pas casser
Tout se fait en lecture : vous ne déployez rien, vous ne modifiez aucun fichier, vous ne touchez à aucun compte. Le résultat est un diagnostic et un plan sur une feuille. Au pire, vous découvrez que votre projet n'est pas encore prêt, et c'est précisément ce qu'il fallait savoir.
Ce que vous saurez faire à la fin
- Nommer ce qui, dans votre projet, dépend aujourd'hui de l'infrastructure Vercel.
- Repérer les fichiers incompatibles avec les Workers : accès au disque, modules Node.js bas niveau.
- Classer chaque fonctionnalité en trois colonnes : marche tel quel, s'ajuste, pas encore supporté.
- Produire un plan de bascule ordonné, avec le risque associé à chaque action.
- Niveau membre· le prompt prêt à coller qui audite votre projet, dresse la liste des fichiers à corriger et rend votre plan de bascule d'un coup.
Chaque fonctionnalité de votre projet atterrit dans une des trois colonnes avant la bascule.
Cinq étapes pour basculer sans rien casser
On ne migre pas un projet Next.js sur un coup de tête. Les Workers de Cloudflare n'offrent pas le même terrain que les serveurs de Vercel : un accès au disque qui passait inaperçu, une fonctionnalité non supportée, et la bascule casse en production. La méthode prend le problème dans l'ordre : comprendre ce qui vous retient, auditer ce qui bloque, cartographier ce qui passe, chiffrer ce que vous y gagnez, puis dérouler le plan.
1Le verrou : ce que Vercel tient vraimentdoute : « qu'est-ce que je lâche, qu'est-ce que je garde ? »
Avant de bouger quoi que ce soit, mettez des mots sur la dépendance. Server Components, ISR, Middleware : ces briques s'appuient aujourd'hui sur l'infrastructure Vercel. OpenNext existe précisément pour les faire tourner ailleurs, sur Cloudflare Workers. Listez celles que votre projet utilise : c'est la base de tout le reste.
2L'audit de compatibilitédoute : « qu'est-ce qui va casser ? »
Les Workers ne donnent pas accès au système de fichiers comme un serveur classique. Cherchez dans votre projet tout accès au disque (le module fs, toute lecture ou écriture de fichier) et toute dépendance à un module Node.js bas niveau. Chaque occurrence est un point à corriger avant la bascule. Si une compatibilité reste incertaine, notez-la : on ne devine pas, on vérifie.
3La cartographie du faisabledoute : « est-ce que tout passera ? »
Classez chaque fonctionnalité de votre projet dans une des trois colonnes : marche tel quel, s'ajuste avec une modification, pas encore supporté. Deux cas à signaler en priorité : le draft mode et le Partial Prerendering, qui ne sont pas supportés. Si votre projet en dépend, c'est maintenant qu'il faut le savoir, pas le jour de la bascule.
4Le calcul : ce que la bascule rapportedoute : « est-ce que ça vaut le coup ? »
Prenez votre offre Vercel actuelle et votre trafic approximatif, et estimez l'ordre de grandeur de l'économie sur Cloudflare. Pas de chiffre inventé : si une donnée vous manque, allez la chercher dans votre tableau de bord Vercel. C'est ce calcul qui transforme une envie vague en décision.
5Le plan de basculedoute : « par quoi je commence ? »
Terminez par une liste d'actions ordonnées : ce que vous corrigez avant de migrer, dans quel ordre, et le risque si vous l'ignorez. Ce plan reste ouvert sous vos yeux le jour de la bascule. Le déploiement lui-même se fait ensuite avec le guide pas à pas.
À vous de jouer : votre audit de faisabilité
Ouvrez votre projet et une feuille à côté. Tout se fait en lecture, rien ne se modifie.
Le résultat, en 30 secondes
À partir de votre seule matière (arborescence, fichiers de configuration, dépendances), le prompt rend un diagnostic complet : votre verrou Vercel en clair, un tableau des fichiers à corriger, la cartographie en trois listes, l'estimation de coût et votre plan de bascule numéroté.
Fichier lib/export.ts, zone : écriture sur le disque avec fs. Correction proposée : stocker la sortie ailleurs que sur le disque local. Cartographie : Middleware marche tel quel, les deux accès disque s'ajustent, le draft mode n'est pas encore supporté, à retirer avant la bascule. Plan, action 1 : corriger les accès disque. Risque si ignoré : échec au premier déploiement.
Le prompt prêt à coller
# RÔLE Tu es un ingénieur déploiement spécialiste de Next.js et de Cloudflare Workers, rigoureux et pédagogue. Tu accompagnes un solo non technicien ou semi technicien qui veut quitter Vercel pour OpenNext sur Cloudflare. Tu ne t'appuies QUE sur ce que je te donne. Ce que tu ignores, tu me le demandes au lieu de l'inventer. Si une compatibilité est incertaine, tu le signales clairement plutôt que d'affirmer à tort. # CONTEXTE J'ai un projet Next.js déployé sur Vercel et je veux le migrer vers OpenNext sur Cloudflare Workers, sans rien casser. Tu vas m'aider à décider si c'est faisable et à préparer la bascule. Ma matière (si j'en ai) : [collez ici l'arborescence du projet, vos fichiers de configuration comme package.json et next.config, et tout fichier où vous savez déjà lire ou écrire sur le disque].
Le prompt audite votre projet, dresse la liste des fichiers à corriger et vous rend votre plan de bascule complet. Pas encore de matière ? Il passe en mode interview et vous interroge point par point. Laissez votre email, je vous l'envoie.
Vérifiez que c'est à vous
Votre audit révèle deux choses : votre projet écrit des fichiers sur le disque avec fs, et il utilise le draft mode. Que faites-vous avant de migrer ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
Expliquez en une phrase, à quelqu'un qui hésite à quitter Vercel : pourquoi cartographier le faisable avant de toucher au moindre fichier ? Si vous savez le dire simplement, la méthode est à vous.
Ce que vous savez faire maintenant
- Nommer le verrou : ce qui, dans votre projet, dépend de l'infrastructure Vercel.
- Auditer la compatibilité : accès disque et modules Node.js bas niveau repérés avant qu'ils ne cassent.
- Décider sur des faits : une cartographie en trois colonnes, un calcul d'économie et un plan ordonné.
On ne migre pas pour voir : on cartographie le faisable, on corrige, puis on bascule.
Continuez seul
Le plan en main, la bascule elle-même se fait avec le guide pas à pas :
Déployer son site Next.js sur Cloudflare →