# Shopify Hydrogen

Shopify's headless toolkit that adds Shopify commerce primitives, such as the cart, product and collection state and a Storefront API client, to a JavaScript framework.


Source: https://findsoftware.frbit.cloud/hydrogen/
Last reviewed: 2026-10-21
Updated: 2026-10-25
Listed since: 2026-10-21

## Record

### Links

- home: https://hydrogen.shopify.dev
- repository: https://github.com/Shopify/hydrogen
- docs: https://shopify.dev/docs/custom-storefronts/hydrogen
- x: https://x.com/shopifydevs
- forum: https://community.shopify.dev/c/hydrogen-and-storefront-apis/9

### Identity

- status: active
- maintainer: Shopify Inc.
- maintainerType: company
- parent: unknown
- firstRelease: 2021
- hqCountry: CA

### Kind

- category: e-commerce, library
- hosting: node
- language: javascript
- runtime: node
- runtimeMin: node 22
- basedOn: unknown

### Content

- contentStore: unknown
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: unknown
- renderingModes: unknown
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: unknown
- latestReleaseDate: 2026-10-20

### Adoption

- githubStargazers: 2153
- packagistDownloads: not applicable
- npmWeeklyDownloads: 42489
- contributors: 139
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 394
- dependentPackages: 37

### Sources

- urls: https://hydrogen.shopify.dev (read 2026-10-21)
- urls: https://github.com/Shopify/hydrogen (read 2026-10-21)
- urls: https://shopify.dev/docs/custom-storefronts/hydrogen (read 2026-10-21)
- firstRelease: https://registry.npmjs.org/@shopify/hydrogen (read 2026-10-21)
- maintainer: https://github.com/Shopify/hydrogen/blob/main/LICENSE.md (read 2026-10-21)
- hqCountry: https://www.shopify.com/legal/terms (read 2026-10-21)
- language: https://github.com/Shopify/hydrogen (read 2026-10-21)
- category: https://hydrogen.shopify.dev (read 2026-10-21)
- category: https://shopify.dev/docs/custom-storefronts/hydrogen (read 2026-10-21)
- runtime: https://shopify.dev/docs/storefronts/hydrogen/deploy (read 2026-10-21)
- runtimeMin: https://shopify.dev/docs/storefronts/hydrogen/getting-started/add-to-existing-project (read 2026-10-21)
- installMethod: https://hydrogen.shopify.dev (read 2026-10-21)
- license: https://registry.npmjs.org/@shopify/hydrogen/latest (read 2026-10-21)
- latestReleaseDate: https://api.github.com/repos/Shopify/hydrogen/releases/latest (read 2026-10-21)
- githubStargazers: https://github.com/Shopify/hydrogen (read 2026-10-21)
- contributors: https://github.com/Shopify/hydrogen (read 2026-10-21)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/point/last-week/@shopify/hydrogen (read 2026-10-21)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40shopify%2Fhydrogen (read 2026-10-25)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40shopify%2Fhydrogen (read 2026-10-25)

## Notes

Shopify Hydrogen is Shopify's toolkit for adding Shopify commerce to a JavaScript framework that a project already uses. It provides a typed Storefront API client with GraphQL queries, cart and product state stores, request handlers for the routes a Shopify storefront needs, Shop Pay, analytics with consent handling and money formatting. The framework keeps routing, rendering and UI, and Hydrogen covers the Shopify-specific parts. The [docs](https://shopify.dev/docs/custom-storefronts/hydrogen) name React Router and Next.js for the two starter templates and list Nuxt, Astro and SvelteKit among the frameworks that work with it.

Oxygen is Shopify's hosting platform for storefronts. The deploy guide also lists Vercel, Cloudflare Workers and Node servers as places a storefront can run, and the framework decides which of them apply.

## Worth knowing

Hydrogen connects to the Storefront API and the Customer Account API. Checkout stays on Shopify, and the toolkit ships no component library, so the interface is the storefront's own.

The docs cover one Hydrogen release line. Storefronts built on earlier releases follow a separate legacy guide and a migration page.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0