Theme Builder

Sellers customize the live storefront in the dashboard. Developers who need full control should read the Themes tab and the Theme Development section under Store Setup.

Two modes

Mode	Who	What
Visual Builder	Sellers	Sections, copy, hero image, layout — Vite themes
Code	Developers	Full file tree, ZIP import — Vite or Nunjucks

Custom theme authors: start at Build a Custom Theme.

Seller flow

Open Themes / Visual Builder for the active store
Edit sections (hero, products, features, …)
Preview in the device frame (real iframe + theme assets)
Publish → new storefront revision goes live

Developer entry points

Goal	Doc
Show products on homepage	Homepage
Tags / shortcodes / embed buy	Shortcodes & Tags
Nunjucks context & filters	Nunjucks Theme API
React / Vite template	Vite Storefront
File layout	Template Structure

Seller session APIs (dashboard)

These require an authenticated seller session — not for public themes:

Area	Notes
Builder / pages	Visual document + page CRUD
Themes	`/api/themes`, apply/use under store
Media	Uploads for hero/product images
Packs	Theme pack import
Storefront config	Active engine / revision

Public themes use subdomain catalog + checkout APIs only.

Publish rules

Vite build → artifacts + StorefrontArtifact rows
Live HTML from published revision
Assets under /markt-theme-assets/live/{revision}/
Preview must use a real iframe URL + dist files — never flatten React to a static HTML snapshot
CSP must allow the dashboard origin to embed the preview

Repo references: docs/STOREFRONT-ARCHITECTURE.md, docs/PRODUCTION-WORKFLOW.md.

⌘I