finds.dev

Shopify/hydrogen-v1

React-based framework for building dynamic, Shopify-powered custom storefronts.

View on GitHubHomepage ↗

★ 3,724TypeScriptMITupdated Mar 2025

// the take

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.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
3,724
Forks
313
Language
TypeScript
License
MIT
Last commit
19 Mar 2025

// nearby

If hydrogen-v1 isn't quite it.

All repos →