Vinextは、CloudflareがMITライセンスで公開しているフレームワークです。Next.jsのAPIをVite 8の上に作り直しており、既存アプリのapp/やpages/、next.configをほぼそのまま使って、Cloudflare WorkersやNode.jsなどVercel以外の基盤で動かせます。2026年9月28日の1.0.0で実験版の扱いを外れ、10月20日に1.3.0が出ました。この記事では1.3.0の公式ドキュメントと、create-next-appの雛形を実際に移行した結果をもとに、OpenNextとの違い、移行とデプロイの手順、版を上げるときに壊れやすい点、採用の判断基準を整理します。
まとめ|Vinext 1.3の正体と既存Next.jsアプリを移す判断の要点
Vinextは、Next.jsのビルド結果を変換する道具ではありません。ルーティング、React Server Components、Server Actions、ミドルウェアといったNext.jsの「API面」を、Viteのプラグインとして書き直したものです。移行はvinext checkで非対応箇所を洗い出し、vinext initで既存のNext.jsスクリプトを残したまま並走させるのが公式の手順です。
判断を先に言うと、Vercel以外へ載せ替えたいApp RouterやPages Routerのアプリで、Cache ComponentsとPartial Prerenderingに依存していなければ採用候補になります。注意したいのは、Next.js 16.4.3のcreate-next-appが作る雛形ではcacheComponents: trueが最初から有効になっている点です。新しく作ったアプリほど、Vinextが最も未完成な領域を使っていることになります。Next.jsとの挙動の一致を最優先するなら、OpenNextを選ぶのが安全です。
Vinextとは|Next.jsのAPIをVite 8上に再実装したCloudflareのフレームワーク
Vinextの中身はViteのプラグイン群です。next devやnext buildの代わりにvite devとvite buildを使い、next/linkやnext/headersなどのimportはVinext側の実装に置き換わります。Vite 8でバンドラがRolldownに移った経緯はVite + Reactの環境構築手順|Viteとは・Vite 8.3の変更点とTypeScript 7対応で整理しています。
フォークでもアダプタでもない作りとReactの扱い
Next.jsのソースを分岐させたフォークではなく、ビルド出力を加工するアダプタでもありません。そのためnext.configのwebpack関数やTurbopackのローダー設定は引き継がれず、Viteのプラグインで置き換えることになります。Reactの扱いも違います。公式の差分ページによると、Next.jsのApp Routerはnextパッケージに同梱したReactで動きますが、Vinextはプロジェクトに入れたreact、react-dom、react-server-dom-webpackを使います。Reactのセキュリティ修正が出たとき、Vinextの新版を待たずに上げられるということです。React 19.3の変更点はReact 19.3の新機能|ViewTransition・Fragment ref・browser()の実装と19.2からの更新手順で解説しています。
2月の実験版から1.3までの版の推移
初出は2026年2月24日のCloudflareブログHow we rebuilt Next.js with AI in one weekで、1人のエンジニアがAIモデルと約1週間で作ったと公表され、当時は「実験的」と明記されていました。7月から9月にかけて14本のベータを経て1.0となり、1.0以降はVinext自身のAPI(プラグインのオプション、キャッシュアダプタ、デプロイのフラグ、initが生成するファイル)をセマンティックバージョニングで管理し、破壊的変更は2.0まで持ち越すと1.0の発表で宣言しています。
| 版 | 公開日 | 主な変更 |
|---|---|---|
| 初出(実験版) | 2026-02-24 | Workers向けに公開 |
| 1.0.0 | 2026-09-28 | 安定API・キャッシュウォーミング |
| 1.1.0 | 2026-10-08 | ビルド・開発サーバーの高速化 |
| 1.2.0 | 2026-10-14 | public配下へのミドルウェア適用 |
| 1.3.0 | 2026-10-20 | JSリクエスト削減・Worker Previews |
公開日はnpm registryの登録日時です。版の推移と全変更点はGitHubのReleasesで追えます。
OpenNextとの違い|ビルド出力の変換とAPI面の再実装
Next.jsをVercel以外で動かす手段として先行していたのが、OpenNextのCloudflareアダプタ(@opennextjs/cloudflare)です。こちらは本物のNext.jsでビルドし、その出力をWorkersで動く形へ変換します。VinextのREADMEも、成熟して検証の進んだ方法が必要ならOpenNextの方が安全だと書いています。
| 観点 | Vinext 1.3 | OpenNext(Cloudflare) |
|---|---|---|
| 方式 | API面をViteで再実装 | Next.jsのビルド出力を変換 |
| ビルドツール | Vite 8(Rolldown) | Next.js本体(Turbopack等) |
| Next.jsの要件 | 不要(型は@vinext/types) | 15.5.28以上16未満か16.4.1以上 |
| Cache Components | 部分対応 | use cacheとPPRを対応機能に掲載 |
| 主な展開先 | Workers、Nitro経由で他基盤 | Cloudflare Workers |
OpenNextの要件は、npmに登録された@opennextjs/cloudflare 1.20.13(2026年10月21日公開)のpeer依存の値です。実務上の違いは「本物のNext.jsを動かすかどうか」に尽きます。Vercelに残すか、Cloudflareへ移すか自体の比較はVercelとCloudflare Pagesの違い:Next.jsの動かし方・料金の増え方・商用条件で選ぶ【2026年10月】で整理しています。
create-next-appの雛形をVinext 1.3へ移した実測結果
2026年10月24日に、create-next-app(Next.js 16.4.3・App Router・TypeScript・Tailwind CSS)で作った雛形にvinext checkとvinext init --platform=nodeを実行し、両方のビルドを比べました。検証環境はmacOS、Intel Core i9-9880H(16スレッド)、Node.js 26.5.0、npm 11.17.0です。
Next.js 16.4.3の雛形はcacheComponentsが最初から有効
生成されたnext.config.tsには、次の設定が最初から書かれていました。next buildのログにも「Cache Components enabled」と「Partial Prefetching enabled」が出ます。
const nextConfig: NextConfig = {
cacheComponents: true,
partialPrefetching: true,
turbopack: {
rules: {
"*.css": { loaders: ["@tailwindcss/turbopack"], as: "*.css" },
},
},
};
Next.js 16系のキャッシュ設計はcacheComponentsを中心に組まれる方向へ進んでおり、その流れはNext.js 16.3とは?Turbopack永続キャッシュとInstant Navigationsなど新機能を実装者目線で解説で解説しました。雛形の段階で有効になっているので、新しいアプリほどVinextの弱い領域に入っています。
vinext checkの判定は88%で部分対応が2件
npx [email protected] checkの結果は「88% compatible(6 supported, 2 partial, 0 issues)」でした。部分対応と判定されたのは次の2つです。
turbopack:resolveAliasとresolveExtensionsは反映され、rules(ローダー)は無視されるcacheComponents:実験的な対応で、挙動は未完成
next/font/google、next/image、tailwindcssは対応と判定されました。0 issuesでも、部分対応の項目が業務の中心にあれば移行は止まります。数字だけで判断せず、partialの中身を読むのが先です。
vinext initが書き換えたファイルと依存
vinext initは、ソースには触れずに次の変更を加えました。
reactとreact-domを19.3.0から^19.3.1へ引き上げ(create-next-appが入れた19.3.0はVinextの要件を満たさない)vinext、react-server-dom-webpack、vite8.3.5、@vitejs/plugin-rsc0.5.38などを追加- package.jsonに
"type": "module"とdev:vinext(ポート3001)、build:vinext、start:vinextを追加 - Turbopackのローダーが使えないため、Tailwind CSS用の
postcss.config.mjsを生成
ビルド時間とクライアントJSのサイズ比較
同じソースを使い、各回の前にNext.jsの.nextまたはVinextのdistを削除して3回ずつビルドした結果です。クライアントJSは、出力された全JSファイルを連結してgzip圧縮した参考値です。個別ファイルの圧縮サイズの合計や、トップページで実際に転送されるJS量とは異なります。
| 項目 | Next.js 16.4.3 | Vinext 1.3.0 |
|---|---|---|
| 本番ビルド(3回) | 11.38・10.98・10.19秒 | 5.61・5.75・5.59秒 |
| クライアントJS(gzip) | 177,455バイト・10ファイル | 150,797バイト・9ファイル |
| ルートの判定 | ○(Static) | ?(Unknown) |
next buildはTypeScriptの型検査(この雛形で約3.4秒)を含み、vite buildは型検査をしないため、差の一部はこれで説明できます。Vinextのビルドがトップページを「Unknown」と表示したのは、ビルド時の静的解析ではheaders()やcookies()の利用を検出できないためだとログに出ていました。vinext startで起動したページは200を返し、Geistフォントは_next/static/_vinext_fonts/配下に自前でホストされていました。
既存のNext.jsアプリをVinextへ移行する手順
公式の移行ガイドは、既存のdevやbuildのスクリプトとソースを残し、*:vinext系のスクリプトを横に足して比べる手順です。評価だけして見送る判断も取りやすくなっています。
Node.js 22.12以上・Vite 8・React ^19.3.1という動作要件
npm registryに登録されたvinext 1.3.0のメタデータでは、enginesがnode >=22、peer依存がvite ^8.0.0、reactとreact-domが^19.3.1です。App Routerのプロジェクトは、1.2.0から@vitejs/plugin-rsc 0.5.37以上が必須になりました。手元の状態は次のコマンドで確かめられます。
node -v # v22.12以上か
npm view [email protected] engines peerDependencies
npm view [email protected] engines
npm ls react react-dom next # 既存アプリの版を確認
vinext checkによる非対応設定とimportの検出
最初にvinext checkを実行します。既知の非対応設定、import、プロジェクト構成のパターンを報告するコマンドで、Vinextが無視するnext.configのオプションも一覧に出ます。
pnpm dlx vinext check
# npmの場合
npx vinext check
checkの結果に加えて、互換性ダッシュボードも確認します。Next.jsのデプロイ用テストスイートを毎晩Vinextに対して回した結果で、2026年10月24日2時18分(UTC)にmainブランチに対して実行された結果(Next.js v16.2.6のテスト・799ファイル)では、対応範囲の合格率が99.6%、全体の合格率が95.9%でした。自分のアプリが使う機能のテストが失敗していないかを見てから次へ進みます。
vinext initによる既存スクリプトの保持と並走環境の追加
vinext initは必要なパッケージを入れ、ESMとViteの設定、選んだ展開先向けのデプロイ設定を作ります。CIや手順書に残すなら、展開先を--platformで明示すると対話なしで再現できます。
pnpm dlx vinext init --platform=cloudflare
# Node.jsサーバーで動かす場合
pnpm dlx vinext init --platform=node
pnpm dev:vinext # Vinext(Vite)で起動
pnpm build:vinext # Vinextで本番ビルド
pnpm dev # 従来のNext.jsで起動
移行ガイドが比較の起点に挙げるのは、認証、ミドルウェア、データ更新、キャッシュ、デプロイ先のバインディングです。トップページの表示より、ログイン後のリダイレクトやServer Actions実行後の再描画が一致するかを見ます。
CSS Modulesの設定を手で直す場面
CSS Modulesがあると、initはvite-css-modulesを入れて設定を書き換えます。既存のVite設定が関数やスプレッド、CommonJSで組まれているとinitは止まるので、移行ガイドの例どおりpatchCssModules({ exportMode: "default" })をvinext()より前に置き、クラス名の規則をcss.modules.generateScopedNameで指定します。
Cloudflare Workersへのデプロイ手順と設定
Vinextのネイティブな展開先はCloudflare Workersです。Vercel、Netlify、AWS Amplify、Deno Deployなど他の基盤へは、Nitroのプリセット(例:NITRO_PRESET=vercel npx vite build)経由で出力します。Nitroの仕組みはNitroとは?Nuxtを支えるサーバーエンジンの仕組みとv3移行の判断軸を解説、Workersの料金や無料枠はCloudflare Workersとは?料金・無料枠・Workers Paidの中身と対応言語・使い方で確認できます。
@vinext/cloudflareでのデプロイとステージングの分け方
Cloudflare向けのデプロイ手順では、cf CLIで認証してからデプロイ用のパッケージを実行します。環境を分けるときは--envを付けます。Response Storeを既定のservice-bindingモードで使う場合、初回はpnpm run build:vinext、pnpm run deploy:response-store、pnpm run deploy:vinextの順に実行します。以下はキャッシュWorkerを配備済みの場合、または別Workerの配備が不要な構成でのコマンドです。Response Storeのパッケージや設定を変更した場合も、キャッシュWorkerを再配備します。
pnpm exec cf auth login
pnpm dlx @vinext/cloudflare deploy
pnpm dlx @vinext/cloudflare deploy --env staging
アカウントIDは環境変数CLOUDFLARE_ACCOUNT_IDか、initが作るcloudflare.config.tsのaccountIdで指定します。CIではCLOUDFLARE_API_TOKENを使い、ブラウザでのログインに頼らない構成にします。既存の--previewフラグは--env previewの別名で、次のWorker Previewは作りません。
Worker Previewsによるプルリクエスト単位の動作確認
1.3と同時に出た@vinext/cloudflare 1.2.0で、ビルドしたアプリをWorker Previewとしてアップロードするpreviews deployが加わりました。cloudflare.config.tsとcf CLIが前提です。
npx @vinext/cloudflare previews deploy pr-123
npx @vinext/cloudflare previews deploy pr-123 --mode staging
名前を省くとCIやGitのブランチ名が使われます。Previewではキャッシュウォーミングとバージョンの昇格は行われません。
Server ComponentからD1などのバインディングを読む書き方
Workersで動かす利点の1つは、D1やKV、R2などのバインディングをServer Component、Route Handler、Server Actionから直接読めることです。次の公式例は、cloudflare.config.tsのWorkerのenvにDBという名前のD1バインディングを設定し、postsテーブルを作成済みであることが前提です。
import { env } from "cloudflare:workers";
export default async function Page() {
const posts = await env.DB.prepare("SELECT * FROM posts").all();
return <pre>{JSON.stringify(posts.results)}</pre>;
}
cloudflare:workersをimportしたコードはWorkers専用になるため、Node.jsへ戻す可能性があるならデータ取得の層に閉じ込めておきます。
キャッシュウォーミングとWorkers Response Store
1.0で加わった--warm-cacheは、新しいバージョンをトラフィック0%でアップロードし、キャッシュできるページをそのバージョン経由で取得してから昇格させる機能です。本番のバインディングで描画されるため、D1やR2を読むページも事前に温められます。温めに失敗するとデプロイは止まり、現行版が残ります。
npx @vinext/cloudflare deploy --warm-cache
キャッシュの保存先には、1.0で加わったWorkers Response Storeがあります。エッジのWorkers Cache、全レスポンスを持続保存するR2、メタデータとタグを管理するSQLiteのDurable Objectを組み合わせたもので、initでキャッシュを有効にしたときの既定です。1.1からはrevalidateTag()がページを消さずに古い扱いにし、Next.jsと同じく古い版を返しながら裏で作り直します。
public配下のファイルにミドルウェアを効かせるrunWorkerFirst
Next.jsのミドルウェアはpublic/のファイルにも効きますが、Workersでは静的アセットがWorkerより先に配信されるため、ミドルウェアが通りません。1.2以降のinitは、ハッシュ付きのビルド出力以外をWorker経由にする設定を生成します。
assets: {
htmlHandling: "none",
notFoundHandling: "none",
runWorkerFirst: ["/*", "!/_next/static/*", "!/*/_next/static/*"],
},
1.2より前に作った設定や手書きの設定は自動で変わりません。runWorkerFirst: trueにするとビルド出力まで404になるため、2つの除外は残します。認証が必要なファイルは、ミドルウェアだけに頼らずRoute Handlerで配る方が確実です。
1.1から1.3へ上げるときに壊れやすい変更点
1.0以降のAPIは互換を保つ方針ですが、Next.jsとの挙動を合わせる修正で手元の設定が通らなくなることがあります。1.3の発表が更新時の確認点に挙げるのは次の3つです。
不正なredirects・rewrites・headersによる設定読み込みエラー
1.3から、redirects、rewrites、headersのsourceはNext.js 16と同じpath-to-regexpで解釈されます。以前は実行時に読み飛ばしていた不正なルールが、設定の読み込み時点でエラーになります。headers()のsourceを/api/*のようなglobで書いていると、1.3では起動もビルドもできません。
クライアントJS・CSSのファイル名のハッシュ化
1.3のクライアントJSは_next/static/chunks/[hash].js、CSSは_next/static/css/[hash].cssになりました。以前はコンポーネント名がファイル名に入り、consent-banner.tsxのチャンクが広告ブロックの一覧に遮断される事例がありました。ファイル名に依存する監視やCDNの設定があれば、build.rolldownOptions.outputで名前を指定し直します。
クライアントコンポーネントのルート単位のまとめ
App Routerの本番ビルドは、同じルート群から使われるクライアントコンポーネントを1つのチャンクにまとめるようになりました。発表では、大規模なコンテンツサイトの試作で1ページあたりのJSリクエストが82本から25本に減っています。従来の分割に戻す場合はvinext({ disableNextLikeChunking: true })を指定します。なお1.2では、@vitejs/plugin-rscが0.5.37未満だとApp Routerのプロジェクトがエラーで止まるようになりました。Server Actionの暗号化した値を別のActionへ流用される問題への対策です。
Next.jsとの差分で移行が詰まりやすい箇所
GitHubのREADMEと差分ページから、影響が大きい順に並べます。
Cache ComponentsとPartial Prerenderingが未完成という最大の制約
最も重い差分は、Cache Components('use cache'ディレクティブ)とPartial Prerenderingが部分対応にとどまる点です。READMEは、キャッシュプロファイル、タグ、部分的なシェル、レジューム、プリフェッチなどがNext.jsと一致しない場合があると明記しています。実測で見たとおりcreate-next-appの雛形はcacheComponentsを有効にしているため、移行前に'use cache'の使用箇所を数えておく必要があります。
静的生成の判定がリクエスト時に決まる差
この節はCache Componentsを無効にした構成の話です。Vinextは、描画が動的かどうかをリクエストの描画中に判定します。Next.jsでは上位のレイアウトのgenerateStaticParamsで静的扱いになるルートも、Vinextでは毎回描画されます(dynamic = "force-static"か"error"を明示したルートを除く)。最後の動的セグメントにgenerateStaticParamsを置けば、空配列を返すだけでも両方で静的になります。Next.jsで静的に配られていたページが、移行後にサーバー描画へ変わっていないかを確かめてください。
next/imageとnext/fontのビルド時最適化が未完成
差分ページは、ビルド時の画像とフォントの最適化がNext.jsのパイプラインを完全には再現していないとしています。1.3.0のvinext checkは、next/font/googleをフォールバック指標付きで自前ホストし、オプションを静的に解析できないときや取得に失敗したときだけGoogle FontsのCDNへ切り替えると表示しました。READMEの対応表には「実行時にCDNから読み込む」と古い説明が残っているため、実際の出力で確かめるのが確実です。リモート画像は幅と高さの指定があれば@unpic/react経由で扱われます。表示速度を厳しく追うサイトでは、移行前後でLCPやCLSを測り直します。
runtimeとpreferredRegionが効かない仕様とネイティブモジュール
Next.jsのルート設定runtimeやpreferredRegionは、Vinextでは実行場所を決めません。決めるのは選んだデプロイアダプタです。ただしcacheComponentsを使わない構成では、runtime = "edge"のページはNext.jsと同じくISRの対象外になります。また、App Routerの開発時にはsharp、resvg、satori、lightningcss、@napi-rs/canvasが失敗する場合があるとREADMEにあります。OG画像をnext/ogで作っているなら、検証の最初に確かめる項目です。READMEが対象外とするのは@vercel/ogのEdge Runtime、Vercel Analytics、Vercel KV・Blob・PostgresなどVercel固有の機能です。
Vinextを採用する条件と見送るべき場面|受託開発の判断基準
Vinextは「Next.jsの上位互換」ではなく、「Next.jsのAPIでVercel以外を選ぶための選択肢」です。この前提で条件を切ります。
Vercel以外へ載せ替えたい既存アプリなら採用候補
採用候補になるのは、vinext checkのpartialが業務の中心に当たらず、'use cache'とPartial Prerenderingを使っておらず、ホスティング費用やリージョン要件でVercelから離れたい理由がある場合です。Vercelの料金構造はVercel料金プラン|Hobby無料枠とPro($20)の中身・超過単価【2026年10月】で整理しています。ビルド速度の公式の数字は、33ルートのApp RouterアプリでNext.js(Turbopack)と同じCIで比べた本番ビルドが、1.1の前の約17%速い状態から約27%速くなったと1.1の発表にあります。一方で開発サーバーの起動は約11%遅いままです。
Cache Components前提の設計とWorkers Freeプランは見送り
見送るべき場面は3つあります。1つ目は、Cache Componentsを前提に設計したアプリです。Vinextで最も未完成な領域であり、移行するとキャッシュ設計を組み直すことになります。2つ目は、Cloudflare WorkersのFreeプランで本番を回す計画です。Workersの制限ページでは、FreeプランのCPU時間はHTTPリクエストあたり10ミリ秒で、サーバーサイドレンダリングは一般に10〜20ミリ秒を使うとされています。1.0の発表はFreeプランへのデプロイにも触れていますが、SSR主体のアプリならPaidプラン(既定30秒・最大5分)を前提に見積もるべきです。
3つ目は、Next.jsとの挙動差を検証する工数を割けない案件です。対応範囲の合格率が99%台でも、全体では95.9%で、残りが自分の業務フローに当たらない保証はありません。既存のNext.jsアプリを別の基盤へ移すなら、並走期間の検証項目と切り戻し手順まで含めて計画します。現行システムの移行計画づくりから相談したい場合は、一創のシステムマイグレーション・リプレイスで、互換性の診断から段階移行の設計まで対応します。
Vinextの使い方とNext.jsからの移行に関するよくある質問
VinextはNext.jsのフォークですか?
フォークではありません。Next.jsのAPIをViteのプラグインとして別に実装したもので、既存のapp/やpages/、next.configは読めますが、webpackやTurbopackのローダー設定は引き継がれません。
VinextとOpenNextはどちらを選ぶべきですか?
Next.jsとの挙動の一致を最優先するならOpenNext、ビルド速度やViteのプラグイン資産を取りたいならVinextです。分かれ目はCache Componentsへの依存の有無です。
VinextはCloudflare以外にもデプロイできますか?
できます。vinext init --platform=nodeで初期化すればvinext startでNode.jsサーバーとして動き、VercelやNetlifyなどへはNitroのプリセットでビルドします。
移行に失敗したら元のNext.jsに戻せますか?
戻せます。initは既存のスクリプトとソースを残すので、移行前のコミットとの差分を確認し、追加されたスクリプト・依存パッケージ・設定ファイルだけでなく、lockfileや.gitignore、変更・改名された設定ファイルも元の状態へ戻します。initが足した"type": "module"と、引き上げたReactの版も確認してください。
Vinextを本番で使っても大丈夫ですか?
1.0で実験版の扱いは外れ、Cloudflareは高トラフィックの本番で使う顧客がいると説明しています。一方READMEは、すべてのアプリや本番ワークロードの置き換えにはまだならないとしています。互換性ダッシュボードで使う機能を確かめ、主要な業務フローを並走で比べてから本番に入れてください。