create-tanqory-theme 0.0.0-stage → 0.2.2

package/templates/nova/README.md

@@ -0,0 +1,150 @@
+# __THEME_TITLE__: a Tanqory theme forked from Nova V3
+
+A Tanqory storefront theme. **Content = a JSON tree** the visual editor edits;
+**the UI = presentational React** that renders it. Everything in this folder is
+something a theme developer edits. The platform code (theme SDK, runtime, ABI data plan, cart,
+live edit, the render/hydrate entries) is the `@tanqory/theme-kit` package, not here.
+
+```bash
+npm run build      # dist/abi: manifest, browser bundle, single-file server entry, defaults, locales
+npm test           # vitest: render cases, contracts, ABI render and hydration
+npm run check      # the platform's checks on dist/abi: security, storefront, budgets (reports/)
+```
+
+Coding agents: read `AGENTS.md` (the same text as `CLAUDE.md`). Node >= 22.6.
+
+## Structure — what to edit
+
+✏️ edit freely · ⚠️ edit with care (persisted ids / contracts) · 🔒 generated — never by hand
+
+```
+theme.config.ts             ⚠️  the theme: its sections (picker order), Provider, Layout, labels
+src/
+  styles/                   ✏️  tokens.css, base.css, NovaProvider, theme-setting → token mapping, strings
+  components/               ✏️  reusable parts, props only (base, commerce, content, forms, navigation,
+                                overlays, states, listing, section = shared section settings)
+  sections/<Name>/          ✏️  one folder per section:
+      <Name>.tsx  <Name>.css      the component (+ its styles when it has its own)
+      schema.ts             ⚠️  its settings — ids and values are persisted, never rename
+      presets.ts            ✏️  what "Add section" offers
+      index.ts              ✏️  defineSection: id, category, zone, the block schemas it accepts (`blocks`),
+                                and data(node, store) → props
+      blocks/               ✏️  blocks only this section accepts
+  sections/data.ts          ✏️  Nova's presentation mapping the data bindings share (which blocks, in what
+                                shape; header over a media hero; what "add" means). Looking a handle up in
+                                the store (imageFor, menuFor, collectionFor …) is @tanqory/theme-kit's
+  layouts/Main.tsx          ✏️  the page layout + page overlays (cart drawer, search, consent, toasts)
+entry.abi.tsx               ⚠️  the ABI server entry: `createRender` (@tanqory/theme-kit/server) + Nova's hooks
+main.abi.tsx                ⚠️  the browser entry: `hydrate` (@tanqory/theme-kit/client)
+lib/bundle.ts               ⚠️  the theme bundle the kit is handed (definition, templates, groups, locales, settings)
+lib/legacy-settings.ts      ⚠️  Nova v1/v2 settings still honoured (menus, brand colour) — passed to the kit as hooks
+lib/abi/abi.css             ✏️  editor-canvas affordances (hover/selection outlines)
+templates/  groups/         ✏️  starter page layouts + shared header/footer (JSON; paths are fixed)
+config/settings.schema.ts   ⚠️  the theme settings the editor offers
+config/settings.json        ✏️  their starter values
+config/promotion-popup.schema.ts ⚠️  the promotion popup's theme settings (contract 13)
+locales/{en,th,ar}.json     ✏️  interface strings
+assets/                     ✏️  static assets · ai-tokens.css 🔒 is written by the platform's AI
+tests/                      ✏️  theme tests (render cases + axe, inert settings, contracts, integrity)
+.tanqory/contracts/         🔒  compiler-managed contract locks (approved ids/labels/presets) + LOCK.json;
+                                never edit — re-lock with `tanqory-theme contracts --design <dir> --write`
+.tanqory/legacy-settings.json
+                            ⚠️  removed settings stores still carry (append-only)
+.tanqory/*.ts               🔒  generated entries (gitignored)
+theme.manifest.json         🔒  generated by `npm run manifest` — the editor, studio-api and the AI read it
+index.html · entry-server.tsx · preview-render.tsx
+                            🔒  generated compatibility files the storefront image builds from the root
+vite.config.ts              🔒  one line: the build is @tanqory/theme-compiler's
+```
+
+## Where do I edit…?
+
+| Want to | Go to |
+| --- | --- |
+| change how a section looks | `src/sections/<Name>/<Name>.tsx` (+ `.css`) |
+| a section's settings | `src/sections/<Name>/schema.ts` — ids are frozen by `.tanqory/contracts/` (compiler-managed; never edit) |
+| a section's blocks | list the name in `schema.ts` `blocks` and the schema in `index.ts` `blocks` — there is no other block list |
+| how saved settings / store data become props, or what a button does | `src/sections/<Name>/index.ts` (`data`, using `useThemeActions` actions) |
+| add a section | a new `src/sections/<Name>/` folder + one line in `theme.config.ts` |
+| a reusable piece (price, card, drawer…) | `src/components/` |
+| tokens / styling | `src/styles/` |
+| arrange a page | `templates/*.json` · `groups/*.json` |
+| site-wide theme settings | `config/settings.json` (schema in `config/settings.schema.ts`) |
+| interface words | `locales/*.json` |
+
+## How it works
+
+- `theme.config.ts` is the theme's single declaration (`defineTheme` from
+  `@tanqory/theme-sdk`). The compiler reads it to build the editor catalog
+  (`theme.manifest.json`); the runtime reads it to render pages.
+- A saved page is a JSON tree. The runtime resolves it (template + shared
+  groups) and renders each node through its section's `data()` binding and
+  component. Components never fetch; actions (add to cart, search…) arrive as
+  props from the binding.
+
+## Catalog
+
+Everything this theme contains is described, machine-readably, in
+[`theme.manifest.json`](./theme.manifest.json) — every section (with its editor
+attributes), every template, and the theme settings. The editor inserter, the AI
+generator, and the dashboard↔storefront conformance test all read it, so it is
+the one place that can never disagree with the code.
+
+The list below is generated from that manifest — **do not edit by hand**; run
+`npm run manifest` (it also refreshes this block).
+
+<!-- BEGIN GENERATED CATALOG -->
+**50 sections (3 in the header / footer zones) · 39 block types · 19 templates · 68 settings**
+
+### Sections by category
+- **commerce** (14): account, cart-items, collection-banner, collection-list, featured-collection, featured-product, main-collection, policy-page, product-details, product-grid, recently-viewed, search-results, store-locator, trust-badges
+- **content** (15): article-body, before-after, blog-posts, collection-links, faq, feature-grid-blocks, feature-highlights, image-gallery, image-with-text, marquee, multicolumn, page-body, rich-text, team-founders, timeline
+- **forms** (1): contact-form
+- **layout** (9): announcement-bar, breadcrumbs, divider, footer, group, header, hero, slideshow, video-hero
+- **marketing** (4): line-add-friend, newsletter, promo-banner, testimonials
+- **product** (1): product-recommendations
+- **social-proof** (1): logo-list
+- **system** (1): not-found
+- **trust** (4): comparison-table, product-reviews, shop-the-look, ugc-gallery
+
+### Blocks (39 types, nested inside sections)
+- accordion, add-to-cart, badge, button, collection-item, column, compare-item, comparison, contact-detail, faq-item, footer-brand, footer-line, footer-menu, footer-text, heading, hotspot, icon, image, jumbo-text, logo, newsletter-signup, payment-icons, person, product-description, product-inventory, product-price, product-sku, product-title, quantity, slide, social-links, spacer, step, swatches, tab, testimonial, text, variant-picker, video
+
+### Shared groups
+- **footer** (footer): footer — used by 19 template(s)
+- **header** (header): header — used by 18 template(s)
+
+### Templates
+| template | header | footer | sections |
+| --- | --- | --- | --- |
+| `404` | ↗ header | ↗ footer | featured-collection, not-found |
+| `account` | ↗ header | ↗ footer | account |
+| `article` | ↗ header | ↗ footer | article-body, breadcrumbs, product-grid |
+| `article.longform` | ↗ header | ↗ footer | article-body |
+| `blog` | ↗ header | ↗ footer | blog-posts, newsletter |
+| `blog.featured` | ↗ header | ↗ footer | blog-posts |
+| `cart` | ↗ header | ↗ footer | cart-items, featured-collection, trust-badges |
+| `collection` | ↗ header | ↗ footer | breadcrumbs, main-collection |
+| `collection.featured` | ↗ header | ↗ footer | collection-banner, main-collection, rich-text |
+| `contact` | ↗ header | ↗ footer | contact-form, faq, rich-text, store-locator |
+| `index` | override | ↗ footer | collection-list, feature-highlights, featured-collection, hero, image-with-text, testimonials |
+| `list-collections` | ↗ header | ↗ footer | collection-list |
+| `page` | ↗ header | ↗ footer | breadcrumbs, page-body |
+| `page.about` | ↗ header | ↗ footer | hero, image-with-text, logo-list, rich-text, timeline |
+| `page.contact` | ↗ header | ↗ footer | contact-form, page-body |
+| `policy` | ↗ header | ↗ footer | breadcrumbs, policy-page |
+| `product` | ↗ header | ↗ footer | breadcrumbs, product-details, product-recommendations, trust-badges |
+| `product.bundle` | ↗ header | ↗ footer | multicolumn, product-details, product-recommendations, trust-badges |
+| `search` | ↗ header | ↗ footer | search-results |
+
+### Theme settings
+- **Brand**: logo, shopName, locale
+- **Colour**: colorPrimary, colorScheme
+- **Typography**: typeScale, headingWeight, buttonTextStyle
+- **Layout**: pageWidth, sectionSpacing
+- **Components**: buttonRadius, buttonBorder, inputRadius, cardRadius, badgeStyle, badgeShape, iconStyle, motion
+- **Header**: enableSpaNavigation
+- **Search**: enableSearchModal
+- **Cart**: enableCartDrawer
+- **Legacy**: accent, accountExtraLinks, accountHeading, accountLoggedIn, accountPrimaryHref, accountPrimaryLabel, accountSecondaryHref, accountSecondaryLabel, accountSubtext, bodyFont, cardBorder, cardHoverEffect, cartCheckoutLabel, cartDrawerWidth, cartEmptyHeading, cartEmptySubtext, cartViewLabel, colorBackground, colorBorder, colorBrand, colorSale, colorSecondarySurface, colorText, enableAccountDropdown, enableMobileNavDrawer, fontBody, fontHeading, footerCompanyMenuHandle, footerHelpMenuHandle, footerShopMenuHandle, footerTagline, headerMenuHandle, headingFont, mobileNavHeading, mobileNavWidth, poweredByLabel, productImageFit, productImageRatio, productMediaBackground, searchCtaLabel, searchDebounceMs, searchMaxResults, searchModalWidth, searchPlaceholder, showPoweredBy, showVendorGlobally, suggestedLinksMenu
+<!-- END GENERATED CATALOG -->

package/templates/nova/_gitignore

@@ -0,0 +1,28 @@
+node_modules/
+dist/
+dist-ssr/
+.vite/
+.env
+*.local
+.DS_Store
+
+# Screenshots and ledgers written by `pnpm verify:live`.
+qa/
+
+# Generated by @tanqory/theme-compiler on every dev/build/manifest run. The
+# contract locks (written by `tanqory-theme contracts`, hashed in LOCK.json) and
+# the legacy settings (hidden keys stores saved values for; the manifest and
+# ai-api depend on them) are committed — still compiler-managed, never
+# hand-edited. The root .gitignore re-includes this one folder.
+.tanqory/*
+!.tanqory/contracts/
+!.tanqory/legacy-settings.json
+
+# The kit comes from the registry (@tanqory/theme-kit); no tarballs are vendored.
+*.tgz
+
+# Theme ABI v2 build output: the manifest copy the server entry imports (scripts/abi/build.mjs).
+lib/abi/generated/
+
+# Reports written by `npm run check`.
+reports/

package/templates/nova/assets/ai-tokens.css

@@ -0,0 +1,6 @@
+/* AI brand tokens — OWNED BY THE AI THEME GENERATOR (theme-gen writes this
+ * file on install; see ai-api dna-storefront). The framework's own tokens live
+ * in tokens.css and must never be overwritten — AI sections consume the
+ * `--tq-*` custom properties defined here, base sections consume the
+ * framework's `--color-*` / `--space-*` / `--z-*` set from tokens.css.
+ * Empty by default (non-AI themes). */

