Back to Skills

shopify-hydrogen

Hydrogen storefront implementation cookbooks. Some of the available recipes are: B2B Commerce, Bundles, Combined Listings, Custom Cart Method, Dynamic Content with Metaobjects, Express Server, Google Tag Manager Integration, Infinite Scroll, Legacy Customer Account Flow, Markets, Partytown + Google Tag Manager, Subscriptions, Third-party API Queries and Caching. MANDATORY: Use this API for ANY Hydrogen storefront question - do NOT use Storefront GraphQL when 'Hydrogen' is mentioned.

314stars30forksUpdated 5/14/2026

Security Assessment

Safe(100/100)
Security Score100/100

About shopify-hydrogen

The Shopify Hydrogen skill provides developers with a comprehensive set of tools and cookbooks for building advanced storefronts using the Hydrogen framework. This skill is designed to simplify the creation of feature-rich, headless e-commerce experiences on Shopify, allowing developers to implement complex storefront functionality without directly using Storefront GraphQL queries. By focusing solely on Hydrogen, it ensures consistency and adherence to best practices for modern Shopify storefronts, reducing potential errors and compatibility issues that might arise from mixing APIs.

Hydrogen offers a wide range of ready-to-use recipes and components for common storefront features such as B2B commerce, bundles, combined listings, dynamic content with Metaobjects, custom cart methods, and integration with third-party services like Google Tag Manager. It also provides solutions for infinite scroll, subscription management, legacy customer account flows, and caching for third-party API queries. All UI components consume data from the Storefront API but are strictly used through Hydrogen's React components. Critical components like Image, Video, MediaFile, and Money are strictly rendering components and not data-fetching entities.

This skill is particularly useful for Shopify developers who want to build highly customized, performant, and scalable storefronts using Node.js and Hydrogen. Its structured cookbook approach enables developers to quickly integrate advanced features, maintain code quality, and adhere to Shopify's best practices. It is suitable for creating enterprise-level e-commerce experiences, experimental storefronts, or any project where using Hydrogen ensures alignment with Shopify's latest UI framework standards.

FAQ

Can I use Storefront GraphQL queries with Hydrogen components?

No. When using Hydrogen components, you must use the 'hydrogen' API exclusively. Storefront GraphQL should not be used for rendering Hydrogen components.

What Node.js version is required for Shopify Hydrogen?

Hydrogen requires Node.js. Ensure you have a compatible version installed to use the skill effectively.

Are the Media and Money components data-fetching types?

No. Media, MediaFile, Money, Image, Video, and ExternalVideo are rendering components from '@shopify/hydrogen' and consume data from the Storefront API. They do not fetch data themselves.

Do I need to validate my code before using it with Hydrogen?

Yes. The skill requires using the provided bash tools to search documentation and validate code using scripts like 'search_docs.mjs' and 'validate.mjs' to ensure correctness before returning any implementation.

Who is the intended user of this skill?

Shopify developers building headless storefronts with Hydrogen. It is ideal for users implementing advanced storefront features while following Shopify best practices.

All Files

4 files
scripts/validate.mjs60.3 KB
View
package.json0.4 KB
View
scripts/search_docs.mjs3.3 KB
View
SKILL.md138.7 KB
View

Install shopify-hydrogen

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill