hydrogen Documentation
Shopify Hydrogen 2026-10: a framework-agnostic toolkit for headless Shopify storefronts (not the older Remix-based framework). Covers the core package, React/Vue bindings, request handlers, Oxygen deployment, and the Shopify CLI hydrogen commands.
Documentation Structure
contents/
├── guides/ # Concept guides: getting started, cart, data fetching, routing, markets, deploy, migrate (28 files)
├── api/ # API reference: storefront client, request handling, cart/product/collection/search stores, customer accounts, Shop Pay (41 files)
└── cli/ # Shopify CLI hydrogen commands (26 files)
Topic Guide
| Topic |
Key Files |
| Overview and setup |
contents/guides/index.md, contents/guides/getting-started/index.md, contents/guides/getting-started/add-to-existing-project.md, contents/guides/getting-started/deploy-a-template.md |
| Storefront API client, queries, caching |
contents/guides/data-fetching/index.md, contents/guides/data-fetching/typed-queries.md, contents/api/storefront-client/create-storefront-client.md, contents/api/storefront-client/gql.md |
| Request handlers and routes |
contents/guides/request-handlers.md, contents/guides/routing.md, contents/api/request-handling/handle-shopify-routes.md |
| Cart |
contents/guides/cart/index.md, contents/guides/cart/build-cart.md, contents/api/cart/create-cart-store.md |
| Products, collections, search |
contents/guides/products.md, contents/guides/collections-search.md, contents/api/products/variant-selection.md |
| Customer accounts |
contents/guides/customer-accounts.md, contents/api/customer-accounts/create-customer-account-client.md |
| Markets, analytics, Shop Pay |
contents/guides/markets.md, contents/guides/analytics.md, contents/guides/shop-pay.md |
| Deployment (Oxygen, other runtimes) |
contents/guides/deploy/index.md, contents/guides/deploy/oxygen/index.md, contents/guides/production-checklist.md |
| Migrate from legacy Hydrogen |
contents/guides/migrate.md |
| CLI commands |
contents/cli/index.md, contents/cli/dev.md, contents/cli/deploy.md, contents/cli/setup.md |
When to use
Use this skill when the user asks about:
- Adding Hydrogen to a React Router, Next.js or other framework storefront
- Shopify Storefront API client, cart, products, collections, predictive search, customer accounts
- Deploying to Oxygen or other runtimes, environments, and the production checklist
- Hydrogen CLI commands (dev, build, deploy, setup, codegen)
How to find information
- Use Topic Guide above to identify relevant files
- Read
TOC.md for complete file listing by directory
- Read specific files from
contents/{path}
1---2name: olore-hydrogen-latest3description: Local hydrogen documentation reference (latest, Hydrogen 2026-10). Shopify Hydrogen headless storefront toolkit for React Router, Next.js and other frameworks. Use for Storefront API client and typed gql queries, request handlers and Shopify routes, cart/product/collection/predictive-search stores with React and Vue bindings, customer accounts, markets, caching, analytics, Shop Pay, Oxygen deployment, migration from legacy Hydrogen, and Shopify CLI hydrogen commands.4metadata:5 source: https://skillmd.com/skills/olorehq/olore-hydrogen-latest6---78# hydrogen Documentation910Shopify Hydrogen 2026-10: a framework-agnostic toolkit for headless Shopify storefronts (not the older Remix-based framework). Covers the core package, React/Vue bindings, request handlers, Oxygen deployment, and the Shopify CLI hydrogen commands.1112## Documentation Structure1314```15contents/16├── guides/ # Concept guides: getting started, cart, data fetching, routing, markets, deploy, migrate (28 files)17├── api/ # API reference: storefront client, request handling, cart/product/collection/search stores, customer accounts, Shop Pay (41 files)18└── cli/ # Shopify CLI hydrogen commands (26 files)19```2021## Topic Guide2223| Topic | Key Files |24|-------|-----------|25| Overview and setup | `contents/guides/index.md`, `contents/guides/getting-started/index.md`, `contents/guides/getting-started/add-to-existing-project.md`, `contents/guides/getting-started/deploy-a-template.md` |26| Storefront API client, queries, caching | `contents/guides/data-fetching/index.md`, `contents/guides/data-fetching/typed-queries.md`, `contents/api/storefront-client/create-storefront-client.md`, `contents/api/storefront-client/gql.md` |27| Request handlers and routes | `contents/guides/request-handlers.md`, `contents/guides/routing.md`, `contents/api/request-handling/handle-shopify-routes.md` |28| Cart | `contents/guides/cart/index.md`, `contents/guides/cart/build-cart.md`, `contents/api/cart/create-cart-store.md` |29| Products, collections, search | `contents/guides/products.md`, `contents/guides/collections-search.md`, `contents/api/products/variant-selection.md` |30| Customer accounts | `contents/guides/customer-accounts.md`, `contents/api/customer-accounts/create-customer-account-client.md` |31| Markets, analytics, Shop Pay | `contents/guides/markets.md`, `contents/guides/analytics.md`, `contents/guides/shop-pay.md` |32| Deployment (Oxygen, other runtimes) | `contents/guides/deploy/index.md`, `contents/guides/deploy/oxygen/index.md`, `contents/guides/production-checklist.md` |33| Migrate from legacy Hydrogen | `contents/guides/migrate.md` |34| CLI commands | `contents/cli/index.md`, `contents/cli/dev.md`, `contents/cli/deploy.md`, `contents/cli/setup.md` |3536## When to use3738Use this skill when the user asks about:39- Adding Hydrogen to a React Router, Next.js or other framework storefront40- Shopify Storefront API client, cart, products, collections, predictive search, customer accounts41- Deploying to Oxygen or other runtimes, environments, and the production checklist42- Hydrogen CLI commands (dev, build, deploy, setup, codegen)4344## How to find information45461. Use Topic Guide above to identify relevant files472. Read `TOC.md` for complete file listing by directory483. Read specific files from `contents/{path}`