finds.dev

basementstudio/commerce-toolkit

Ship better storefronts 🛍

View on GitHub

★ 289TypeScriptMITupdated Sep 2025

// the take

A monorepo of three focused packages for building Shopify storefronts: cart state management hooks (on top of react-query), a CLI code generator that wraps Genql for type-safe GraphQL SDKs, and a countdown/drop reveal utility. Built by basement.studio and battle-tested on high-traffic creator merch stores.

- The sdk-gen approach using Genql avoids the graphql package as a runtime dependency, which matters for bundle size in storefront contexts where every KB counts.

- createStorefrontHooks is genuinely well-designed—you bring your own fetchers/mutators, so it works with any backend, not just Shopify. The factory pattern keeps the API clean without magic.

- The drop package is a niche but real need: countdown-gated reveals are common for limited merch drops and there's nothing obvious to reach for otherwise. SSR hydration caveats are documented honestly.

- Working Next.js + Shopify examples with committed generated output means you can see exactly what you're getting before running any code.

- Last meaningful activity looks sparse and the packages are pinned to react-query v4, which is two major versions behind. Adopters on TanStack Query v5 will hit breaking API differences immediately.

- The sdk-gen CLI is essentially a thin wrapper around Genql's existing CLI—it adds minimal abstraction and could easily be replaced by using Genql directly, leaving this package with a weak reason to exist long-term.

- No support for server-side cart operations (e.g., React Server Components, server actions), which is increasingly the default pattern in Next.js App Router projects. The whole hooks model is client-only.

- 289 stars and 11 forks after what appears to be 2+ years suggests limited community traction; if you hit an edge case or bug, you're mostly on your own or submitting a PR yourself.

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
289
Forks
11
Language
TypeScript
License
MIT
Last commit
24 Sep 2025

// nearby

If commerce-toolkit isn't quite it.

All repos →