📚 Docs | 🗣 Discord | 💬 Discussions | 📝 Changelog

Hydrogen is a set of tools, utilities, and best-in-class examples for building a commerce application with Remix.

Hydrogen legacy v1, which is not built on Remix, is available here: https://github.com/Shopify/hydrogen-v1

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)

1. Install the latest version of Hydrogen:

   npm create @shopify/hydrogen@latest

2. Run the local development server:

   npm install
   npm run dev

3. 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 Remix.	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/remix-oxygen		Remix adapter enabling Hydrogen to run on the Oxygen runtime.	Readme

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.