package/templates/nova/assets/starter/starter-art-1200x800-0b773ac4.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 400" preserveAspectRatio="xMidYMid slice" width="1200" height="800"><rect data-dc-tpl="121" width="400" height="400" style="fill: #E9EAE4;"></rect><path data-dc-tpl="122" d="M72 306V160a128 128 0 0 1 256 0v146z" style="fill: #DEE1D8;"></path><rect data-dc-tpl="123" y="306" width="400" height="94" style="fill: #CDD3C6;"></rect><ellipse data-dc-tpl="124" cx="200" cy="306" rx="150" ry="8" opacity=".45" style="fill: #B8C0B0;"></ellipse><rect data-dc-tpl="125" x="92" y="208" width="58" height="98" rx="12" style="fill: #B8C0B0;"></rect><rect data-dc-tpl="126" x="162" y="172" width="48" height="134" rx="24" style="fill: #CDD3C6;"></rect><rect data-dc-tpl="127" x="162" y="172" width="48" height="16" rx="8" opacity=".7" style="fill: #F4F5F1;"></rect><circle data-dc-tpl="128" cx="252" cy="272" r="34" style="fill: #B8C0B0;"></circle><rect data-dc-tpl="129" x="290" y="236" width="40" height="70" rx="8" style="fill: #CDD3C6;"></rect></svg>

package/templates/nova/assets/starter/starter-art-1200x900-59600290.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300" preserveAspectRatio="xMidYMid slice" width="1200" height="900"><rect data-dc-tpl="286" width="400" height="300" style="fill: #ECEAE6;"></rect><path data-dc-tpl="287" d="M220 212V124a60 60 0 0 1 120 0v88z" style="fill: #F6F5F2;"></path><rect data-dc-tpl="288" y="212" width="400" height="88" style="fill: #E3E0DA;"></rect><ellipse data-dc-tpl="289" cx="130" cy="212" rx="70" ry="6" opacity=".5" style="fill: #C4BDB3;"></ellipse><rect data-dc-tpl="290" x="82" y="130" width="50" height="82" rx="12" style="fill: #D5D0C8;"></rect><circle data-dc-tpl="291" cx="164" cy="188" r="24" style="fill: #C4BDB3;"></circle></svg>

package/templates/nova/assets/starter/starter-art-1200x900-c549d496.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300" preserveAspectRatio="xMidYMid slice" width="1200" height="900"><rect data-dc-tpl="202" width="400" height="300" style="fill: #E5EAE6;"></rect><rect data-dc-tpl="203" x="40" y="58" width="320" height="242" style="fill: #DAE1DC;"></rect><rect data-dc-tpl="204" x="130" y="70" width="140" height="12" rx="6" style="fill: #C8D3CC;"></rect><rect data-dc-tpl="205" x="30" y="92" width="340" height="26" rx="4" style="fill: #AFBDB4;"></rect><circle data-dc-tpl="206" cx="40" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="207" cx="60" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="208" cx="80" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="209" cx="100" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="210" cx="120" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="211" cx="140" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="212" cx="160" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="213" cx="180" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="214" cx="200" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="215" cx="220" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="216" cx="240" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="217" cx="260" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="218" cx="280" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="219" cx="300" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="220" cx="320" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="221" cx="340" cy="118" r="10" style="fill: #AFBDB4;"></circle><circle data-dc-tpl="222" cx="360" cy="118" r="10" style="fill: #AFBDB4;"></circle><rect data-dc-tpl="223" x="64" y="142" width="178" height="120" rx="4" style="fill: #F2F5F2;"></rect><rect data-dc-tpl="224" x="88" y="198" width="30" height="64" rx="6" style="fill: #C8D3CC;"></rect><circle data-dc-tpl="225" cx="160" cy="238" r="22" style="fill: #C8D3CC;"></circle><rect data-dc-tpl="226" x="194" y="214" width="30" height="48" rx="4" style="fill: #AFBDB4;"></rect><rect data-dc-tpl="227" x="262" y="142" width="76" height="158" rx="4" style="fill: #C8D3CC;"></rect><circle data-dc-tpl="228" cx="324" cy="224" r="4" style="fill: #AFBDB4;"></circle><rect data-dc-tpl="229" y="290" width="400" height="10" style="fill: #C8D3CC;"></rect></svg>

