Skip to main content

​
Storefront Themes

Join Markt storefronts are custom themes with a dual runtime: Themes own presentation. Join Markt owns catalog, cart, checkout, delivery, and customer portal.

​
Start here (theme developers)

Everything for themes lives in this Themes tab (sidebar groups below).

​
1. Start here

  1. Build a Custom Theme — end-to-end overview
  2. Theme Builder — Visual Builder for sellers
  3. Template Structure — files and folders

​
2. Pick a runtime

​
3. Build storefront pages

  1. Products & Catalog — groups, prices, on-hold
  2. Homepage & Sections — products on /
  3. Policy & Legal Pages — privacy / terms / refunds
  4. Embed Checkout — buy buttons on external sites

​
Mental model (vs Shopify Liquid)

There is no Liquid parser. Do not copy Shopify tag names.

​
Contracts themes must honor

  • Routes: /, /products, /product/:slug, policies
  • Catalog: public storefront payload / Nunjucks context — never dashboard session APIs
  • Checkout: platform /checkout/{orderId} (or embed modal)
  • Assets: published under /markt-theme-assets/live/{revision}/…
  • Preview: real iframe URL + dist files — not flattened React HTML snapshots

​
Publish flow

  1. Edit in Visual Builder (Vite) or Code / ZIP (Nunjucks)
  2. Publish builds artifacts
  3. Live store serves the revisioned theme
  4. Rollback = previous revision when available

​
Next