// the find
Shopify/hydrogen-v1
React-based framework for building dynamic, Shopify-powered custom storefronts.
This is the archived v1 of Shopify's React framework for building headless storefronts against the Storefront API. It used a custom RSC-like server/client component split before Next.js App Router existed. It is in maintenance mode — the current version lives at Shopify/hydrogen.
The .server.jsx / .client.jsx file convention was a pragmatic early answer to server/client boundaries before React's own RSC stabilized. The examples directory covers real production concerns (multipass auth, i18n, Partytown for GTM offloading) not just hello-world cases. The docs/decisions ADRs are unusually honest about why choices were made and then abandoned. The Shopify Storefront API integration is tight — cart, product variants, money formatting, and SEO all have first-class primitives.
This is a dead codebase — the README's first line tells you to go elsewhere. Shopify v2 dropped the custom server/client file naming entirely in favor of Remix, so any patterns learned here don't transfer forward. Node 16.14 minimum is listed in the README; that version hit EOL in 2023. The migration path to v2 is a rewrite, not an upgrade — there is a migrate-v2.md but it's essentially a list of things that no longer exist.