
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.
hydrogen.shopify.devrepositorydocs
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 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.
Identity
Rendering and deploy
- Install with
- npm1
Releases
- Last release
- 2026-10-2010
Adoption
Sources
- 2026-10-21: links, Categories, Install with
hydrogen.shopify.dev - 2026-10-21: links, Written in, GitHub stars, Contributors
github.com/Shopify/hydrogen - 2026-10-21: links, Categories
shopify.dev/docs/custom-storefronts/hydrogen - 2026-10-21: First release
registry.npmjs.org/@shopify/hydrogen - 2026-10-21: Maintainer
github.com/Shopify/hydrogen/blob/main/LICENSE.md - 2026-10-21: Headquarters
www.shopify.com/legal/terms - 2026-10-21: Runtime
shopify.dev/docs/storefronts/hydrogen/deploy - 2026-10-21: Minimum runtime
shopify.dev/docs/storefronts/hydrogen/getting-started/add-to-existing-project - 2026-10-21: License
registry.npmjs.org/@shopify/hydrogen/latest - 2026-10-21: Last release
api.github.com/repos/Shopify/hydrogen/releases/latest - 2026-10-21: npm downloads a week
api.npmjs.org/downloads/point/last-week/@shopify/hydrogen - 2026-10-25: Dependent repositories, Dependent packages
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40shopify%2Fhydrogen