package/templates/nova/assets/starter/starter-art-1600x900-8f979fcb.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 500" preserveAspectRatio="xMidYMid slice" width="1600" height="900"><rect data-dc-tpl="140" width="1200" height="500" style="fill: #E6EAEC;"></rect><path data-dc-tpl="141" d="M760 360V190a150 150 0 0 1 300 0v170z" style="fill: #F4F6F6;"></path><rect data-dc-tpl="142" x="908" y="40" width="4" height="320" style="fill: #DCE2E4;"></rect><rect data-dc-tpl="143" x="760" y="250" width="300" height="4" style="fill: #DCE2E4;"></rect><rect data-dc-tpl="144" y="360" width="1200" height="140" style="fill: #DCE2E4;"></rect><ellipse data-dc-tpl="145" cx="910" cy="420" rx="250" ry="30" opacity=".7" style="fill: #F4F6F6;"></ellipse><rect data-dc-tpl="146" x="120" y="298" width="480" height="16" rx="8" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="147" x="160" y="314" width="12" height="64" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="148" x="548" y="314" width="12" height="64" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="149" x="200" y="198" width="62" height="100" rx="14" style="fill: #CCD4D7;"></rect><circle data-dc-tpl="150" cx="332" cy="266" r="32" style="fill: #B5C0C4;"></circle><rect data-dc-tpl="151" x="400" y="234" width="92" height="64" rx="10" style="fill: #CCD4D7;"></rect></svg>

package/templates/nova/assets/starter/starter-art-2100x900-cbb71bfd.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 500" preserveAspectRatio="xMidYMid slice" width="2100" height="900"><rect data-dc-tpl="140" width="1200" height="500" style="fill: #E6EAEC;"></rect><path data-dc-tpl="141" d="M760 360V190a150 150 0 0 1 300 0v170z" style="fill: #F4F6F6;"></path><rect data-dc-tpl="142" x="908" y="40" width="4" height="320" style="fill: #DCE2E4;"></rect><rect data-dc-tpl="143" x="760" y="250" width="300" height="4" style="fill: #DCE2E4;"></rect><rect data-dc-tpl="144" y="360" width="1200" height="140" style="fill: #DCE2E4;"></rect><ellipse data-dc-tpl="145" cx="910" cy="420" rx="250" ry="30" opacity=".7" style="fill: #F4F6F6;"></ellipse><rect data-dc-tpl="146" x="120" y="298" width="480" height="16" rx="8" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="147" x="160" y="314" width="12" height="64" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="148" x="548" y="314" width="12" height="64" style="fill: #B5C0C4;"></rect><rect data-dc-tpl="149" x="200" y="198" width="62" height="100" rx="14" style="fill: #CCD4D7;"></rect><circle data-dc-tpl="150" cx="332" cy="266" r="32" style="fill: #B5C0C4;"></circle><rect data-dc-tpl="151" x="400" y="234" width="92" height="64" rx="10" style="fill: #CCD4D7;"></rect></svg>

package/templates/nova/config/legacy-settings.json

