Feature playground
Every Hydrogen feature, running.
This lab explores @shopify/hydrogen@2026.10.3, the framework-agnostic library release, wired into React Router 8. Each section explains a feature, runs it live, shows the code and the exact API, and labels honestly whether it is real Hydrogen behaviour, real Hydrogen over the mock API, something that needs a real store, or a custom storefront feature.
| Section | Feature | Hydrogen API | Status |
|---|---|---|---|
| AStorefront API | GraphQL queries & typed responses | createStorefrontClient, gql, StorefrontApi.ResultOf… | Real HydrogenMock adapter |
| API error handling | StorefrontApiError, StorefrontTimeoutError, result.errors | Real Hydrogen | |
| Store configuration | shop, localization | Real HydrogenMock adapter | |
| BRequest handlers | Shopify route handling | handleShopifyRoutes, handleShopifyRedirects, createCartServerHandlers… | Real HydrogenMock adapter |
| Checkout handling | handleShopifyRoutes (/checkout) | Real HydrogenMock adapterNeeds a store | |
| URL redirects & /admin | handleShopifyRedirects | Real HydrogenNeeds a store | |
| CProduct & collection primitives | Variant selection & product forms | createProductComponents, useProductForm, canAddToCart… | Real HydrogenMock adapter |
| Collection filtering, sorting & pagination | CollectionProvider, useCollection, useCollectionForm… | Real HydrogenMock adapter | |
| DCart | Cart store, mutations & optimistic updates | createCartComponents, useCart, useCartForm… | Real HydrogenMock adapter |
| Server-driven cart & progressive enhancement | createCartServerHandlers, createCartCookie, getCartId | Real Hydrogen | |
| Cart drawer | window.Shopify.actions.openCart.configure | Real Hydrogen | |
| Discounts, gift cards & out-of-band mutations | register('discount-apply'), useCartActions().refresh | Real HydrogenMock adapter | |
| ESearch | Predictive search, search store & autocomplete | PredictiveSearchProvider, usePredictiveSearch, usePredictiveSearchForm… | Real HydrogenMock adapter |
| FCustomer accounts | Authentication, sessions, login & logout | createCustomerSession, createCustomerAccountServerHandlers, WritableCustomerSessionManager | Real HydrogenMock adapterNeeds a store |
| Customer profile & order history | createCustomerAccountClient, gql (customer-account) | Real HydrogenMock adapter | |
| GShopify Markets | Country selector, localized pricing & currency formatting | defineShopifyI18n, createShopifyRequestContext, getLocalizedHref… | Real HydrogenMock adapter |
| Money formatting | formatMoney | Real Hydrogen | |
| HAnalytics & consent | Page, product, cart & checkout events | ShopifyScripts, AnalyticsEvent, useCartAnalytics… | Real Hydrogen |
| Customer privacy consent & consent-gated analytics | ConsentConfig, window.Shopify.customerPrivacy.setTrackingConsent | Real HydrogenMock adapter | |
| IShop Pay | Shop Pay button integration | ShopPayButton, createShopPayButton, renderShopPayButton | Real HydrogenNeeds a store |
| JPerformance | Storefront API caching & cache strategies | Cache, createRunWithCache, createFetchWithCache… | Real HydrogenNeeds a store |
| Server rendering, streaming & loading states | React Router <Await>, Suspense | Real Hydrogen | |
| Image optimization | shopifyImageUrl (app helper) | Real HydrogenCustom feature | |
| KSEO | Meta, canonical URLs & structured data | React Router meta, script:ld+json | Custom featureReal Hydrogen |
| Sitemap & robots | Resource routes | Custom feature | |
| LOxygen | Deployment compatibility & runtime requirements | @shopify/hydrogen/vite, skill: hydrogen-oxygen | Needs a store |
| MAgentic commerce | MCP endpoint, product discovery & cart interaction | handleShopifyRoutes (/api/mcp, /.well-known/ucp), initializeShopifyScripts({ webMcp }) | Mock adapterNeeds a store |
| Agent-assisted shopping flow | MCP tools/call | Custom featureMock adapter |