ドキュメント |ディスカッション |変更履歴
Hydrogen は、Shopify のヘッドレス コマース用スタックです。動的でパフォーマンスの高いコマース アプリケーションを構築するためのツール、ユーティリティ、およびクラス最高のサンプルのセットを提供します。 Hydrogen は、Shopify のフルスタック Web フレームワークである Remix と連携するように設計されていますが、他のサポート フレームワークに移植可能な React ライブラリも提供します。
Hydrogen レガシー v1 は別のリポジトリに移動されており、ドキュメントはここにあります。
要件:
npm
(または、 yarn
やpnpm
などの選択したパッケージ マネージャー)最新バージョンの Hydrogen をインストールします。
npm create @shopify/hydrogen@latest
ローカル開発サーバーを実行します。
npm install
npm run dev
http://localhost:3000 で実行されている新しい Hydrogen アプリを開きます。
完全な Hydrogen ドキュメントを参照してください。
Hydrogen はモノリポジトリとして構成されており、一緒に使用できる複数のパッケージが含まれています。
パッケージ | 最新バージョン | 説明 | お読みください |
---|---|---|---|
@shopify/hydrogen | Remix を使用してコマース アプリケーションを構築するための独自のツール、ユーティリティ、およびクラス最高のサンプル。 | お読みください | |
@shopify/hydrogen-react | Shopify 固有のコマース コンポーネント、フック、ユーティリティの、オプションのない高性能ライブラリです。 | お読みください | |
@shopify/cli-hydrogen | Shopify CLI の水素拡張機能。 | お読みください | |
@shopify/create-hydrogen | コマンドラインから新しい Hydrogen プロジェクトを生成します。 | お読みください | |
@shopify/hydrogen-codegen | Storefront API クエリのタイプを自動的に生成します。 | お読みください | |
@shopify/remix-oxygen | Hydrogen を Oxygen ランタイム上で実行できるようにする Remix アダプター。 | お読みください | |
@shopify/mini-oxygen | Oxygen 実稼働環境をシミュレートする Hydrogen アプリのローカル ランタイム。 | お読みください |
Hydrogen と Hydrogen-react は、calver に続く Shopify Storefront API の特定のバージョンに関連付けられています。
たとえば、Storefront API バージョン2023-01
を使用している場合、Hydrogen および Hydrogen-react バージョン2022.1.x
完全な互換性があります。
Storefront API バージョンの更新に重大な変更が含まれる場合、Hydrogen および Hydrogen-react にも重大な変更が含まれる可能性があります。 API バージョンは 3 か月ごとに更新されるため、重大な変更が 3 か月ごとに発生する可能性があります。
API リリース スケジュールの詳細については、Shopify をご覧ください。
貢献ガイドを読む
水素について詳しく学びましょう。