Hydrogen lets you build faster headless storefronts in less time, on Shopify.
2,124
stars
2,410
commits
TypeScript
primary language
Sep 11, 2026
updated
README
📚 Docs | 💬 Discussions | 📝 Changelog
Hydrogen is Shopify's stack for headless commerce. It provides a set of tools, utilities, and best-in-class examples for building dynamic and performant commerce applications. Hydrogen is designed to dovetail with React Router, the modern multi-strategy router for React, but it also provides a React library portable to other supporting frameworks.
Contributing to Hydrogen
Hydrogen Legacy v1
Hydrogen legacy v1 has been moved to a separate repo and the docs can be found here.
Getting started with Hydrogen
Requirements:
- Node.js version 18.0.0 or higher
npm(or your package manager of choice, such asyarnorpnpm)
-
Install the latest version of Hydrogen:
npm create @shopify/hydrogen@latest -
Run the local development server:
npm install npm run dev -
Open your new Hydrogen app running at http://localhost:3000.
See the complete Hydrogen docs.
Packages in this repo
Hydrogen is organized as a monorepo, which includes multiple packages that can be used together.
| Package | Latest version | Description | Readme |
|---|---|---|---|
@shopify/hydrogen |  | Opinionated tools, utilities, and best-in-class examples for building a commerce application with React Router. | Readme |
@shopify/hydrogen-react |  | Unopionated and performant library of Shopify-specific commerce components, hooks, and utilities. | Readme |
@shopify/cli-hydrogen |  | Hydrogen extension for Shopify CLI. | Readme |
@shopify/create-hydrogen |  | Generate a new Hydrogen project from the command line. | Readme |
@shopify/hydrogen-codegen |  | Generate types for Storefront API and Customer Account API queries automatically. | Readme |
@shopify/mini-oxygen |  | A local runtime for Hydrogen apps that simulates the Oxygen production environment. | Readme |
Versioning
Hydrogen and hydrogen-react are tied to specific versions of the Shopify Storefront API and Customer Account API, which follow calver.
For example, if you're using Storefront API or Customer Account API version 2025-07, then Hydrogen and hydrogen-react versions 2025.7.x are fully compatible.
If the Storefront API or Customer Account API version updates include breaking changes, then Hydrogen and hydrogen-react may also include breaking changes. Because the API versions are updated every three months, breaking changes could occur every three months.
Learn more about API release schedules at Shopify.
Other handy links
Contributors
(top 30 of 130)
Similar repos
Languages
TypeScript
92.0%
JavaScript
4.9%
HTML
1.8%
Hydrogen lets you build faster headless storefronts in less time, on Shopify.
2,124
stars
2,410
commits
TypeScript
primary language
Sep 11, 2026
updated
README
📚 Docs | 💬 Discussions | 📝 Changelog
Hydrogen is Shopify's stack for headless commerce. It provides a set of tools, utilities, and best-in-class examples for building dynamic and performant commerce applications. Hydrogen is designed to dovetail with React Router, the modern multi-strategy router for React, but it also provides a React library portable to other supporting frameworks.
Contributing to Hydrogen
Hydrogen Legacy v1
Hydrogen legacy v1 has been moved to a separate repo and the docs can be found here.
Getting started with Hydrogen
Requirements:
- Node.js version 18.0.0 or higher
npm(or your package manager of choice, such asyarnorpnpm)
-
Install the latest version of Hydrogen:
npm create @shopify/hydrogen@latest -
Run the local development server:
npm install npm run dev -
Open your new Hydrogen app running at http://localhost:3000.
See the complete Hydrogen docs.
Packages in this repo
Hydrogen is organized as a monorepo, which includes multiple packages that can be used together.
| Package | Latest version | Description | Readme |
|---|---|---|---|
@shopify/hydrogen | | Opinionated tools, utilities, and best-in-class examples for building a commerce application with React Router. | Readme |
@shopify/hydrogen-react | | Unopionated and performant library of Shopify-specific commerce components, hooks, and utilities. | Readme |
@shopify/cli-hydrogen | | Hydrogen extension for Shopify CLI. | Readme |
@shopify/create-hydrogen | | Generate a new Hydrogen project from the command line. | Readme |
@shopify/hydrogen-codegen | | Generate types for Storefront API and Customer Account API queries automatically. | Readme |
@shopify/mini-oxygen | | A local runtime for Hydrogen apps that simulates the Oxygen production environment. | Readme |
Versioning
Hydrogen and hydrogen-react are tied to specific versions of the Shopify Storefront API and Customer Account API, which follow calver.
For example, if you're using Storefront API or Customer Account API version 2025-07, then Hydrogen and hydrogen-react versions 2025.7.x are fully compatible.
If the Storefront API or Customer Account API version updates include breaking changes, then Hydrogen and hydrogen-react may also include breaking changes. Because the API versions are updated every three months, breaking changes could occur every three months.
Learn more about API release schedules at Shopify.
Other handy links
Similar repos
Contributors
(top 30 of 130)
Languages
TypeScript
92.0%
JavaScript
4.9%
HTML
1.8%