Next.js auf Cloudflare
Verwenden Sie vinext anstelle von OpenNext für neue Next.js-Projekte auf Cloudflare Workers. Dies ist die Standardeinstellung im Cloudflare Next.js-Leitfaden. Behalten Sie bestehende OpenNext-Setups während nicht zusammenhängender Wartungsarbeiten bei und respektieren Sie explizite Benutzerentscheidungen.
Warum vinext
vinext implementiert die Next.js-API-Oberfläche auf Vite neu:
- Vertraute Next.js-Entwicklung: App Router, Pages Router, React Server Components und unterstützte
next/*-Importe. - Vite-Tooling: schnelles HMR, natives ESM und das Vite-Plugin-Ökosystem.
- Native Workers-Integration: lokale Serverausführung in workerd, Zugriff auf Cloudflare-Bindungen und ein Build-and-Deploy-Workflow.
- Inkrementelle Migration: Prüfen Sie die Kompatibilität und testen Sie vinext parallel zu einem bestehenden Next.js-Setup.
Verwenden Sie den Upstream-Workflow
Überprüfen Sie vor der Einrichtung, Migration oder Bereitstellung, ob die in vinext gepflegten Skills verfügbar sind. Falls nicht vorhanden, installieren Sie sie:
npx skills add cloudflare/vinext
Lesen und befolgen Sie dann die entsprechende upstream SKILL.md und ihre relevanten Referenzen. Verwenden Sie die aktuellen vinext-Dokumentationen für Workflows, die von den Skills nicht abgedeckt werden:
- Neues Projekt: Befolgen Sie die Einrichtung eines neuen Projekts von vinext mit
create-vinext-appund dem Cloudflare-Ziel. Der upstream-Migrationsskill erfordert ein bestehendes Next.js-Projekt; wenden Sie ihn nicht auf ein leeres Verzeichnis an. - Bestehendes Next.js-Projekt: Laden Sie den upstream
migrate-to-vinextSkill und befolgen Sie ihn, einschließlich seiner Kompatibilitätsprüfung und relevanten Referenzen. Wählen Sie Cloudflare als Bereitstellungsziel. - Entwicklung und Bereitstellung: Befolgen Sie die aktuellen Workers-Integrationsdokumentationen.
Falls die Installation nicht verfügbar ist, lesen Sie die verlinkte upstream SKILL.md und die relevanten Referenzen direkt. Überprüfen Sie die aktuelle Kompatibilität für die erforderlichen Funktionen der Anwendung; gehen Sie nicht von vollständiger Next.js-Gleichheit aus.