cloudflare/migrate-to-vinext

Was macht migrate-to-vinext?

Migriert Next.js-Projekte zu vinext (Vite-basierte Next.js-Neuimplementierung). Verwenden bei Anfragen zur Migration, Konvertierung oder Umstellung von Next.js auf vinext. Behandelt Kompatibilitätsscan, Paketersetzung, Vite-Konfigurationserstellung, ESM-Konvertierung und Deployment-Setup (nativ Cloudflare Workers, andere Plattformen via Nitro).

Übersicht

Dieses Skill automatisiert den Migrationsprozess von Next.js zu vinext. Es analysiert das bestehende Projekt, identifiziert Inkompatibilitäten und generiert die notwendigen Konfigurationsdateien.

Verwendung

Stelle eine Anfrage wie:

"Migriere mein Next.js-Projekt zu vinext" "Konvertiere dieses Projekt zu vinext" "Wechsle von Next.js zu vinext"

Ablauf

1. Kompatibilitätsscan – Überprüft, ob das Projekt mit vinext kompatibel ist (z. B. Next.js Version, Abhängigkeiten).
2. Paketersetzung – Ersetzt Next.js-spezifische Pakete durch vinext-Äquivalente.
3. Vite-Konfiguration generieren – Erstellt eine vite.config.ts für vinext.
4. ESM-Konvertierung – Konvertiert CommonJS (CJS) zu ES Modules (ESM), falls erforderlich.
5. Deployment-Setup – Richtet Deployment-Konfiguration für Cloudflare Workers (nativ) oder andere Plattformen via Nitro ein.

Voraussetzungen

• Node.js 18+
• Ein bestehendes Next.js-Projekt (Version 12 oder neuer)
• npm, yarn, pnpm oder bun als Paketmanager

Beispiel

# Nach der Migration (vom Skill durchgeführt):
cd mein-projekt
npm install
npm run dev

Unterstützte Plattformen

• Cloudflare Workers – natives Deployment
• Andere Plattformen – via Nitro (z. B. Node.js, AWS Lambda, Vercel)

Bekannte Einschränkungen

• Einige Next.js-spezifische Features (z. B. getServerSideProps) erfordern manuelle Anpassungen.
• Middleware aus Next.js wird möglicherweise nicht automatisch übertragen.

Weiterführende Links

• vinext Dokumentation
• Cloudflare Workers Dokumentation
• Nitro Dokumentation