Theme authoring

Liquid theme ZIP v2 package, section schema, and submit flow.

Trust model

Staff with platform roles upload theme ZIPs. Merchants install from the published catalog only — shops never upload ZIPs.

Minimum package

theme.zip
  theme.json
  layout/theme.liquid
  templates/index.json
  config/settings_schema.json
  config/settings_data.json
  locales/tr.json
  assets/theme.css
  sections/
  snippets/

`theme.json`

Platform manifest (name, semver, siteTypes, commerce slots). Executable scripts inside the ZIP are rejected.

Sections

Each sections/*.liquid file includes {% schema %}…{% endschema %}. The editor palette is generated from schemas.

First-party examples

See themes/moda, themes/vitrin, themes/kurumsal, themes/magazin in the repo.

Full spec: docs/roadmap/05-liquid-theme-spec.md.