hydrogen

文档 |讨论 |变更日志

Hydrogen 是 Shopify 的无头商务堆栈。它提供了一组用于构建动态和高性能商务应用程序的工具、实用程序和一流的示例。 Hydrogen 的设计目的是与 Shopify 的全栈 Web 框架 Remix 相配合，但它还提供了一个可移植到其他支持框架的 React 库。

氢遗产 v1

Hydrogen Legacy v1 已移至单独的存储库，可以在此处找到文档。

氢入门

要求：

• Node.js 版本 16.14.0 或更高版本
• npm （或您选择的包管理器，例如yarn或pnpm ）

1. 安装最新版本的 Hydrogen：

   npm create @shopify/hydrogen@latest

2. 运行本地开发服务器：

   npm install
   npm run dev

3. 打开在 http://localhost:3000 运行的新 Hydrogen 应用程序。

请参阅完整的氢文档。

此存储库中的包

Hydrogen 被组织为单一存储库，其中包括可以一起使用的多个包。

包裹	最新版本	描述	自述文件
@shopify/hydrogen		使用 Remix 构建商务应用程序的成熟工具、实用程序和一流示例。	自述文件
@shopify/hydrogen-react		无操作且高性能的 Shopify 特定商务组件、挂钩和实用程序库。	自述文件
@shopify/cli-hydrogen		Shopify CLI 的 Hydrogen 扩展。	自述文件
@shopify/create-hydrogen		从命令行生成一个新的 Hydrogen 项目。	自述文件
@shopify/hydrogen-codegen		自动生成 Storefront API 查询的类型。	自述文件
@shopify/remix-oxygen		Remix 适配器使 Hydrogen 能够在 Oxygen 运行时上运行。	自述文件
@shopify/mini-oxygen		模拟氧气生产环境的氢气应用程序的本地运行时。	自述文件

版本控制

Hydrogen 和 Hydrogen-react 与特定版本的 Shopify Storefront API 相关，该版本遵循 calver。

例如，如果您使用 Storefront API 版本2023-01 ，则 Hydrogen 和 Hydrogen-react 版本2022.1.x完全兼容。

如果 Storefront API 版本更新包含重大更改，那么 Hydrogen 和 Hydrogen-react 也可能包含重大更改。由于 API 版本每三个月更新一次，因此每三个月可能会发生重大更改。

详细了解 Shopify 上的 API 发布计划。

为氢做出贡献

阅读我们的贡献指南

其他方便的链接

了解有关氢的更多信息。