@@ -0,0 +1,438 @@
+{
+  "accent": {
+    "type": "color",
+    "label": "Button colour"
+  },
+  "accountExtraLinks": {
+    "type": "textarea",
+    "label": "Extra account links"
+  },
+  "accountHeading": {
+    "type": "text",
+    "label": "Account menu heading"
+  },
+  "accountLoggedIn": {
+    "type": "boolean",
+    "label": "Preview signed-in state"
+  },
+  "accountPrimaryHref": {
+    "type": "url",
+    "label": "Primary action link"
+  },
+  "accountPrimaryLabel": {
+    "type": "text",
+    "label": "Primary action label"
+  },
+  "accountSecondaryHref": {
+    "type": "url",
+    "label": "Secondary action link"
+  },
+  "accountSecondaryLabel": {
+    "type": "text",
+    "label": "Secondary action label"
+  },
+  "accountSubtext": {
+    "type": "text",
+    "label": "Account menu subtext"
+  },
+  "bodyFont": {
+    "type": "select",
+    "label": "Body font",
+    "options": [
+      {
+        "value": "",
+        "label": "Default (Settings \u2192 Brand, else theme font)"
+      },
+      {
+        "value": "Geist",
+        "label": "Geist"
+      },
+      {
+        "value": "Inter",
+        "label": "Inter"
+      },
+      {
+        "value": "DM Sans",
+        "label": "DM Sans"
+      },
+      {
+        "value": "Work Sans",
+        "label": "Work Sans"
+      },
+      {
+        "value": "Poppins",
+        "label": "Poppins"
+      },
+      {
+        "value": "Montserrat",
+        "label": "Montserrat"
+      },
+      {
+        "value": "Roboto",
+        "label": "Roboto"
+      },
+      {
+        "value": "Open Sans",
+        "label": "Open Sans"
+      },
+      {
+        "value": "Lato",
+        "label": "Lato"
+      },
+      {
+        "value": "Nunito Sans",
+        "label": "Nunito Sans"
+      },
+      {
+        "value": "Space Grotesk",
+        "label": "Space Grotesk"
+      },
+      {
+        "value": "Noto Sans Thai",
+        "label": "Noto Sans Thai"
+      },
+      {
+        "value": "IBM Plex Sans Thai",
+        "label": "IBM Plex Sans Thai"
+      },
+      {
+        "value": "Prompt",
+        "label": "Prompt"
+      },
+      {
+        "value": "Kanit",
+        "label": "Kanit"
+      },
+      {
+        "value": "Sarabun",
+        "label": "Sarabun"
+      },
+      {
+        "value": "Playfair Display",
+        "label": "Playfair Display"
+      },
+      {
+        "value": "DM Serif Display",
+        "label": "DM Serif Display"
+      },
+      {
+        "value": "Cormorant Garamond",
+        "label": "Cormorant Garamond"
+      },
+      {
+        "value": "EB Garamond",
+        "label": "EB Garamond"
+      },
+      {
+        "value": "Libre Baskerville",
+        "label": "Libre Baskerville"
+      },
+      {
+        "value": "Lora",
+        "label": "Lora"
+      },
+      {
+        "value": "Merriweather",
+        "label": "Merriweather"
+      }
+    ]
+  },
+  "cardBorder": {
+    "type": "boolean",
+    "label": "Outline cards"
+  },
+  "cardHoverEffect": {
+    "type": "select",
+    "label": "Card hover",
+    "options": [
+      {
+        "value": "none",
+        "label": "None"
+      },
+      {
+        "value": "image-swap",
+        "label": "Show second image"
+      },
+      {
+        "value": "zoom",
+        "label": "Zoom image"
+      }
+    ]
+  },
+  "cartCheckoutLabel": {
+    "type": "text",
+    "label": "Checkout button label"
+  },
+  "cartDrawerWidth": {
+    "type": "text",
+    "label": "Cart drawer width"
+  },
+  "cartEmptyHeading": {
+    "type": "text",
+    "label": "Empty-cart heading"
+  },
+  "cartEmptySubtext": {
+    "type": "text",
+    "label": "Empty-cart subtext"
+  },
+  "cartViewLabel": {
+    "type": "text",
+    "label": "View-full-cart label"
+  },
+  "colorBackground": {
+    "type": "color",
+    "label": "Page background"
+  },
+  "colorBorder": {
+    "type": "color",
+    "label": "Border"
+  },
+  "colorBrand": {
+    "type": "color",
+    "label": "Brand colour"
+  },
+  "colorSale": {
+    "type": "color",
+    "label": "Sale"
+  },
+  "colorSecondarySurface": {
+    "type": "color",
+    "label": "Secondary surface"
+  },
+  "colorText": {
+    "type": "color",
+    "label": "Text"
+  },
+  "enableAccountDropdown": {
+    "type": "boolean",
+    "label": "Show account dropdown"
+  },
+  "enableMobileNavDrawer": {
+    "type": "boolean",
+    "label": "Mobile navigation drawer"
+  },
+  "fontBody": {
+    "type": "text",
+    "label": "Body font"
+  },
+  "fontHeading": {
+    "type": "text",
+    "label": "Heading font"
+  },
+  "footerCompanyMenuHandle": {
+    "type": "menu",
+    "label": "Footer \u2014 Company menu"
+  },
+  "footerHelpMenuHandle": {
+    "type": "menu",
+    "label": "Footer \u2014 Help menu"
+  },
+  "footerShopMenuHandle": {
+    "type": "menu",
+    "label": "Footer \u2014 Shop menu"
+  },
+  "footerTagline": {
+    "type": "textarea",
+    "label": "Footer tagline"
+  },
+  "headerMenuHandle": {
+    "type": "menu",
+    "label": "Header menu"
+  },
+  "headingFont": {
+    "type": "select",
+    "label": "Heading font",
+    "options": [
+      {
+        "value": "",
+        "label": "Default (Settings \u2192 Brand, else theme font)"
+      },
+      {
+        "value": "Geist",
+        "label": "Geist"
+      },
+      {
+        "value": "Inter",
+        "label": "Inter"
+      },
+      {
+        "value": "DM Sans",
+        "label": "DM Sans"
+      },
+      {
+        "value": "Work Sans",
+        "label": "Work Sans"
+      },
+      {
+        "value": "Poppins",
+        "label": "Poppins"
+      },
+      {
+        "value": "Montserrat",
+        "label": "Montserrat"
+      },
+      {
+        "value": "Roboto",
+        "label": "Roboto"
+      },
+      {
+        "value": "Open Sans",
+        "label": "Open Sans"
+      },
+      {
+        "value": "Lato",
+        "label": "Lato"
+      },
+      {
+        "value": "Nunito Sans",
+        "label": "Nunito Sans"
+      },
+      {
+        "value": "Space Grotesk",
+        "label": "Space Grotesk"
+      },
+      {
+        "value": "Noto Sans Thai",
+        "label": "Noto Sans Thai"
+      },
+      {
+        "value": "IBM Plex Sans Thai",
+        "label": "IBM Plex Sans Thai"
+      },
+      {
+        "value": "Prompt",
+        "label": "Prompt"
+      },
+      {
+        "value": "Kanit",
+        "label": "Kanit"
+      },
+      {
+        "value": "Sarabun",
+        "label": "Sarabun"
+      },
+      {
+        "value": "Playfair Display",
+        "label": "Playfair Display"
+      },
+      {
+        "value": "DM Serif Display",
+        "label": "DM Serif Display"
+      },
+      {
+        "value": "Cormorant Garamond",
+        "label": "Cormorant Garamond"
+      },
+      {
+        "value": "EB Garamond",
+        "label": "EB Garamond"
+      },
+      {
+        "value": "Libre Baskerville",
+        "label": "Libre Baskerville"
+      },
+      {
+        "value": "Lora",
+        "label": "Lora"
+      },
+      {
+        "value": "Merriweather",
+        "label": "Merriweather"
+      }
+    ]
+  },
+  "mobileNavHeading": {
+    "type": "text",
+    "label": "Mobile menu heading"
+  },
+  "mobileNavWidth": {
+    "type": "text",
+    "label": "Mobile drawer width"
+  },
+  "poweredByLabel": {
+    "type": "text",
+    "label": "\"Powered by\" label"
+  },
+  "productImageFit": {
+    "type": "select",
+    "label": "Product image fit",
+    "options": [
+      {
+        "value": "contain",
+        "label": "Fit whole product"
+      },
+      {
+        "value": "cover",
+        "label": "Fill and crop"
+      }
+    ]
+  },
+  "productImageRatio": {
+    "type": "select",
+    "label": "Product image shape",
+    "options": [
+      {
+        "value": "adapt",
+        "label": "Adapt to image"
+      },
+      {
+        "value": "portrait",
+        "label": "Portrait (4:5)"
+      },
+      {
+        "value": "square",
+        "label": "Square"
+      },
+      {
+        "value": "landscape",
+        "label": "Landscape (4:3)"
+      }
+    ]
+  },
+  "productMediaBackground": {
+    "type": "select",
+    "label": "Product image background",
+    "options": [
+      {
+        "value": "tile",
+        "label": "Tile (light grey behind the image)"
+      },
+      {
+        "value": "none",
+        "label": "None"
+      }
+    ]
+  },
+  "searchCtaLabel": {
+    "type": "text",
+    "label": "See-all-results label"
+  },
+  "searchDebounceMs": {
+    "type": "number",
+    "label": "Search debounce (ms)"
+  },
+  "searchMaxResults": {
+    "type": "number",
+    "label": "Max quick results"
+  },
+  "searchModalWidth": {
+    "type": "text",
+    "label": "Search modal width"
+  },
+  "searchPlaceholder": {
+    "type": "text",
+    "label": "Search placeholder"
+  },
+  "showPoweredBy": {
+    "type": "boolean",
+    "label": "Show \"Made with Tanqory\""
+  },
+  "showVendorGlobally": {
+    "type": "boolean",
+    "label": "Show vendor on product cards"
+  },
+  "suggestedLinksMenu": {
+    "type": "menu",
+    "label": "Suggested links"
+  }
+}