Headless
Shopify Hydrogen in 2026: framework-agnostic core, explained
Spring '26 moved Hydrogen's commerce logic out of React Router into a framework-agnostic core with agent skills. What changed, why, and whether Hydrogen is still React.
Bas Lefeber
Founder, learnshopify.dev · June 19, 2026 · 6 min read
Shopify's Spring '26 Edition for developers shipped a developer preview of a rebuilt Hydrogen, and it is the kind of change that resets a lot of assumptions. The headline: the commerce logic that used to live inside React Router now lives in a framework-agnostic core you can call from any JavaScript framework. Hydrogen is being repositioned from a framework you adopt wholesale into a toolkit you reach into. If you have been searching whether Hydrogen is still React or whether your existing storefront is obsolete, this post is the orientation.
The short version
Hydrogen used to be a React Router (Remix-lineage) framework with commerce baked in. The new preview splits that apart: a plain-JavaScript core of Shopify storefront primitives (cart, product, collection, money, Shop Pay, analytics), thin per-framework bindings (React ships first), and agent skills that teach a coding agent how to scaffold the storefront. It runs anywhere you can call fetch. It is an early developer preview, not GA, so prototype against it and keep production on stable surfaces.
What Hydrogen was
Until this release, Hydrogen was Shopify's React-based headless commerce framework. It was built on Remix, the framework from the creators of React Router, with server-side rendering, nested routes, and optimistic UI. Commerce concerns (the cart, the Storefront API client, money formatting, analytics) were woven into that React Router app. You got a fast, opinionated stack, deployable to Shopify's Oxygen hosting, as long as you were building in React.
That coupling was also the ceiling. If your team builds in Svelte, Vue, or Astro, Hydrogen was not for you. You could still hit the Storefront API directly from any framework, but you gave up the cart logic, the Shop Pay handling, the analytics, and the rest that made Hydrogen worth using. The commerce primitives and the React framework came as a single package.
What changed in Spring '26
The preview pulls the commerce logic out of React Router and into a standalone core. The official update describes the new Hydrogen as a toolkit, not a framework: a framework-agnostic core of Shopify storefront primitives, thin bindings for the framework you are using, and agent skills that teach your coding agent how to wire it together. Three layers instead of one monolith.
- The core is plain JavaScript. It ships cart, product, and collection primitives, money formatting, Shop Pay, a typed Storefront API client, and first-party analytics with consent handling. Because it is framework-neutral, the docs note it works with Next.js, React Router, SvelteKit, Astro, SolidStart, or Nuxt.
- Bindings are thin and per-framework. React bindings ship in the preview; other frameworks use the core primitives directly while their bindings are built out. The binding is the small adapter layer, the commerce logic is no longer tied to it.
- Agent skills ship with the package. These are skills a coding agent (in editors like Claude Code, VS Code, or Cursor) uses to scaffold a storefront for you, guiding it through wiring up each part. Shopify is treating storefront scaffolding as a machine-executable capability rather than human boilerplate.
- It deploys anywhere you can call fetch. The update lists Oxygen, Vercel, Cloudflare Workers, Node, or Deno. Server-driven cart and request handlers work before client-side JavaScript loads, with optimistic UI layered on top.
Is Hydrogen still React?
React is now the first supported binding, not the only one. If you build in React you get a familiar experience with bindings ready today. If you build in something else, you call the framework-agnostic core directly. So: React is still fully supported, but Hydrogen is no longer React-exclusive.
Why Shopify did this
Two forces. The first is flexibility. Tying commerce primitives to one React framework excluded every team standardized on a different stack. Moving the logic into a plain-JavaScript core means the cart, Shop Pay, and analytics are reusable from wherever you render, and Shopify maintains one core instead of re-implementing commerce per framework.
The second is agents. A framework-agnostic core with documented primitives is something a coding agent can compose reliably. The shipped skills exist so an agent can scaffold a storefront, picking the right primitive and wiring it correctly, rather than guessing at a large opinionated framework. This is the same pattern across the Spring '26 developer story: build platform surfaces that both humans and agents can drive. We unpacked the rest of that release in our Spring '26 Edition for developers breakdown.
What it means for you
The decision that matters has not changed: where should the commerce logic live? Hydrogen being more flexible widens the headless option, it does not make headless the default answer. For most stores, a Liquid theme on the Online Store is still the right call, faster to ship, cheaper to maintain, and it inherits the storefront, checkout, and app ecosystem for free.
- Stay on a Liquid theme when the storefront is the product surface, you want the app ecosystem and theme editor, and the team's leverage is in merchandising and conversion. This is most stores, and it is not a compromise.
- Reach for headless / Hydrogen when you need a custom front end Liquid cannot express, a non-Shopify content or design system in the driver's seat, or multiple front ends sharing one commerce backend. The Spring '26 core makes this reachable from frameworks beyond React.
- Consider an app or a Function when the logic is backend behavior (custom discounts, validation, fulfillment rules) rather than presentation. That belongs in a Shopify Function or app, not the storefront layer, regardless of whether the front end is Liquid or Hydrogen.
If you maintain an existing React-based Hydrogen storefront, nothing breaks today: this is a preview alongside the current stack, not a forced migration. The skill that ages well is not memorizing the new API surface, it is the judgment to decide which layer a piece of logic belongs in. That judgment is exactly what we argue for in learning Shopify development in the AI era.
Learn this properly · free lesson
App vs theme vs Function: which tool for which job
The Hydrogen rebuild is a flexibility change, not a decision-maker. The real skill is knowing where commerce logic belongs: theme, app, Function, or headless. This interactive lesson walks you through the call on real scenarios, with a reviewer checking your reasoning. Free to try.
Try this lesson — freeWhat to watch before you commit
It is a developer preview, not GA
Shopify is explicit that the API will change, more framework bindings are still coming, and capabilities like customer accounts and predictive search are on the roadmap, not shipped. There is no published version number yet. Prototype against the preview and give feedback, but do not migrate a production storefront onto it on day one. Keep production on stable surfaces until it reaches general availability.
Treat this as a direction signal more than a tool to deploy this week. The signal is clear: Shopify wants commerce primitives that are framework-neutral and agent-composable. Read the official Hydrogen developer preview update and the changelog entry for the current state, and check the Hydrogen docs before building anything you intend to ship.
Frequently asked questions
Is Hydrogen still React in 2026?
React is still fully supported and is the first binding to ship in the Spring '26 developer preview, but Hydrogen is no longer React-only. The commerce logic now lives in a framework-agnostic JavaScript core that the official docs say works with Next.js, React Router, SvelteKit, Astro, SolidStart, or Nuxt. React teams get ready-made bindings; other frameworks call the core primitives directly.
What changed in Shopify Hydrogen in the Spring '26 Edition?
Shopify moved Hydrogen's commerce logic out of React Router into a standalone, framework-agnostic core. The new Hydrogen is described as a toolkit rather than a framework: a plain-JavaScript core of storefront primitives (cart, product, collection, money, Shop Pay, analytics), thin per-framework bindings, and agent skills that coding agents use to scaffold a storefront. It is an early developer preview, not a general-availability release.
Should I rebuild my Shopify store on the new Hydrogen?
Not yet, and for most stores not at all. The Spring '26 release is an early developer preview where the API can still change and key features are on the roadmap, so it is for prototyping, not production migration. For most merchants a Liquid theme on the Online Store remains the right choice. Reach for headless or Hydrogen only when you need a custom front end Liquid cannot express or multiple front ends sharing one commerce backend.
Hydrogen, Liquid theme, app, or Function: how do I decide?
Match the layer to the work. Presentation that the storefront and app ecosystem can handle belongs in a Liquid theme. A bespoke front end that Liquid cannot express, or several front ends on one backend, points to headless or Hydrogen. Backend behavior like custom discounts, cart validation, or fulfillment rules belongs in a Shopify Function or app, never the storefront layer. The Hydrogen rebuild widens the headless option but does not change this decision.
On the launch list
Get updates on the platform.
Same waitlist as the homepage. New posts plus a heads-up when v1 launches. No drip, no spam.
About the author
Bas Lefeber, Founder, learnshopify.dev
Bas builds learnshopify.dev, where developers learn production-grade Shopify theme development against a live storefront. He writes about Liquid, theme architecture, and the parts of the job that still matter now that AI writes the code.
Keep going in the curriculum
