@cimplify/sdk 0.40.0 → 0.41.0

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

@@ -0,0 +1,453 @@
+/**
+ * Brand & content configuration — the **single source of truth** for every
+ * visible string in this storefront.
+ *
+ * To rebrand the entire site, edit this file. Every page, component,
+ * metadata block, JSON-LD object, sitemap, robots.txt, and llms.txt entry
+ * reads from `brand`.
+ *
+ * Schema is intentionally generous: optional fields (tradeIn, trustItems,
+ * brandStrip, promo) only render when present, so the same Brand type
+ * works across industry templates.
+ */
+
+export interface BrandSocial {
+  /** Display label (Instagram, X, YouTube, …). Used as aria-label and footer chip. */
+  label: string;
+  href: string;
+  /** Optional icon override — defaults to inline SVG keyed by `label`. */
+  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;
+  /** Plain prose, or { intro + bullets } for list-style sections. */
+  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: "Akua's Bakery",
+  shortName: "Akua's Bakery",
+  microTag: "ACCRA · SINCE 2018",
+  description:
+    "Sourdough, croissants, cakes, and more — handcrafted in East Legon, delivered across Accra.",
+  schemaType: "Bakery",
+
+  currency: "GHS",
+  locale: "en_GH",
+
+  contact: {
+    address: "12 Independence Ave, Accra",
+    streetAddress: "12 Independence Ave",
+    city: "Accra",
+    countryCode: "GH",
+    phone: "+233 244 000 000",
+    phoneTel: "+233244000000",
+    email: "hello@akuasbakery.test",
+    privacyEmail: "privacy@akuasbakery.test",
+    hours: "Tue–Sun · 8am–8pm · closed Mondays",
+  },
+
+  socials: [
+    { label: "Instagram", href: "https://instagram.com/akuasbakery", icon: "instagram" },
+    { label: "TikTok", href: "https://tiktok.com/@akuasbakery", icon: "tiktok" },
+    { label: "X", href: "https://x.com/akuasbakery", icon: "x" },
+    { label: "Facebook", href: "https://facebook.com/akuasbakery", icon: "facebook" },
+    { label: "WhatsApp", href: "https://wa.me/233244000000", icon: "whatsapp" },
+  ],
+
+  header: {
+    nav: [
+      { label: "Home", href: "/" },
+      { label: "Shop", href: "/shop" },
+      { label: "About", href: "/about" },
+      { label: "FAQ", href: "/faq" },
+    ],
+  },
+
+  hero: {
+    badge: "BAKERY · PÂTISSERIE · COFFEE",
+    title: "Fresh from the oven, every day.",
+    subtitle:
+      "Sourdough, croissants, cakes, and more — handcrafted in East Legon, delivered across Accra.",
+    primaryCtaLabel: "Shop the menu",
+  },
+
+  newsletter: {
+    eyebrow: "Stay in touch",
+    title: "Fresh bakes, in your inbox.",
+    body: "One email a week. New seasonal pastries, the cake of the month, and the limited drops you don't want to miss.",
+    placeholder: "you@email.com",
+    submitLabel: "Subscribe",
+    successLabel: "Subscribed ✓",
+  },
+
+  about: {
+    eyebrow: "Our story",
+    title: "Bread is a love letter.",
+    paragraphs: [
+      "Akua started baking in 2018 from a converted shipping container in East Legon, with a wood-fired oven, a 12-year-old sourdough starter, and a stubborn belief that good bread shouldn't be a luxury.",
+      "Today, we bake out of a 200-square-metre kitchen on Independence Avenue, milling our own heritage flour and supplying restaurants and homes across Greater Accra. Every loaf, every croissant, every cake is mixed, shaped, and baked by hand — usually by Akua, increasingly by a team of ten she trained from scratch.",
+      "We're proud to source over 90% of our ingredients within Ghana: flour from the Volta Region, butter from Tamale, hibiscus from local farmers we've worked with for years.",
+    ],
+    sections: [
+      {
+        heading: "What we believe",
+        body: "Slow over fast. 24-hour ferments, double proofs, cold lamination. Local first — Ghanaian wheat, Ghanaian dairy, Ghanaian hands. People over yield — every team member starts on the bench, learning the doughs by feel.",
+      },
+      {
+        heading: "Visit",
+        body: "12 Independence Ave, Accra · open Tuesday–Sunday, 8am–8pm. We close on Mondays so the team can rest and the ovens can rest.",
+      },
+    ],
+  },
+
+  faq: {
+    eyebrow: "Frequently asked",
+    title: "Questions, answered.",
+    sections: [
+      {
+        title: "Ordering & delivery",
+        items: [
+          {
+            q: "Where do you deliver?",
+            a: "Same-day delivery within Greater Accra for orders placed before 2pm. Outside Accra, we offer next-day shipping by partner courier — checkout will show the available options for your address.",
+          },
+          {
+            q: "Can I pick up my order?",
+            a: "Yes. Pickup is available 8am–8pm at our East Legon location, 12 Independence Avenue. Choose 'Pickup' at checkout and we'll have everything boxed and ready when you arrive.",
+          },
+          {
+            q: "How quickly will my order arrive?",
+            a: "Same-day delivery typically arrives within 2–4 hours of order confirmation. You'll get an SMS when the rider is en route.",
+          },
+          {
+            q: "Do you offer subscriptions?",
+            a: "Yes — our Weekly Loaf Subscription delivers a fresh loaf to your door every week. Pause or skip any time.",
+          },
+        ],
+      },
+      {
+        title: "Custom cakes & celebrations",
+        items: [
+          {
+            q: "How much notice do you need for a custom cake?",
+            a: "48 hours minimum for tier cakes; 7 days for elaborate designs with sugar work or fondant figures.",
+          },
+          {
+            q: "Can I bring my own design?",
+            a: "Absolutely — send us a reference image and we'll quote what's possible within your timeline and budget.",
+          },
+          {
+            q: "Do you do wedding cakes?",
+            a: "We do, with at least 6 weeks' notice. Tasting sessions are GH₵150 and credited toward your final order.",
+          },
+        ],
+      },
+      {
+        title: "Allergens & ingredients",
+        items: [
+          {
+            q: "Is your kitchen allergen-free?",
+            a: "No. Our kitchen handles wheat, dairy, eggs, and tree nuts. Cross-contamination is possible. Please let us know about severe allergies before ordering.",
+          },
+          {
+            q: "Do you have vegan options?",
+            a: "Yes. The country sourdough, whole-wheat seed loaf, baguette, and most of the breads are vegan.",
+          },
+        ],
+      },
+      {
+        title: "Payment & returns",
+        items: [
+          {
+            q: "What payment methods do you accept?",
+            a: "Mobile Money (MTN, Telecel, AirtelTigo), Visa/Mastercard, and cash on delivery for Accra-based orders.",
+          },
+          {
+            q: "What's your return policy?",
+            a: "We don't accept returns on baked goods for food-safety reasons, but if anything is wrong with your order — quality, accuracy, or freshness — message us within 24 hours and we'll make it right or refund you.",
+          },
+        ],
+      },
+    ],
+    contactPrompt: "Still stuck? Email",
+    contactEmail: "hello@akuasbakery.test",
+  },
+
+  terms: {
+    eyebrow: "Terms of service",
+    title: "Terms of Service",
+    lastUpdated: "1 May 2026",
+    sections: [
+      {
+        heading: "1. Who we are",
+        body: "Akua's Bakery (\"we\", \"us\") is a bakery and pâtisserie operating at 12 Independence Avenue, Accra, Ghana. By placing an order through this website, you (\"you\", \"customer\") agree to these terms.",
+      },
+      {
+        heading: "2. Orders and acceptance",
+        body: "Placing an order constitutes an offer to buy. We confirm acceptance by sending an order confirmation email or SMS. Until acceptance, we may decline an order — we'll refund any payment in full, immediately.",
+      },
+      {
+        heading: "3. Pricing and payment",
+        body: "Prices are in Ghana Cedis (GH₵) and include VAT where applicable. Payment is due at checkout via Mobile Money, card, or cash on delivery. We reserve the right to correct typographical pricing errors before fulfilment.",
+      },
+      {
+        heading: "4. Delivery and pickup",
+        body: "Delivery times are estimates, not guarantees. We're not liable for delays caused by weather, traffic, or events outside our control. If a rider can't reach you within 30 minutes of arrival, the order may be returned to the kitchen — please make sure your address and phone are correct.",
+      },
+      {
+        heading: "5. Custom cakes",
+        body: "Custom cake orders require a 50% deposit at booking and the balance before pickup or dispatch. Cancellations more than 72 hours before the event date receive a full refund of the deposit; within 72 hours, the deposit is non-refundable.",
+      },
+      {
+        heading: "6. Allergens",
+        body: "Our kitchen handles wheat, dairy, eggs, and tree nuts. We can't guarantee freedom from cross-contamination. Customers with severe allergies order at their own risk.",
+      },
+      {
+        heading: "7. Returns",
+        body: "Baked goods are non-returnable for food-safety reasons. If something is wrong with your order, contact us within 24 hours of delivery and we'll replace it, refund it, or credit your account — your choice.",
+      },
+      {
+        heading: "8. Liability",
+        body: "To the maximum extent permitted by Ghanaian law, our liability for any claim arising from this website or your order is limited to the value of the order. We're not liable for indirect or consequential losses.",
+      },
+      {
+        heading: "9. Governing law",
+        body: "These terms are governed by the laws of Ghana. Disputes will be resolved in the courts of Greater Accra.",
+      },
+      {
+        heading: "10. Contact",
+        body: "Questions? Email hello@akuasbakery.test.",
+      },
+    ],
+  },
+
+  privacy: {
+    eyebrow: "Privacy",
+    title: "Privacy Policy",
+    lastUpdated: "1 May 2026",
+    sections: [
+      {
+        heading: "What we collect",
+        body: "We collect only what we need to fulfil your order: your name, phone, delivery address, email, and the items in your order. Payment details are processed by our payment partners (Paystack, Stripe) and never stored on our servers.",
+      },
+      {
+        heading: "How we use it",
+        body: {
+          intro: "We use your data to:",
+          bullets: [
+            "Prepare, deliver, and confirm your order.",
+            "Send order updates by SMS and email.",
+            "Send occasional product news — only if you opted in. Unsubscribe anytime in one click.",
+            "Analyse aggregated, anonymised browsing patterns so we can improve the site.",
+          ],
+        },
+      },
+      {
+        heading: "Who we share it with",
+        body: "We share data only with the partners required to fulfil your order: payment processors (Paystack, Stripe), delivery riders, and our email/SMS providers. We do not sell or rent personal data to third parties — ever.",
+      },
+      {
+        heading: "Cookies",
+        body: "We use a small number of strictly-necessary cookies to keep your cart working and your session signed in. We don't use third-party advertising or tracking cookies.",
+      },
+      {
+        heading: "Your rights",
+        body: "Under the Ghana Data Protection Act, 2012 (Act 843), you have the right to access the data we hold about you, correct it, or have it deleted. Email privacy@akuasbakery.test and we'll respond within 14 days.",
+      },
+      {
+        heading: "Retention",
+        body: "We keep order records for 7 years to comply with Ghanaian tax law. Marketing-list opt-ins are kept until you unsubscribe.",
+      },
+      {
+        heading: "Changes",
+        body: "If we make material changes to this policy, we'll email customers on our marketing list and update the \"last updated\" date above.",
+      },
+    ],
+  },
+
+  footer: {
+    blurb:
+      "Family-run bakery in East Legon. Sourdough, croissants, layered cakes — handcrafted since 2018, delivered across Accra.",
+    sitemap: [
+      {
+        title: "Shop",
+        links: [
+          { label: "All products", href: "/shop" },
+          { label: "Breads", href: "/categories/breads" },
+          { label: "Pastries", href: "/categories/pastries" },
+          { label: "Cakes", href: "/categories/cakes" },
+          { label: "Drinks", href: "/categories/drinks" },
+          { label: "Merch & More", href: "/categories/merch" },
+          { label: "Classes & Stays", href: "/categories/classes" },
+        ],
+      },
+      {
+        title: "Bakery",
+        links: [
+          { label: "Our story", href: "/about" },
+          { label: "FAQ", href: "/faq" },
+          { label: "Visit us", href: "/about" },
+          { label: "Wholesale", href: "/categories/merch" },
+        ],
+      },
+      {
+        title: "Help",
+        links: [
+          { label: "Contact", href: "mailto:hello@akuasbakery.test" },
+          { label: "Custom cakes", href: "/faq" },
+          { label: "Allergens", href: "/faq" },
+          { label: "Delivery", 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:
+      "Family-run bakery in East Legon, Accra. Sourdough, croissants, cakes, and more — handcrafted since 2018. Same-day delivery across Greater Accra; pickup at 12 Independence Ave.",
+  },
+
+  mock: {
+    seed: "default",
+    businessId: "bus_default_akua_bakery",
+  },
+};

package/templates/storefront-fashion/.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 (retail: Currents Electronics).
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_currents_electronics
+
+# 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-fashion/AGENTS.md

@@ -0,0 +1,52 @@
+# AGENTS.md — Fashion / streetwear 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 reads from this file.
+2. **Edit `app/globals.css`** — the `@theme { … }` block holds the design tokens (palette, radius, font references). High-contrast neutrals + electric primary by default.
+3. **Edit `.env.local`** — `NEXT_PUBLIC_CIMPLIFY_API_URL`, `NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`, `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`, `NEXT_PUBLIC_SITE_URL`.
+
+## Aesthetic
+
+This template is built for streetwear / capsule fashion / lookbook-led brands (Nike, Aritzia, Highsnobiety, drop culture). Key design moves:
+
+- **Anton display typography** for hero + section titles (uppercase, condensed, heavy).
+- **Inter** for body and UI.
+- **High-contrast palette**: near-black foreground on near-white background, with one electric primary (default: `oklch(0.7 0.24 30)` — coral-orange).
+- **Sharp corners**: `--radius: 0.125rem` — minimal rounding, near-square inputs and buttons.
+- **Editorial full-bleed hero** with image gradient overlay (see `components/feature-hero.tsx`).
+- **Block-letter header** — no logo mark, just the shortName in display type with a microTag.
+
+## Industry-specific copy patterns
+
+The bundled brand presets:
+- `brand.hero.badge` is a "drop counter" (e.g. `"Drop 04 · Live now"`).
+- `brand.tradeIn` is repurposed as a "Studio collective" / membership programme.
+- `brand.brandStrip.headline` is `"Stocked at"` with editorial publication wordmarks (Vogue, Highsnobiety, etc.).
+- `brand.faq` covers sizing, drops/restocks, returns, customs.
+
+Replace these freely. The components render conditionally — set any optional block to `undefined` to hide it.
+
+## Rules
+
+- ✅ All content edits → `lib/brand.ts`
+- ✅ All design-token edits → `app/globals.css` `@theme` block
+- ✅ Server Components stay cached via `'use cache'` + `cacheTag(tags.X())` + `cacheLife("hours")`
+- ✅ Client islands behind `<Suspense>`
+- ❌ Don't hardcode strings.
+- ❌ Don't disable `cacheComponents: true`.
+
+## Mock seed
+
+Wired to `--seed retail` (Currents Electronics catalogue). Replace with apparel data in production. To preview a different seed, edit `dev:mock` in `package.json`.
+
+## Quick start
+
+```bash
+bun install
+bun dev
+```
+
+Open <http://localhost:3000>.

package/templates/storefront-fashion/README.md

@@ -0,0 +1,77 @@
+# __STOREFRONT_NAME__
+
+A Cimplify storefront scaffolded from the **retail** template — Next.js 16 (App Router), React 19, Tailwind v4. Cool navy + electric blue palette, Inter + JetBrains Mono typography, modern electronics-store aesthetic.
+
+## Run
+
+```bash
+bun install
+bun dev
+```
+
+Two things start in parallel:
+
+- `bunx @cimplify/sdk --seed retail` — the Cimplify mock API on `http://127.0.0.1:8787`, seeded with Currents Electronics.
+- `next dev` — this storefront on `http://localhost:3000`.
+
+Open the storefront in your browser. Edit `app/page.tsx` to start customising.
+
+## 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
+  about, faq, terms, privacy
+  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 the seed
+
+This template is wired to the `retail` seed. To preview a different industry without re-scaffolding:
+
+```bash
+bunx @cimplify/sdk --seed restaurant   # Mama's Kitchen
+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.
+
+For a fresh scaffold with another design altogether:
+
+```bash
+bunx @cimplify/sdk init my-store --template bakery     # warm food/pastry
+bunx @cimplify/sdk init my-store --template restaurant # coming soon
+bunx @cimplify/sdk init my-store --template services   # coming soon
+bunx @cimplify/sdk init my-store --template grocery    # coming soon
+```
+
+## 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_currents_electronics
++ 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`.

package/templates/storefront-fashion/app/about/page.tsx

@@ -0,0 +1,41 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `About — ${brand.name}`,
+  description: brand.description,
+};
+
+export default function AboutPage() {
+  const a = brand.about;
+  // Title supports a single \n for a hard line break.
+  const titleParts = a.title.split("\n");
+  return (
+    <article className="max-w-3xl mx-auto px-8 py-16">
+      <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary mb-2">
+        {a.eyebrow}
+      </p>
+      <h1 className="text-[clamp(2.25rem,5vw,3.5rem)] font-bold mb-6 -tracking-[0.025em] leading-tight">
+        {titleParts.map((line, i) => (
+          <span key={i}>
+            {line}
+            {i < titleParts.length - 1 && <br />}
+          </span>
+        ))}
+      </h1>
+      <div className="prose prose-lg max-w-none space-y-5 text-foreground/90 leading-relaxed">
+        {a.paragraphs.map((p, i) => (
+          <p key={i}>{p}</p>
+        ))}
+        {a.sections.map((s) => (
+          <div key={s.heading}>
+            <h2 className="text-2xl font-semibold mt-10 mb-3 -tracking-[0.02em]">
+              {s.heading}
+            </h2>
+            <p>{s.body}</p>
+          </div>
+        ))}
+      </div>
+    </article>
+  );
+}

package/templates/storefront-fashion/app/cart/page.tsx

@@ -0,0 +1,9 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { CartPage as SdkCartPage } from "@cimplify/sdk/react";
+
+export default function CartPage() {
+  const router = useRouter();
+  return <SdkCartPage onCheckout={() => router.push("/checkout")} />;
+}

package/templates/storefront-fashion/app/categories/[slug]/listing-client.tsx

@@ -0,0 +1,19 @@
+"use client";
+
+import { ProductGrid } from "@cimplify/sdk/react";
+import type { Product } from "@cimplify/sdk";
+import { StoreProductCard } from "@/components/store-product-card";
+
+/**
+ * Client island for the category listing. Receives server-fetched products
+ * as props (serializable) and owns the `renderCard` function.
+ */
+export function ListingClient({ products }: { products: Product[] }) {
+  return (
+    <ProductGrid
+      products={products}
+      emptyMessage="No products in this category yet."
+      renderCard={(p) => <StoreProductCard product={p} />}
+    />
+  );
+}