@cimplify/sdk 0.40.0 → 0.41.0

package/templates/storefront-fashion/lib/brand.ts

@@ -0,0 +1,421 @@
+/**
+ * Brand & content configuration — single source of truth for every visible
+ * string. Edit this file to rebrand. See ../AGENTS.md.
+ */
+
+export interface BrandSocial {
+  label: string;
+  href: string;
+  icon?: "instagram" | "x" | "tiktok" | "facebook" | "youtube" | "linkedin" | "whatsapp";
+}
+
+export interface BrandFaqEntry { q: string; a: string }
+export interface BrandFaqSection { title: string; items: BrandFaqEntry[] }
+export interface BrandPolicySection {
+  heading: string;
+  body: string | { intro: string; bullets: string[] };
+}
+export interface BrandSitemapSection { title: string; links: { label: string; href: string }[] }
+
+export interface Brand {
+  name: string;
+  shortName: string;
+  microTag: string;
+  description: string;
+  schemaType:
+    | "Store" | "Bakery" | "Restaurant" | "BeautySalon"
+    | "GroceryStore" | "LocalBusiness" | "Organization";
+  currency: string;
+  locale: string;
+  contact: {
+    address: string; streetAddress: string; city: string; countryCode: string;
+    phone: string; phoneTel: string; email: string; privacyEmail: string;
+    supportEmail?: string; businessEmail?: string; hours: string;
+  };
+  socials: BrandSocial[];
+  header: { nav: { label: string; href: string }[] };
+  hero: {
+    badge: string; title: string; subtitle: string;
+    primaryCtaLabel: string;
+    secondaryCtaLabel?: string; secondaryCtaHref?: string;
+  };
+  trustItems?: { label: string; value: string; description: string; iconKey: string }[];
+  brandStrip?: { headline: string; brands: string[] };
+  promo?: { badge: string; title: string; body: string; ctaLabel: string; ctaHref: string };
+  tradeIn?: {
+    eyebrow: string; title: string; body: string;
+    primaryCtaLabel: string; primaryCtaHref: string;
+    secondaryCtaLabel: string; secondaryCtaHref: string;
+    steps: { step: string; title: string; body: string }[];
+  };
+  newsletter: {
+    eyebrow: string; title: string; body: string; placeholder: string;
+    submitLabel: string; successLabel: string;
+  };
+  about: {
+    eyebrow: string; title: string; paragraphs: string[];
+    sections: { heading: string; body: string }[];
+  };
+  faq: {
+    eyebrow: string; title: string; sections: BrandFaqSection[];
+    contactPrompt: string; contactEmail: string;
+  };
+  terms: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  privacy: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  footer: {
+    blurb: string; sitemap: BrandSitemapSection[];
+    poweredBy?: { label: string; href: string };
+  };
+  llms: { summary: string };
+  mock: { seed: string; businessId: string };
+}
+
+export const brand: Brand = {
+  name: "Studio FRX",
+  shortName: "FRX",
+  microTag: "VOL. 04",
+  description:
+    "Limited-run streetwear and graphic apparel. Designed in Accra, dropped weekly, shipped worldwide.",
+  schemaType: "Store",
+
+  currency: "GHS",
+  locale: "en_GH",
+
+  contact: {
+    address: "Osu Oxford Street, Accra",
+    streetAddress: "Osu Oxford Street",
+    city: "Accra",
+    countryCode: "GH",
+    phone: "+233 244 000 000",
+    phoneTel: "+233244000000",
+    email: "hello@studiofrx.test",
+    privacyEmail: "privacy@studiofrx.test",
+    supportEmail: "help@studiofrx.test",
+    hours: "Tue–Sat · 11am–8pm",
+  },
+
+  socials: [
+    { label: "Instagram", href: "https://instagram.com/studiofrx", icon: "instagram" },
+    { label: "TikTok", href: "https://tiktok.com/@studiofrx", icon: "tiktok" },
+    { label: "X", href: "https://x.com/studiofrx", icon: "x" },
+    { label: "YouTube", href: "https://youtube.com/@studiofrx", icon: "youtube" },
+  ],
+
+  header: {
+    nav: [
+      { label: "New", href: "/categories/new-arrivals" },
+      { label: "Drops", href: "/collections/latest-drop" },
+      { label: "Shop", href: "/shop" },
+      { label: "Lookbook", href: "/about" },
+    ],
+  },
+
+  hero: {
+    badge: "Drop 04 · Live now",
+    title: "Built for now.\nBuilt to last.",
+    subtitle:
+      "A 24-piece capsule of heavyweight cotton, garment-dyed in Tema, screen-printed by hand. Every piece signed and numbered.",
+    primaryCtaLabel: "Shop the drop",
+    secondaryCtaLabel: "View the lookbook",
+    secondaryCtaHref: "/about",
+  },
+
+  trustItems: [
+    {
+      label: "Shipping",
+      value: "Free worldwide over $80",
+      description: "DHL Express, 2–4 business days.",
+      iconKey: "delivery",
+    },
+    {
+      label: "Returns",
+      value: "30 days, on us",
+      description: "Free returns from the US, UK, and EU.",
+      iconKey: "warranty",
+    },
+    {
+      label: "Sizing",
+      value: "True-to-size, oversized",
+      description: "Charts on every product page.",
+      iconKey: "verified",
+    },
+    {
+      label: "Made",
+      value: "In Tema, Ghana",
+      description: "Heavyweight cotton, garment-dyed.",
+      iconKey: "support",
+    },
+  ],
+
+  brandStrip: {
+    headline: "Stocked at",
+    brands: ["VOGUE", "HIGHSNOBIETY", "GQ", "DAZED", "i-D", "COMPLEX", "HYPEBEAST"],
+  },
+
+  promo: {
+    badge: "Drop 04 · 412 left",
+    title: "The Heavyweight Hoodie. Now in 4 colourways.",
+    body: "500gsm garment-dyed cotton. Hand-screened FRX seal. Numbered run of 600 pieces — when they're gone, they're gone.",
+    ctaLabel: "Shop the hoodie",
+    ctaHref: "/shop",
+  },
+
+  tradeIn: {
+    eyebrow: "Studio collective",
+    title: "Wear the studio.\nBe in the studio.",
+    body: "Every drop ships with a single-use code that gets you behind the scenes — early access to the next drop, in-person Accra studio days, and a slot on our private design call.",
+    primaryCtaLabel: "Join the collective",
+    primaryCtaHref: "/about",
+    secondaryCtaLabel: "How it works",
+    secondaryCtaHref: "/faq",
+    steps: [
+      { step: "01", title: "Order any piece", body: "Each piece ships with a one-time access code." },
+      { step: "02", title: "Activate online", body: "Two minutes. Membership unlocks instantly." },
+      { step: "03", title: "Be in the room", body: "Studio days, design calls, drop previews — for a year." },
+    ],
+  },
+
+  newsletter: {
+    eyebrow: "FRX list",
+    title: "First in line, always.",
+    body: "We drop quietly. The list gets a 24-hour head start, the linesheet a week before, and discount codes on collabs. Unsubscribe in one click.",
+    placeholder: "you@email.com",
+    submitLabel: "Join the list",
+    successLabel: "On the list ✓",
+  },
+
+  about: {
+    eyebrow: "About Studio FRX",
+    title: "Apparel from\nthe other side.",
+    paragraphs: [
+      "Studio FRX started in 2021 in a converted shipping container in Osu, with a single Riley screen press and a stack of 14oz cotton blanks. We make heavyweight, hand-screened streetwear — graphic-led, garment-dyed, numbered.",
+      "We don't restock. Each drop is a closed run — between 200 and 800 pieces — with the production, dye batch, and screen burn documented on the inside hem. When a drop ends, we move on.",
+      "Made in Tema. Shipped worldwide. Pictured on the people you see in our feed — most of whom are on the list.",
+    ],
+    sections: [
+      {
+        heading: "The collective",
+        body: "Every order activates a year of access — drop previews, in-person studio days, and a seat on our monthly design call. Not a discount programme. A studio.",
+      },
+      {
+        heading: "Sizing",
+        body: "Our pieces are cut for an oversized, dropped-shoulder fit. Order true to size if you want oversized; size down for a regular fit. Charts on every product page.",
+      },
+      {
+        heading: "Visit",
+        body: "Osu Oxford Street, Accra · Tue–Sat, 11am–8pm. We open the studio for fittings by appointment.",
+      },
+    ],
+  },
+
+  faq: {
+    eyebrow: "Q&A",
+    title: "Things people ask.",
+    sections: [
+      {
+        title: "Sizing & fit",
+        items: [
+          {
+            q: "How do I find my size?",
+            a: "Every product page has a size chart with chest, length, and shoulder measurements. Our pieces fit oversized — order true to size for the intended fit, or size down for a regular cut.",
+          },
+          {
+            q: "Do you offer larger sizes?",
+            a: "Most pieces run S–3XL. A few drops are smaller — XS–XL — and that's flagged on the product page.",
+          },
+          {
+            q: "What if it doesn't fit?",
+            a: "Free returns within 30 days from the US, UK, and EU. Anywhere else, return shipping is on you, but we'll refund or exchange immediately.",
+          },
+        ],
+      },
+      {
+        title: "Shipping & delivery",
+        items: [
+          {
+            q: "How fast is shipping?",
+            a: "DHL Express worldwide. 2–4 business days from when you order. Free over $80 (or local equivalent).",
+          },
+          {
+            q: "Do you ship to my country?",
+            a: "We ship to 80+ countries via DHL. Enter your address at checkout to see rates and ETA.",
+          },
+          {
+            q: "Customs and duties?",
+            a: "Charged on delivery in some countries — DHL will contact you. We can prepay for orders over $300; email help@studiofrx.test before placing the order.",
+          },
+        ],
+      },
+      {
+        title: "Drops & restocks",
+        items: [
+          {
+            q: "Will you restock my size?",
+            a: "No. Every drop is a closed run, numbered and dated. When a size sells out, it's gone.",
+          },
+          {
+            q: "How do I find out about the next drop?",
+            a: "Join the FRX list. You get 24 hours of head-start before each drop opens to the public.",
+          },
+          {
+            q: "Do you ever do collabs?",
+            a: "Two or three a year. They're announced on the list first, then on Instagram. Most sell out the same day.",
+          },
+        ],
+      },
+      {
+        title: "Returns",
+        items: [
+          {
+            q: "What's your return policy?",
+            a: "30 days from delivery. Item must be unworn, with original tags. Underwear and final-sale items aren't returnable.",
+          },
+          {
+            q: "How do I start a return?",
+            a: "Email help@studiofrx.test with your order number. We'll email a prepaid label (US/UK/EU) or instructions.",
+          },
+        ],
+      },
+    ],
+    contactPrompt: "Anything else? Email",
+    contactEmail: "help@studiofrx.test",
+  },
+
+  terms: {
+    eyebrow: "Terms of service",
+    title: "Terms of Service",
+    lastUpdated: "1 May 2026",
+    sections: [
+      {
+        heading: "1. Who we are",
+        body: "Studio FRX (\"we\", \"us\") is an apparel studio operating from Osu, Accra, Ghana. By placing an order on this site, you (\"you\", \"customer\") agree to these terms.",
+      },
+      {
+        heading: "2. Limited drops",
+        body: "Every product is part of a closed, numbered run. We do not restock. Pricing reflects the numbered nature of each drop.",
+      },
+      {
+        heading: "3. Pricing and payment",
+        body: "Prices are displayed in your local currency where supported (auto-detected at checkout). Payment is taken at the time of order via card or Mobile Money.",
+      },
+      {
+        heading: "4. Shipping",
+        body: "DHL Express worldwide. Customs and duties are the customer's responsibility unless prepaid options are available at checkout.",
+      },
+      {
+        heading: "5. Returns",
+        body: "30-day return window from delivery date. Items must be unworn with original tags. Underwear, sale items, and bespoke pieces are final.",
+      },
+      {
+        heading: "6. Intellectual property",
+        body: "All graphics, prints, and product designs are original works of Studio FRX. Reproduction or commercial use without written permission is prohibited.",
+      },
+      {
+        heading: "7. Liability",
+        body: "Our maximum liability for any order is the value of that order. We're not liable for indirect or consequential losses.",
+      },
+      {
+        heading: "8. Governing law",
+        body: "These terms are governed by the laws of Ghana. Disputes are resolved in the courts of Greater Accra.",
+      },
+      {
+        heading: "9. Contact",
+        body: "Questions? Email hello@studiofrx.test.",
+      },
+    ],
+  },
+
+  privacy: {
+    eyebrow: "Privacy",
+    title: "Privacy Policy",
+    lastUpdated: "1 May 2026",
+    sections: [
+      {
+        heading: "What we collect",
+        body: "Order details (name, address, phone, email), garment measurements if you fill our size finder, and payment data via our processors (Paystack, Stripe). We do not store payment cards on our servers.",
+      },
+      {
+        heading: "How we use it",
+        body: {
+          intro: "We use your data to:",
+          bullets: [
+            "Fulfil and ship your order.",
+            "Send order updates by SMS and email.",
+            "Send drop announcements (only if you opted in).",
+            "Improve sizing recommendations across the catalogue.",
+          ],
+        },
+      },
+      {
+        heading: "Who we share it with",
+        body: "DHL (shipping), Paystack/Stripe (payments), and our email/SMS providers. We do not sell or rent personal data.",
+      },
+      {
+        heading: "Cookies",
+        body: "Strictly-necessary cookies for cart and session, plus optional analytics (toggleable in our cookie banner).",
+      },
+      {
+        heading: "Your rights",
+        body: "Under the Ghana Data Protection Act, 2012 (Act 843), you have the right to access, correct, or delete your data. Email privacy@studiofrx.test.",
+      },
+      {
+        heading: "Retention",
+        body: "Order records: 7 years (tax law). Marketing list: until you unsubscribe.",
+      },
+    ],
+  },
+
+  footer: {
+    blurb:
+      "Limited-run streetwear from Accra. Heavyweight cotton, hand-screened, numbered. Each drop is a closed run.",
+    sitemap: [
+      {
+        title: "Shop",
+        links: [
+          { label: "All products", href: "/shop" },
+          { label: "New arrivals", href: "/categories/new-arrivals" },
+          { label: "Hoodies", href: "/categories/hoodies" },
+          { label: "Tees", href: "/categories/tees" },
+          { label: "Outerwear", href: "/categories/outerwear" },
+          { label: "Drops", href: "/collections/latest-drop" },
+        ],
+      },
+      {
+        title: "Studio",
+        links: [
+          { label: "About", href: "/about" },
+          { label: "The collective", href: "/about" },
+          { label: "Lookbook", href: "/about" },
+          { label: "Press", href: "mailto:press@studiofrx.test" },
+        ],
+      },
+      {
+        title: "Help",
+        links: [
+          { label: "Contact", href: "mailto:help@studiofrx.test" },
+          { label: "Sizing", href: "/faq" },
+          { label: "Shipping", href: "/faq" },
+          { label: "Returns", href: "/faq" },
+        ],
+      },
+      {
+        title: "Legal",
+        links: [
+          { label: "Terms of Service", href: "/terms" },
+          { label: "Privacy Policy", href: "/privacy" },
+        ],
+      },
+    ],
+    poweredBy: { label: "Cimplify", href: "https://app.cimplify.io" },
+  },
+
+  llms: {
+    summary:
+      "Studio FRX — limited-run streetwear from Accra. Heavyweight cotton garment-dyed in Tema and hand-screened. Closed runs only — no restocks. Free worldwide shipping over $80, 30-day returns from US/UK/EU.",
+  },
+
+  mock: {
+    seed: "retail",
+    businessId: "bus_currents_electronics",
+  },
+};

