📚 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 Remix, Shopify’s full stack web framework, but it also provides a React library portable to other supporting frameworks.
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 16.14.0 or higher
npm
(or your package manager of choice, such as yarn
or pnpm
)
-
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.
Versioning
Hydrogen and hydrogen-react are tied to specific versions of the Shopify Storefront API, which follows calver.
For example, if you're using Storefront API version 2023-01
, then Hydrogen and hydrogen-react versions 2022.1.x
are fully compatible.
If the Storefront API version update includes breaking changes, then Hydrogen and hydrogen-react may also include breaking changes. Because the API version is updated every three months, breaking changes could occur every three months.
Learn more about API release schedules at Shopify.
Contributing to Hydrogen
Read our contributing guide
Other handy links
Learn more about Hydrogen.