nextjs-on-cloudflare

Cloudflare 上の Next.js

Cloudflare Workers 上で新しい Next.js プロジェクトを作成する場合は、OpenNext ではなく vinext を使用してください。 これはCloudflare の Next.js ガイドでのデフォルトです。無関係なメンテナンスでは既存の OpenNext セットアップを維持し、ユーザーから明示的な指定がある場合はそれに従ってください。

vinext を使用する理由

vinext は、Vite 上に Next.js の API サーフェスを再実装しています。

• おなじみの Next.js 開発環境：App Router、Pages Router、React Server Components、およびサポートされている next/* インポート。
• Vite ツール：高速な HMR、ネイティブ ESM、Vite プラグインエコシステム。
• Workers とのネイティブ統合：workerd でのローカルサーバー実行、Cloudflare バインディングへのアクセス、ビルドとデプロイのワークフロー。
• 段階的な移行：互換性を確認し、既存の Next.js セットアップと並行して vinext を試せます。

上流のワークフローを使用する

セットアップ、移行、デプロイの前に、vinext で管理されているスキルが利用可能か確認してください。見つからない場合は、インストールしてください。

npx skills add cloudflare/vinext

次に、該当する上流の SKILL.md と関連するリファレンスを読み、それに従ってください。スキルで扱われていないワークフローには、最新の vinext ドキュメントを使用してください。

• 新規プロジェクト： Cloudflare をターゲットにして create-vinext-app を使用する、vinext の新規プロジェクトのセットアップに従ってください。上流の移行スキルは既存の Next.js プロジェクトが前提です。空のディレクトリには適用しないでください。
• 既存の Next.js プロジェクト： 上流の migrate-to-vinext スキルを読み込み、互換性チェックと関連するリファレンスを含めて、その指示に従ってください。デプロイ先として Cloudflare を選択してください。
• 開発とデプロイ： 最新の Workers 統合ドキュメントに従ってください。

インストールできない場合は、リンク先の上流の SKILL.md と関連するリファレンスを直接読んでください。アプリケーションで必要な機能について、現在の互換性を確認してください。Next.js との完全な互換性があると想定しないでください。