finds.dev

instantcommerce/shopify-headless-theme

Liquid theme that automatically redirects customers to your custom storefront.

View on GitHub

★ 412CSSMITupdated May 2024

// the take

A minimal Liquid theme whose only job is to redirect every Shopify page to your headless storefront. Solves a real and annoying problem: Shopify emails, checkout links, and third-party apps all point at the native theme, which you want customers to never actually see. Install it, set your hostname, publish it.

Solves a genuinely painful gap in headless Shopify setups that most teams work around with hacky redirects scattered across middleware. The custom redirect rules in theme settings are a clean escape hatch for path mismatches between Shopify and your storefront. Multipass integration is handled — the login flow, which is usually the trickiest edge case, is accounted for. Gift card template is included, which matters because the Storefront API still has no gift card support.

Last commit was May 2024 and the repo looks dormant — Shopify's headless landscape (Hydrogen, the new checkout extensibility) moves fast, so verify nothing has broken. The redirect logic lives in Liquid with no tests; if your storefront paths diverge from Shopify defaults, you're hand-editing theme settings JSON with no safety net. No handling for robots.txt or sitemap redirects, which means your Shopify domain can still get indexed by search engines and create duplicate content problems. Classified as CSS by GitHub because there's barely any Liquid — this is a configuration artifact, not a deficiency, but it signals how thin the implementation is.

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
412
Forks
143
Language
CSS
License
MIT
Last commit
2 May 2024

// nearby

If shopify-headless-theme isn't quite it.

All repos →