// the find
instantcommerce/shopify-headless-theme
Liquid theme that automatically redirects customers to your custom storefront.
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.