create-tanqory-theme 0.0.0-stage → 0.2.3

package/templates/nova/template.json

@@ -0,0 +1,94 @@
+{
+  "id": "nova",
+  "title": "Nova fork",
+  "summary": "A standalone fork of Nova V3, the Tanqory reference theme: its sections, components, styles, starter content, contracts tooling and tests. Restyle and reshape it; keep the kit wiring.",
+  "api": "@tanqory/theme-kit",
+  "layout": [
+    [
+      "theme.config.ts",
+      "defineTheme: every section the theme offers, its provider and layout"
+    ],
+    [
+      "src/sections/",
+      "the sections (defineSection with their settings schemas)"
+    ],
+    [
+      "src/components/",
+      "presentational components the sections use"
+    ],
+    [
+      "src/styles/",
+      "the design tokens, provider and strings"
+    ],
+    [
+      "src/layouts/",
+      "the page layout"
+    ],
+    [
+      "templates/, groups/, config/",
+      "starter content and setting values"
+    ],
+    [
+      "locales/",
+      "every visible string, per language"
+    ],
+    [
+      "lib/bundle.ts",
+      "what the kit is handed: theme, templates, groups, locales, settings"
+    ],
+    [
+      "lib/legacy-settings.ts",
+      "older global setting keys the theme still honours"
+    ],
+    [
+      "entry.abi.tsx, main.abi.tsx",
+      "createRender() / hydrate(): leave as they are"
+    ],
+    [
+      "theme.manifest.json",
+      "generated from the section schemas by `npm run manifest` (never hand-edit)"
+    ],
+    [
+      ".tanqory/contracts/",
+      "contract locks the build checks (compiler-managed)"
+    ],
+    [
+      "scripts/abi/",
+      "build.mjs (dist/abi), manifest.mjs, local-host.mjs (look at dist/abi in a browser with recorded data)"
+    ],
+    [
+      "scripts/compiler/",
+      "manifest generator, contracts, checks (a11y, headings, Product JSON-LD), migrations"
+    ],
+    [
+      "tests/",
+      "vitest: render cases, contracts, ABI render and hydration, AI contract"
+    ]
+  ],
+  "docs": [
+    [
+      "node_modules/@tanqory/theme-kit/README.md",
+      "the kit's entry points (authoring API, /server, /client, /runtime, /headless)"
+    ],
+    [
+      "node_modules/@tanqory/theme-kit/docs/headless-api.md",
+      "the headless API (hooks and primitives) for new sections"
+    ],
+    [
+      "node_modules/@tanqory/theme-abi/contracts/theme-abi-v2.md",
+      "the platform contract (routes, data, actions, capabilities, editor protocol, limits)"
+    ],
+    [
+      "node_modules/@tanqory/theme-conformance/docs/storefront-tier.md",
+      "every storefront check, with its fix hint"
+    ]
+  ],
+  "extraRules": [
+    "**Regenerate, never hand-edit, `theme.manifest.json`**: change a section's schema, then `npm run manifest` (the build does it too). Node ≥ 22.6 is required (the generator uses `--experimental-strip-types`).",
+    "Rename and restyle freely, but keep each section's `type` stable once a store has content for it: saved content refers to sections by type."
+  ],
+  "source": {
+    "theme": "Nova V3",
+    "commit": "75bb1b67"
+  }
+}

package/templates/nova/templates/404.json

