Next.js on Cloudflare は何をしますか？
新しいNext.jsプロジェクトをCloudflare Workers上で開始する場合は、OpenNextではなくvinextを使用してください。 これはCloudflare Next.jsガイドのデフォルトです。既存のOpenNextセットアップは、関連のないメンテナンス中はそのまま維持し、ユーザーの明示的な選択を尊重してください。
Why 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ドキュメントを使用してください:
- 新しいプロジェクト:
create-vinext-appを使用してCloudflareターゲットを指定し、vinextの新規プロジェクトセットアップに従ってください。上流の移行スキルは既存のNext.jsプロジェクトを必要とします。空のディレクトリに適用しないでください。 - 既存のNext.jsプロジェクト: 上流の
migrate-to-vinextスキルとその互換性チェックおよび関連リファレンスを読み、従ってください。デプロイメントターゲットとしてCloudflareを選択してください。 - 開発とデプロイ: 現在のWorkers統合ドキュメントに従ってください。
インストールが利用できない場合は、リンクされた上流の SKILL.md と関連リファレンスを直接読んでください。アプリケーションに必要な機能の現在の互換性を確認してください。完全なNext.js互換性を前提としないでください。