0 Fork 0

Files

T

tanshu de0553d0d4 Wayfinder: chart the Shopify headless commerce map

The route from "mozimo.in displays Shopify products" to "mozimo.in sells them",
as a plan with a phase spine and gates, plus the open decision tickets that
still shape it and the evidence they rest on.

- .scratch/shopify-headless-commerce/: plan.md (phases and gates), map.md (the
  wayfinder map), 10 open decision tickets
- CONTEXT.md: Storefront / Theme store / Cart / Parity vocabulary
- docs/adr/0001-0003: Checkout stays Shopify-hosted, one Variant per product,
  the checkout domain stays shop.mozimo.in
- docs/research/ and docs/shopify-catalog-inventory.md: verified store facts,
  the Cart API probe, and the catalogue inventory

Raw Shopify doc scrapes under .scratch/shopify-research/ are ignored: they are
working material, not record.

2026-10-14 09:00:42 +05:30

1.6 KiB

Raw Permalink Blame History

Mozimo Commerce

The commerce domain for mozimo.in: a headless Storefront reading from Shopify, migrating off a classic Shopify theme store.

Language

Surfaces

Storefront: The headless commerce application in this repository, serving mozimo.in. Avoid: Site, website, app

Theme store: The classic Shopify theme storefront at shop.mozimo.in, retained only until the Storefront reaches Parity. Avoid: Old site, live shop, Shopify site

Checkout: The Shopify-hosted checkout a buyer is handed off to when they finish with their Cart. It is never rendered by the Storefront. Avoid: Our checkout, custom checkout, payment page

Catalog

Shopify catalog: The products held in the Shopify store: the commerce truth for what can be bought, at what price, and whether it is available. Avoid: Product database, real catalog

Editorial catalog: The hand-curated product data in src/data/catalog.ts, used to place products into merchandising slots on the Storefront. Not commerce truth. Avoid: Catalog, products file

Variant: A product's purchasable unit, identified by a Shopify variant ID. Every product in the Shopify catalog currently has exactly one Variant, and sizes are modelled as separate products rather than as options. Avoid: SKU, option, size

Commerce

Cart: The Shopify cart object holding a buyer's intended purchase, identified by a Shopify cart ID. The header's "Bag" label refers to the Cart. Avoid: Bag, basket, trolley

Parity: The set of commercial capabilities the Storefront must have before the Theme store can be retired. Avoid: Feature complete, launch-ready