スキル

vinext で Vite 上に、Workers 向け Next.js を走らせる

公式の create で Vite 上に Next.js を走らせ、Cloudflare Workers 向けにする。まだあらゆる本番アプリの即挿即用代替にはできない。

公式ソース · cloudflare/vinext

インストール

pnpm create vinext-app@latest my-app

誰向けか

この技能は、すでに Next.js を書いていて Vite へ移り、Cloudflare Workers を主な配備先にしたい人に合う。公式はこう書く:Vite 上で Next.js アプリを走らせ、最初の着地環境は Cloudflare Workers。本機にサンプルディレクトリを作り、公式作成コマンドがディスクへ書くことを受け入れられる人にも合う。

原文は Claude Code、OpenCode、Cursor、Codex、および他の多くの AI コーディングツールと併用できるとも書く。これは見本の一覧であり、この四種だけと読んではならない。静的ページだけ、または配備先がそもそも Workers でないなら、説明を読むだけに留める。

現網の本番アプリを「入れ替えれば走ると」扱うのにも合わない。公式は明確だ:今日、相当の重みのある Next.js アプリをかなり支えられるが、あらゆるアプリや本番負荷の即挿即用代替ではまだない。公式リポジトリは https://github.com/cloudflare/vinext そのページにすでに書かれたコマンドで操作する。

3分で最初の試みを終える

公式が書いた新規案件の経路だけを歩く。

前提:本機で pnpm を実行でき、いまのディレクトリに新規フォルダを作ってよく、ローカル初期化を一度はっきり同意している。先に確認する:下のコマンドは my-app という新ディレクトリを作る。まだディスクへ書きたくないなら実行しない。

インストール位置:新しい案件を置くディレクトリで端末を開き、上記の副作用を確認してから実行する:

pnpm create vinext-app@latest my-app

低リスク照合:ディレクトリが出たら、案件説明と設定を読み取り専用で見る。配備しない。現網リポジトリも変えない。既存の Next.js 案件を開いているなら、原文の次の文は、対応ツールで migrate this project to vinext と言うことだ。最初の試みでは「その文が何を変えるかを復唱する」までで止め、ツールにファイルを直接変えさせない。

成功の合図:いまのディレクトリに my-app があり、vinext で作った Next.js-on-Vite 案件だと分かること。コマンドが失敗したら、出ていないインストーラを足さない。公式ページへ戻り原文を照合する。

使用事例

事例一:ゼロから、Cloudflare Workers 向けの Vite 版 Next.js 案件を作る。公式コマンドは pnpm create vinext-app@latest my-app。先に検査可能なローカルディレクトリを持ち、開発を続けるか決める人に合う。着手前に同名フォルダがないことを確認する。原文がインストール省略や配備先変更の方法を書いていなければ、そのようなスイッチがあると仮定しない。

事例二:既存の Next.js 案件を vinext へ移すか評価する。原文は、対応ツールのいずれかでその案件を開き、migrate this project to vinext と言うと書く。最初は、ツールに変更予定のファイルを列挙させ、確認してから書き込みを許す。原文に、移行が覆うルート、データ取得、ミドルウェアの一覧はない。よって「公式の口令で評価を始める」までであり、書いていない互換表を補完しない。

使用の境界

公式の主経路は pnpm create vinext-app@latest my-app。出ていないインストーラを主経路に書かない。配備側の原文は Cloudflare Workers を最初の目標と書くだけで、名指しされていない基盤へそのまま押せることは証明していない。

能力の境界ははっきりしている:今日、相当の重みのある Next.js アプリをかなり支えられるが、あらゆるアプリや本番負荷の即挿即用代替ではまだない。現網の無改変切替を約束するために使わない。

ツール一覧は Claude Code、OpenCode、Cursor、Codex、および他の多くの AI コーディングツールであり、見本であって閉じた名簿ではない。移行の口令は原文に一句だけ。秘密、環境変数、本番公開手順は原文が展開していない。補わない。公式ページは https://github.com/cloudflare/vinext ツールが勧めるコマンドが当該ページと食い違うなら、当該ページを正とする。