@@ -0,0 +1,30 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "not-found",
+      "id": "404",
+      "settings": {
+        "heading": "Page not found",
+        "body": "The page you're looking for doesn't exist or has moved.",
+        "buttonLabel": "Back to home",
+        "buttonLink": "/",
+        "showSearch": true
+      }
+    },
+    {
+      "type": "featured-collection",
+      "id": "popular",
+      "settings": {
+        "heading": "Popular right now",
+        "collection": "all",
+        "showViewAll": false,
+        "productsToShow": 4
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/account.json

@@ -0,0 +1,15 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "account",
+      "id": "account",
+      "settings": {},
+      "area": "template"
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/article.json

@@ -0,0 +1,41 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "breadcrumbs",
+      "id": "breadcrumbs",
+      "settings": {
+        "separator": "/",
+        "mobileStyle": "back-link",
+        "showCurrent": true
+      }
+    },
+    {
+      "type": "article-body",
+      "id": "article-body",
+      "settings": {
+        "fallbackTitle": "Article",
+        "fallbackBody": "<p>This article hasn't been published yet.</p>",
+        "spacingTop": "small"
+      }
+    },
+    {
+      "type": "product-grid",
+      "id": "shop-the-story",
+      "settings": {
+        "heading": "Shop the story",
+        "collection": "all",
+        "columns": "4",
+        "filterLayout": "none",
+        "showSort": false,
+        "showCount": false,
+        "productsPerPage": "12",
+        "showQuickAdd": false
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/article.longform.json

@@ -0,0 +1,17 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "article-body",
+      "id": "main",
+      "settings": {
+        "fallbackTitle": "Article",
+        "width": "content"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/blog.featured.json

@@ -0,0 +1,22 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "blog-posts",
+      "id": "main",
+      "settings": {
+        "fallbackTitle": "Journal",
+        "featuredFirst": true,
+        "showExcerpt": true,
+        "columns": "2",
+        "paginate": true,
+        "featuredStyle": "overlay",
+        "postsToShow": 6
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/blog.json

@@ -0,0 +1,29 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "blog-posts",
+      "id": "blog-posts",
+      "settings": {
+        "fallbackTitle": "Journal",
+        "fallbackEmpty": "<p>No articles published yet.</p>",
+        "featuredFirst": true,
+        "spacingTop": "small"
+      }
+    },
+    {
+      "type": "newsletter",
+      "id": "newsletter",
+      "settings": {
+        "heading": "Join the newsletter",
+        "body": "Tell readers what you will send them, and how often.",
+        "buttonLabel": "Subscribe",
+        "layout": "start"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/cart.json

@@ -0,0 +1,67 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "cart-items",
+      "id": "lines",
+      "settings": {
+        "heading": "Cart",
+        "buttonLabel": "Checkout"
+      }
+    },
+    {
+      "type": "trust-badges",
+      "id": "trust",
+      "settings": {
+        "style": "row",
+        "dividers": true,
+        "iconSize": "md",
+        "alignment": "start"
+      },
+      "blocks": [
+        {
+          "type": "badge",
+          "id": "cart-trust-badge-1",
+          "settings": {
+            "icon": "truck"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "cart-trust-badge-2",
+          "settings": {
+            "icon": "return"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "cart-trust-badge-3",
+          "settings": {
+            "icon": "shield"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "cart-trust-badge-4",
+          "settings": {
+            "icon": "chat"
+          }
+        }
+      ]
+    },
+    {
+      "type": "featured-collection",
+      "id": "you-may-like",
+      "settings": {
+        "heading": "Goes well with",
+        "collection": "all",
+        "showViewAll": false,
+        "productsToShow": 4
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/collection.featured.json

@@ -0,0 +1,43 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "collection-banner",
+      "id": "banner",
+      "settings": {
+        "height": "md",
+        "showDescription": false,
+        "showBreadcrumb": true,
+        "contentPosition": "bottom-start",
+        "pageHeading": true
+      }
+    },
+    {
+      "type": "rich-text",
+      "id": "intro",
+      "settings": {
+        "heading": "About this edit",
+        "body": "<p>Say why these pieces belong together.</p>",
+        "headingSize": "h3",
+        "contentAlignment": "left",
+        "mobileContentAlignment": "left",
+        "width": "content",
+        "layout": "split"
+      }
+    },
+    {
+      "type": "main-collection",
+      "id": "main",
+      "settings": {
+        "showHeader": false,
+        "filterLayout": "top-bar",
+        "columns": "4",
+        "productsPerPage": "24"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/collection.json

@@ -0,0 +1,30 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "breadcrumbs",
+      "id": "breadcrumbs",
+      "settings": {
+        "separator": "/",
+        "mobileStyle": "back-link",
+        "showCurrent": true
+      }
+    },
+    {
+      "type": "main-collection",
+      "id": "products",
+      "settings": {
+        "productsPerPage": "24",
+        "columns": "3",
+        "mobileColumns": "2",
+        "pagination": "load-more",
+        "showCollectionImage": "beside-title",
+        "filterLayout": "sidebar"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/contact.json

@@ -0,0 +1,65 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "rich-text",
+      "id": "intro",
+      "settings": {
+        "heading": "Get in touch",
+        "body": "For a question about an order, include your order number.",
+        "contentAlignment": "left",
+        "headingSize": "h1"
+      }
+    },
+    {
+      "type": "contact-form",
+      "id": "form",
+      "settings": {
+        "heading": "Send us a message",
+        "subheading": "We read every note.",
+        "buttonLabel": "Send message",
+        "fields": "name,email,message"
+      }
+    },
+    {
+      "type": "faq",
+      "id": "faq",
+      "settings": {
+        "heading": "Before you write",
+        "headerAlignment": "left",
+        "firstOpen": false,
+        "layout": "beside"
+      },
+      "blocks": [
+        {
+          "type": "faq-item",
+          "id": "faq-1",
+          "settings": {
+            "question": "Add a question customers often ask",
+            "answer": "<p>Answer it here, in your own words.</p>"
+          }
+        },
+        {
+          "type": "faq-item",
+          "id": "faq-2",
+          "settings": {
+            "question": "Add another question",
+            "answer": "<p>Answer it here, in your own words.</p>"
+          }
+        }
+      ]
+    },
+    {
+      "type": "store-locator",
+      "id": "locations",
+      "settings": {
+        "heading": "Visit us",
+        "columns": "3"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/index.json

@@ -0,0 +1,167 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "hero",
+      "id": "s-hero",
+      "settings": {
+        "layout": "text-first",
+        "eyebrow": "New season",
+        "heading": "Made for everyday use",
+        "subtext": "Introduce your store in a sentence or two — what you make, and who it is for.",
+        "buttonLabel": "Shop now",
+        "buttonLink": "/collections/all",
+        "secondaryLabel": "Browse all",
+        "secondaryLink": "/collections",
+        "backgroundImage": "data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%201200%20500%22%20preserveAspectRatio=%22xMidYMid%20slice%22%20width=%222100%22%20height=%22900%22%3E%3Crect%20data-dc-tpl=%22140%22%20width=%221200%22%20height=%22500%22%20style=%22fill:%20%23E6EAEC;%22%3E%3C/rect%3E%3Cpath%20data-dc-tpl=%22141%22%20d=%22M760%20360V190a150%20150%200%200%201%20300%200v170z%22%20style=%22fill:%20%23F4F6F6;%22%3E%3C/path%3E%3Crect%20data-dc-tpl=%22142%22%20x=%22908%22%20y=%2240%22%20width=%224%22%20height=%22320%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22143%22%20x=%22760%22%20y=%22250%22%20width=%22300%22%20height=%224%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22144%22%20y=%22360%22%20width=%221200%22%20height=%22140%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Cellipse%20data-dc-tpl=%22145%22%20cx=%22910%22%20cy=%22420%22%20rx=%22250%22%20ry=%2230%22%20opacity=%22.7%22%20style=%22fill:%20%23F4F6F6;%22%3E%3C/ellipse%3E%3Crect%20data-dc-tpl=%22146%22%20x=%22120%22%20y=%22298%22%20width=%22480%22%20height=%2216%22%20rx=%228%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22147%22%20x=%22160%22%20y=%22314%22%20width=%2212%22%20height=%2264%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22148%22%20x=%22548%22%20y=%22314%22%20width=%2212%22%20height=%2264%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22149%22%20x=%22200%22%20y=%22198%22%20width=%2262%22%20height=%22100%22%20rx=%2214%22%20style=%22fill:%20%23CCD4D7;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22150%22%20cx=%22332%22%20cy=%22266%22%20r=%2232%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22151%22%20x=%22400%22%20y=%22234%22%20width=%2292%22%20height=%2264%22%20rx=%2210%22%20style=%22fill:%20%23CCD4D7;%22%3E%3C/rect%3E%3C/svg%3E"
+      },
+      "area": "template"
+    },
+    {
+      "type": "featured-collection",
+      "id": "s-featured-collection",
+      "settings": {
+        "heading": "New arrivals",
+        "collection": "all",
+        "productsToShow": 4,
+        "mobileColumns": "2",
+        "showNavigation": true,
+        "cardImageRatio": "inherit",
+        "showViewAll": true,
+        "layout": "grid",
+        "columns": 4,
+        "carouselOnMobile": true,
+        "headerAlignment": "left"
+      },
+      "area": "template"
+    },
+    {
+      "type": "collection-list",
+      "id": "s-collection-list",
+      "settings": {
+        "heading": "Shop by collection",
+        "limit": 4,
+        "carouselOnMobile": false,
+        "layout": "grid",
+        "columns": 4,
+        "imageRatio": "portrait",
+        "textStyle": "below",
+        "showCount": true,
+        "showDescription": false,
+        "headerAlignment": "left"
+      },
+      "area": "template"
+    },
+    {
+      "type": "image-with-text",
+      "id": "s-image-with-text",
+      "settings": {
+        "image": "data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%20400%20400%22%20preserveAspectRatio=%22xMidYMid%20slice%22%20width=%221200%22%20height=%22800%22%3E%3Crect%20data-dc-tpl=%22121%22%20width=%22400%22%20height=%22400%22%20style=%22fill:%20%23E9EAE4;%22%3E%3C/rect%3E%3Cpath%20data-dc-tpl=%22122%22%20d=%22M72%20306V160a128%20128%200%200%201%20256%200v146z%22%20style=%22fill:%20%23DEE1D8;%22%3E%3C/path%3E%3Crect%20data-dc-tpl=%22123%22%20y=%22306%22%20width=%22400%22%20height=%2294%22%20style=%22fill:%20%23CDD3C6;%22%3E%3C/rect%3E%3Cellipse%20data-dc-tpl=%22124%22%20cx=%22200%22%20cy=%22306%22%20rx=%22150%22%20ry=%228%22%20opacity=%22.45%22%20style=%22fill:%20%23B8C0B0;%22%3E%3C/ellipse%3E%3Crect%20data-dc-tpl=%22125%22%20x=%2292%22%20y=%22208%22%20width=%2258%22%20height=%2298%22%20rx=%2212%22%20style=%22fill:%20%23B8C0B0;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22126%22%20x=%22162%22%20y=%22172%22%20width=%2248%22%20height=%22134%22%20rx=%2224%22%20style=%22fill:%20%23CDD3C6;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22127%22%20x=%22162%22%20y=%22172%22%20width=%2248%22%20height=%2216%22%20rx=%228%22%20opacity=%22.7%22%20style=%22fill:%20%23F4F5F1;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22128%22%20cx=%22252%22%20cy=%22272%22%20r=%2234%22%20style=%22fill:%20%23B8C0B0;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22129%22%20x=%22290%22%20y=%22236%22%20width=%2240%22%20height=%2270%22%20rx=%228%22%20style=%22fill:%20%23CDD3C6;%22%3E%3C/rect%3E%3C/svg%3E",
+        "mediaPosition": "left",
+        "mediaRatio": "landscape",
+        "contentVerticalAlign": "center",
+        "mobileMediaPosition": "before",
+        "buttonVariant": "secondary",
+        "heading": "A story worth telling",
+        "body": "Tell customers how your products are made, and by whom.",
+        "eyebrow": "Our story"
+      },
+      "area": "template"
+    },
+    {
+      "type": "testimonials",
+      "id": "s-testimonials",
+      "settings": {
+        "heading": "What customers say",
+        "layout": "grid",
+        "columns": 3,
+        "showRating": true,
+        "showAvatar": false,
+        "quoteSize": "md",
+        "autoplay": false
+      },
+      "area": "template",
+      "blocks": [
+        {
+          "type": "testimonial",
+          "id": "b-testimonial-1",
+          "settings": {
+            "quote": "Share what a customer said about you.",
+            "name": "Customer name",
+            "role": "City",
+            "rating": 5
+          }
+        },
+        {
+          "type": "testimonial",
+          "id": "b-testimonial-2",
+          "settings": {
+            "quote": "Share what a customer said about you.",
+            "name": "Customer name",
+            "role": "City",
+            "rating": 5
+          }
+        },
+        {
+          "type": "testimonial",
+          "id": "b-testimonial-3",
+          "settings": {
+            "quote": "Share what a customer said about you.",
+            "name": "Customer name",
+            "role": "City",
+            "rating": 5
+          }
+        }
+      ]
+    },
+    {
+      "type": "feature-highlights",
+      "id": "s-feature-highlights",
+      "settings": {
+        "features": "Delivery | Describe how and when you ship.\nReturns | Describe your returns window.\nCare | Describe how to look after a piece.\nPayment | List the ways customers can pay.",
+        "background": "surface",
+        "columns": "4",
+        "iconStyle": "none",
+        "textAlignment": "left"
+      },
+      "area": "template"
+    }
+  ],
+  "groups": {
+    "header": {
+      "override": [
+        {
+          "type": "announcement-bar",
+          "id": "s-announcement-bar",
+          "settings": {
+            "background": "muted",
+            "rotation": false,
+            "showArrows": true,
+            "dismissible": false,
+            "text": "Welcome to the store"
+          },
+          "area": "header"
+        },
+        {
+          "type": "header",
+          "id": "s-header",
+          "settings": {
+            "layout": "logo-left",
+            "sticky": "always",
+            "menu": "main-menu",
+            "transparentOnHero": false,
+            "logoHeight": "medium",
+            "showSearch": true,
+            "searchStyle": "icon",
+            "cartAction": "drawer",
+            "showCart": true,
+            "showAccount": true,
+            "showLocale": false
+          },
+          "area": "header"
+        }
+      ]
+    },
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/list-collections.json

@@ -0,0 +1,19 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "collection-list",
+      "id": "all-collections",
+      "settings": {
+        "heading": "Collections",
+        "pageHeading": true,
+        "limit": 12,
+        "carouselOnMobile": false
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}