// the find
imranhsayed/gatsby-woocommerce-themes
⚡ A Gatsby Theme for WooCommerce E-commerce site Gatsby WooCommerce WordPress
A Gatsby theme that wires a React frontend to a WordPress/WooCommerce backend via wp-graphql, giving you a statically-generated storefront with a headless WordPress CMS. It handles the full e-commerce loop: product listing, cart, checkout, auth, and a customer account area. Aimed at developers who already know WordPress and want a faster frontend without ditching their existing WooCommerce setup.
The cart and wishlist work offline via localStorage, which is a genuine UX win that most WooCommerce themes don't bother with. The dual-client architecture — Gatsby's build-time GraphQL for static pages, Apollo for runtime cart/auth mutations — is the right call; you get fast page loads without losing dynamic checkout. Storybook is included and actually has stories for the header and footer components, making it easier to work on UI in isolation. The yarn workspaces monorepo structure keeps the theme package cleanly separated from the demo site, so using it as an installable npm theme is a real option, not just aspirational.
Last commit was March 2023 and it's built on gatsby-source-wordpress v4 BETA — that beta has since gone through multiple breaking changes and the Gatsby ecosystem itself has stalled badly, so expect broken builds before you write a line of your own code. The WordPress plugin setup requires manually installing seven bundled zip files from the repo, some pinned to specific old versions (WooCommerce 4.4.1, wp-graphql 1.0.0), which will immediately conflict with a current WordPress install. There's no server-side cart or session handling — cart state lives purely in localStorage, which breaks on multi-device use and causes the classic headless WooCommerce problem where inventory isn't validated until checkout. Authentication stores JWT tokens in localStorage, which is the standard insecure pattern; no mention of httpOnly cookies or token refresh strategy.