Skip to main content
Each store can run a visual theme (Vite / template pipeline) edited from the dashboard builder and published as storefront artifacts.

​
Mental model

  1. Edit theme files and settings in the Visual Builder
  2. Preview uses a real storefront preview URL (iframe) with built assets — not a flattened HTML snapshot
  3. Publish writes artifacts served to live traffic on the subdomain / custom domain

​
What themes can do

  • Layout and styling for catalog, product, cart, and content pages
  • Nunjucks-powered templates where enabled
  • Seller theme CSS variables for brand color on the storefront
See the engineering handbook in the main repo (docs/STOREFRONT-ARCHITECTURE.md, docs/NUNJUCKS-THEME-API.md) for deep template APIs.

​
Builder overlays

Dialogs inside the builder (History, Search, Versions) must sit above the builder chrome (z-index conventions in the repo). If an overlay “doesn’t open”, check stacking — not missing features.

​
CSP / embed

Preview iframes require frame-ancestors to allow the dashboard origin. Publishing does not change that requirement for the builder preview session.