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.
Security Assessment
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.
Install shopify-hydrogen
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
shopify/shopify-ai-toolkit