Mit vinext Next.js auf Vite für Workers laufen lassen

Für wen es geeignet ist

Diese Fähigkeit passt zu Menschen, die schon Next.js schreiben, auf Vite wechseln und Cloudflare Workers als Hauptziel der Bereitstellung wollen. Offiziell heißt es: eine Next.js-App auf Vite laufen lassen, erstes Landemilieu Cloudflare Workers. Sie passt auch zu Menschen, die auf diesem Rechner ein Beispielverzeichnis anlegen und akzeptieren, dass der offizielle Create-Befehl auf die Platte schreibt.

Der Quelltext sagt auch, es könne mit Claude Code, OpenCode, Cursor, Codex und vielen anderen KI-Coding-Werkzeugen zusammenarbeiten. Das ist eine Beispieliste, kein Support nur für diese vier. Wer nur eine statische Seite macht oder dessen Ziel gar nicht Workers ist, bleibt beim Lesen.

Es passt auch nicht, eine Live-Produktionsanwendung als „tauschen und es läuft“ zu behandeln. Offiziell klar: Heute trägt es etliche gewichtige Next.js-Apps, ist aber noch kein Plug-and-Play-Ersatz für jede App oder Produktionslast. Das offizielle Repository ist https://github.com/cloudflare/vinext Arbeiten Sie mit Befehlen, die auf jener Seite schon stehen.

Ersten Versuch in 3 Minuten abschließen

Gehen Sie nur den offiziell geschriebenen Neu-Projekt-Weg.

Voraussetzung: Dieser Rechner kann pnpm ausführen, das aktuelle Verzeichnis darf einen neuen Ordner anlegen, und Sie stimmen einer lokalen Init klar zu. Zuerst bestätigen: Der folgende Befehl erstellt ein neues Verzeichnis namens my-app. Wollen Sie noch nicht auf die Platte schreiben, nicht ausführen.

Installationsort: Terminal in dem Verzeichnis öffnen, in dem das neue Projekt liegen soll, Nebenwirkungen bestätigen, dann:

pnpm create vinext-app@latest my-app

Risikoarme Prüfung: Nach Erscheinen des Verzeichnisses Projektnotizen und Konfiguration nur lesend ansehen. Nicht bereitstellen, kein Live-Repository ändern. Öffneten Sie ein vorhandenes Next.js-Projekt, ist der nächste Satz des Quelltexts, in einem unterstützten Werkzeug migrate this project to vinext zu sagen. Beim ersten Versuch bei „nur nachsprechen, was dieser Satz ändern würde“ bleiben; das Werkzeug noch keine Dateien ändern lassen.

Erfolgssignal: Im aktuellen Verzeichnis erscheint my-app, und Sie sehen ein von vinext gebautes Next.js-on-Vite-Projekt. Schlägt der Befehl fehl, keinen nie erschienenen Installer nachrüsten; zurück zur offiziellen Seite und den Quelltext prüfen.

Anwendungsfälle

Fall 1: Von Grund auf ein Vite-Next.js-Projekt für Cloudflare Workers bauen. Der offizielle Befehl ist pnpm create vinext-app@latest my-app. Passt zu Menschen, die zuerst ein prüfbares lokales Verzeichnis wollen und dann entscheiden, ob sie weiterentwickeln. Vor dem Handeln bestätigen, dass kein gleichnamiger Ordner da ist. Schreibt der Quelltext nicht, wie man die Installation überspringt oder das Bereitstellungsziel ändert, nehmen Sie einen solchen Schalter nicht an.

Fall 2: Bewerten, ob ein vorhandenes Next.js-Projekt nach vinext soll. Der Quelltext sagt: das Projekt in einem unterstützten Werkzeug öffnen und migrate this project to vinext sagen. Beim ersten Mal das Werkzeug die zu ändernden Dateien auflisten lassen, Schreiben erst nach Bestätigung erlauben. Der Quelltext gibt keine Liste abgedeckter Routen, Datenabrufe oder Middleware; Sie kommen nur bis „Bewertung mit der offiziellen Wendung starten“ und ergänzen keine nie geschriebene Kompatibilitätstabelle.

Nutzungsgrenzen

Der offizielle Hauptweg ist pnpm create vinext-app@latest my-app. Schreiben Sie keinen unerschienenen Installer in den Hauptweg. Zur Bereitstellung schreibt der Quelltext nur Cloudflare Workers als erstes Ziel; er beweist nicht, dass Sie unverändert auf eine ungenannte Plattform schieben können.

Die Fähigkeitsgrenze ist klar: Heute trägt es etliche gewichtige Next.js-Apps, ist aber noch kein Plug-and-Play-Ersatz für jede App oder Produktionslast. Nutzen Sie es nicht, um einen Nulländerungs-Schnitt einer Live-Site zu versprechen.

Die Werkzeugliste ist Claude Code, OpenCode, Cursor, Codex und viele andere KI-Coding-Werkzeuge — ein Beispiel, keine geschlossene Liste. Nur eine Migrationswendung steht im Quelltext. Geheimnisse, Umgebungsvariablen und Produktionsschritte sind nicht entfaltet; nicht ergänzen. Die offizielle Seite ist https://github.com/cloudflare/vinext Weicht ein vom Werkzeug vorgeschlagener Befehl von jener Seite ab, gilt jene Seite.