DEV Community

Nathan M
Nathan M

Posted on

Built a headless Shopify starter — looking for architecture feedback

Been working on a React + TypeScript starter for headless Shopify stores. Before I keep building, wanted to get feedback from experienced devs.

What it does

  • Pulls products from Shopify Storefront API
  • Stripe Elements checkout (creates orders via Admin API)
  • Cart with SSR-safe persistence (no hydration errors)
  • Dual mode — Stripe for dev, native Shopify checkout for prod
  • 347 tests, 89% coverage

What I'm unsure about

  • Is my cart context pattern solid or overengineered?
  • Any red flags in the checkout flow?
  • Project structure — anything weird?

Why dual checkout?

Free Shopify dev stores can't process payments. Stripe mode lets you test the full purchase flow. Flip one env var for production and it switches to native Shopify checkout.

Links

Live demo: ecommerce-react-shopify.vercel.app

Repo: github.com/nathanmcmullendev/ecommerce-react

Test card: 4242 4242 4242 4242


Roast it or tell me it's fine. Either helps.

Top comments (0)