package/templates/storefront-fashion/lib/cart.ts

@@ -0,0 +1,27 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { useCimplifyClient } from "@cimplify/sdk/react";
+
+/**
+ * Tiny hook for the live cart-count pill in the header. Re-fetches on
+ * mount and exposes a refresh callback. The SDK's `useCart` hook is
+ * fine-grained but heavier — this is enough for a header badge.
+ */
+export function useCartCount(): { count: number; refresh: () => void } {
+  const { client } = useCimplifyClient();
+  const [count, setCount] = useState(0);
+
+  const refresh = () => {
+    void client.cart.getCount().then((r) => {
+      if (r.ok) setCount(r.value);
+    });
+  };
+
+  useEffect(() => {
+    refresh();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [client]);
+
+  return { count, refresh };
+}

package/templates/storefront-fashion/next.config.ts

@@ -0,0 +1,40 @@
+import type { NextConfig } from "next";
+
+const MOCK_URL = process.env.NEXT_PUBLIC_CIMPLIFY_API_URL?.trim() || "http://127.0.0.1:8787";
+
+/**
+ * Same-origin proxy to the Cimplify mock so the browser never makes a
+ * cross-origin request in dev (no CORS preflights, no flaky `Origin`
+ * mismatches). The SDK's base URL stays empty/relative — requests go to
+ * `/api/v1/...` on the Next origin, then this rewrite forwards them to
+ * the mock at `127.0.0.1:8787`.
+ *
+ * In production, point `NEXT_PUBLIC_CIMPLIFY_API_URL` at your Cimplify
+ * host and the rewrite continues to work the same way (or remove it and
+ * pass the absolute URL through `<CimplifyProvider/>`).
+ */
+const nextConfig: NextConfig = {
+  // Enable Next 16's `cacheComponents` mode so we can use `'use cache'` +
+  // `cacheTag` / `cacheLife` for SSR caching. Cached chrome streams first,
+  // dynamic Suspense boundaries fill in when ready.
+  cacheComponents: true,
+  async rewrites() {
+    return [
+      { source: "/api/v1/:path*", destination: `${MOCK_URL}/api/v1/:path*` },
+      { source: "/img/:path*", destination: `${MOCK_URL}/img/:path*` },
+      { source: "/elements/:path*", destination: `${MOCK_URL}/elements/:path*` },
+      { source: "/_mock/:path*", destination: `${MOCK_URL}/_mock/:path*` },
+    ];
+  },
+  images: {
+    remotePatterns: [
+      { protocol: "http", hostname: "127.0.0.1", port: "8787", pathname: "/img/**" },
+      { protocol: "http", hostname: "localhost", port: "8787", pathname: "/img/**" },
+      { protocol: "http", hostname: "localhost", port: "3000", pathname: "/img/**" },
+      { protocol: "https", hostname: "loremflickr.com", pathname: "/**" },
+      { protocol: "https", hostname: "images.unsplash.com", pathname: "/**" },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/storefront-fashion/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "__STOREFRONT_NAME__",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "dev": "concurrently -k -n mock,next -c blue,magenta \"bunx @cimplify/sdk --seed retail --quiet\" \"next dev\"",
+    "dev:storefront": "next dev",
+    "dev:mock": "bunx @cimplify/sdk --seed retail",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@cimplify/sdk": "^0.40.1",
+    "next": "^16.2.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.2.4",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "concurrently": "^9.0.0",
+    "tailwindcss": "^4.2.4",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/storefront-fashion/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/storefront-fashion/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront-grocery/.env.example

@@ -0,0 +1,16 @@
+# Cimplify API base URL.
+# Dev: leave empty so the SDK uses the current origin (localhost:3000),
+# which Next.js rewrites to the mock at 127.0.0.1:8787 (see next.config.ts).
+# Production: set to your Cimplify host (e.g. https://api.cimplify.io).
+NEXT_PUBLIC_CIMPLIFY_API_URL=
+
+# Tenant public key. The mock accepts any value.
+NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
+
+# Business id used by the mock seed (grocery: FreshMart).
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_freshmart
+
+# Canonical public site URL — used by sitemap.xml, robots.txt, llms.txt,
+# and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
+# via VERCEL_URL but Next prefers an explicit value).
+NEXT_PUBLIC_SITE_URL=https://example.com

package/templates/storefront-grocery/AGENTS.md

@@ -0,0 +1,39 @@
+# AGENTS.md — Grocery storefront template
+
+If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this storefront, **start here.**
+
+## TL;DR for rebranding
+
+1. **Edit `lib/brand.ts`** — every visible string lives here.
+2. **Edit `app/globals.css`** — `@theme { … }` for palette + radius.
+3. **Edit `.env.local`** — `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_freshmart` for the bundled seed.
+
+## Aesthetic
+
+Approachable grocer — Trader Joe's / Whole Foods / abundant-feel:
+
+- **Inter sans only** (no serif) — friendly, readable for dense product grids.
+- **Fresh green + cream**: vibrant green primary, warm cream background.
+- **Generous radius**: `0.875rem` — softer than retail.
+- **Bold, slightly heavy** headings.
+
+## Industry-specific copy patterns
+
+- `brand.hero.badge` is `"Free delivery over GH₵150"` — pricing-led trust signal.
+- `brand.hero.primaryCtaLabel` is `"Shop the aisle"`.
+- `brand.tradeIn` is omitted.
+- `brand.faq` covers delivery slots, sourcing/quality, subscription boxes.
+- Schema.org type is `GroceryStore`.
+
+## Mock seed
+
+Wired to `--seed grocery` (FreshMart).
+
+## Quick start
+
+```bash
+bun install
+bun dev
+```
+
+Open <http://localhost:3000>.

package/templates/storefront-grocery/README.md

@@ -0,0 +1,73 @@
+# __STOREFRONT_NAME__
+
+A Cimplify storefront scaffolded from the **bakery** template — Next.js 16 (App Router), React 19, Tailwind v4. Warm food-styled palette, Playfair Display + Inter typography, designed for bakeries, pâtisseries, and food businesses.
+
+For a different industry, scaffold with `--template`:
+
+```bash
+bunx @cimplify/sdk init my-store --template retail   # electronics / consumer goods
+bunx @cimplify/sdk init my-store --template bakery   # default — food / pâtisserie
+```
+
+## Run
+
+```bash
+bun install
+bun dev
+```
+
+Two things start in parallel:
+
+- `bunx @cimplify/sdk` — the Cimplify mock API on `http://127.0.0.1:8787` (Akua's Bakery seeded by default).
+- `next dev` — this storefront on `http://localhost:3000`.
+
+Open the storefront in your browser. Edit `app/page.tsx` to start customising. The SDK ships full pages (`<CataloguePage>`, `<ProductPage>`, `<CartPage>`, `<CheckoutPage>`) and layouts (`<DefaultProductLayout>`, `<FoodProductLayout>`, etc.) that you can swap in.
+
+## Structure
+
+```
+app/
+  layout.tsx              # root layout, fonts, providers, header/footer/modal
+  page.tsx                # home
+  shop/page.tsx           # full catalogue (SDK <CataloguePage/>)
+  collections/[slug]/     # collection landing
+  categories/[slug]/      # category landing
+  cart/page.tsx           # SDK <CartPage/>
+  checkout/page.tsx       # SDK <CheckoutPage/>
+  orders/[id]/page.tsx    # post-checkout thank-you
+  globals.css             # Tailwind import + theme tokens
+components/
+  providers.tsx           # CimplifyProvider client wrapper
+  header.tsx, footer.tsx, hero.tsx
+  store-product-card.tsx  # SDK <ProductCard/> wired to URL-driven modal
+  product-modal.tsx       # ?product=<slug> deep-linkable modal
+  collection-strip.tsx    # horizontal product strip
+  category-grid.tsx       # SDK <CategoryGrid/> with router navigation
+lib/
+  cart.ts                 # useCartCount() for the header pill
+```
+
+## Switch seed
+
+```bash
+bunx @cimplify/sdk --seed restaurant   # Mama's Kitchen
+bunx @cimplify/sdk --seed retail       # Currents Electronics
+bunx @cimplify/sdk --seed services     # Serene Spa
+bunx @cimplify/sdk --seed grocery      # FreshMart
+```
+
+Update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local` to match the seeded business.
+
+## Go live
+
+```diff
+# .env.local
+- NEXT_PUBLIC_CIMPLIFY_API_URL=http://127.0.0.1:8787
++ NEXT_PUBLIC_CIMPLIFY_API_URL=https://api.cimplify.io
+- NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
++ NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=<your tenant key>
+- NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_default_akua_bakery
++ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=<your business id>
+```
+
+Deploy to Vercel with one click — `next.config.ts` already whitelists the SDK image hosts under `images.remotePatterns`.