@cimplify/sdk 0.40.1 → 0.42.0

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

@@ -0,0 +1,373 @@
+/**
+ * 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[] };
+  shipping: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  returns: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  accessibility: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  account: {
+    loginEyebrow: string; loginTitle: string; loginSubtitle: string;
+    signupEyebrow: string; signupTitle: string; signupSubtitle: string;
+    accountEyebrow: string; accountTitle: string;
+  };
+  contactPage: {
+    eyebrow: string; title: string; body: string;
+    reasons: string[];
+    directLines: { label: string; value: string; href: string }[];
+  };
+  trackOrder: { eyebrow: string; title: string; body: string };
+  footer: {
+    blurb: string; sitemap: BrandSitemapSection[];
+    poweredBy?: { label: string; href: string };
+  };
+  llms: { summary: string };
+  mock: { seed: string; businessId: string };
+}
+
+export const brand: Brand = {
+  name: "FreshMart",
+  shortName: "FreshMart",
+  microTag: "GROCER · ACCRA",
+  description:
+    "Local produce, weekly basket boxes, and pantry staples — delivered to your door across Greater Accra.",
+  schemaType: "GroceryStore",
+
+  currency: "GHS",
+  locale: "en_GH",
+
+  contact: {
+    address: "Achimota Market, Accra",
+    streetAddress: "Achimota Market",
+    city: "Accra",
+    countryCode: "GH",
+    phone: "+233 244 555 100",
+    phoneTel: "+233244555100",
+    email: "hello@freshmart.test",
+    privacyEmail: "privacy@freshmart.test",
+    hours: "Mon–Sat · 7am–9pm · Sun 8am–7pm",
+  },
+
+  socials: [
+    { label: "Instagram", href: "https://instagram.com/freshmart", icon: "instagram" },
+    { label: "Facebook", href: "https://facebook.com/freshmart", icon: "facebook" },
+    { label: "WhatsApp", href: "https://wa.me/233244555100", icon: "whatsapp" },
+  ],
+
+  header: {
+    nav: [
+      { label: "Shop", href: "/shop" },
+      { label: "Weekly box", href: "/categories/baskets" },
+      { label: "Deals", href: "/categories/deals" },
+      { label: "About", href: "/about" },
+    ],
+  },
+
+  hero: {
+    badge: "Free delivery over GH₵150",
+    title: "Fresh today.\nIn your kitchen by 5pm.",
+    subtitle:
+      "Local produce, weekly basket boxes, and pantry staples — sourced from Ghanaian farms, packed this morning, delivered today.",
+    primaryCtaLabel: "Shop the aisle",
+    secondaryCtaLabel: "Build a basket box",
+    secondaryCtaHref: "/categories/baskets",
+  },
+
+  trustItems: [
+    { label: "Delivery", value: "Same-day in Accra", description: "Order before 2pm, in your kitchen by 5pm.", iconKey: "delivery" },
+    { label: "Sourcing", value: "Direct from farms", description: "70% of produce from Volta + Eastern Region.", iconKey: "verified" },
+    { label: "Returns", value: "Anything off, refund", description: "Quality-guaranteed, no questions asked.", iconKey: "warranty" },
+    { label: "Subscribe", value: "Weekly basket box", description: "Pause or skip any week.", iconKey: "support" },
+  ],
+
+  promo: {
+    badge: "This week",
+    title: "Tomato season — GH₵12/kg, today only.",
+    body: "Roma, plum, and Volta cherry — direct from Akwapim farmers, picked this morning. Stock up while it's at peak. Limit 5kg per order.",
+    ctaLabel: "Shop tomatoes",
+    ctaHref: "/categories/produce",
+  },
+
+  newsletter: {
+    eyebrow: "FreshMart weekly",
+    title: "What's in season, every Sunday.",
+    body: "We email a one-page roundup every Sunday: this week's deals, new produce, recipe of the week. Unsubscribe in one click.",
+    placeholder: "you@email.com",
+    submitLabel: "Get the weekly",
+    successLabel: "Subscribed ✓",
+  },
+
+  about: {
+    eyebrow: "About FreshMart",
+    title: "Local food,\nactually.",
+    paragraphs: [
+      "FreshMart started in 2022 as a stall at Achimota Market with one delivery rider and a notebook. Today we run a 600-square-metre warehouse and a fleet of nine refrigerated bikes, with one rule: if it's not in season locally, it doesn't lead our shelves.",
+      "70% of our produce comes from Ghanaian farms — Akwapim tomatoes, Volta-region pineapple, Brong-Ahafo yam, Nkawkaw plantain. The remaining 30% (citrus, certain herbs, dairy) we source from a tight set of partners we visit quarterly.",
+      "Order online by 2pm; we deliver same-day across Greater Accra. Subscribe to our weekly basket box and we'll curate a mix of in-season produce, dairy, and pantry staples every Tuesday or Friday.",
+    ],
+    sections: [
+      {
+        heading: "The basket box",
+        body: "GH₵180 for the small (feeds 2 for a week), GH₵320 for the family (feeds 4). Tuesday or Friday delivery. Pause, skip, or cancel any week from your account.",
+      },
+      {
+        heading: "Wholesale",
+        body: "Cafés, restaurants, and meal-prep operations: we deliver tiered-priced, predictable orders. Email wholesale@freshmart.test with your weekly volume and we'll quote.",
+      },
+      {
+        heading: "Visit",
+        body: "Achimota Market, Stalls 14–22. Mon–Sat 7am–9pm, Sun 8am–7pm.",
+      },
+    ],
+  },
+
+  faq: {
+    eyebrow: "Q&A",
+    title: "Things people ask.",
+    sections: [
+      {
+        title: "Ordering & delivery",
+        items: [
+          { q: "When will my order arrive?", a: "Order before 2pm — same-day delivery, in your kitchen by 5pm. After 2pm, next-day before 11am." },
+          { q: "Where do you deliver?", a: "Greater Accra, free over GH₵150. Outside Accra, next-day shipping via partner courier." },
+          { q: "Can I choose a delivery slot?", a: "Yes — 12pm, 3pm, or 5pm windows in Accra. Subscriber boxes deliver Tuesday or Friday morning." },
+          { q: "What if I'm not home?", a: "We coordinate with you by SMS and call. If there's no one, we hold the order at the warehouse and re-attempt the next day at no charge." },
+        ],
+      },
+      {
+        title: "Quality & sourcing",
+        items: [
+          { q: "How fresh is your produce?", a: "Most produce is picked the same day or the day before. We email batch dates with every order." },
+          { q: "Is it organic?", a: "We label every product clearly: \"organic\", \"low-spray\", or conventional. About 30% of our produce is certified organic; another 50% is low-spray traceable to specific farms." },
+          { q: "What if something arrives off?", a: "Send us a photo within 24 hours. We refund or replace, no questions asked." },
+        ],
+      },
+      {
+        title: "Subscriptions",
+        items: [
+          { q: "How does the basket box work?", a: "Pick small or family. Pick Tuesday or Friday delivery. We curate a mix of in-season produce, dairy, and pantry. Pause, skip, or cancel any week from your account." },
+          { q: "Can I customise the box?", a: "Yes — toggle dietary preferences (vegetarian, no-spice, low-carb) and exclude up to 3 items per week." },
+          { q: "What if I'm travelling?", a: "Pause the box for any number of weeks. We won't bill while paused." },
+        ],
+      },
+    ],
+    contactPrompt: "Other questions? Message us:",
+    contactEmail: "hello@freshmart.test",
+  },
+
+  terms: {
+    eyebrow: "Terms of service",
+    title: "Terms of Service",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "1. Who we are", body: "FreshMart (\"we\", \"us\") is a grocery business operating from Achimota Market, Accra. By placing an order, you (\"you\", \"customer\") agree to these terms." },
+      { heading: "2. Pricing & weights", body: "Prices in GH₵, by weight or unit as marked. Final price computed at checkout based on actual packed weight; we never charge more than 10% over the listed estimate." },
+      { heading: "3. Delivery", body: "Same-day in Greater Accra (orders before 2pm); next-day for orders after. Free over GH₵150." },
+      { heading: "4. Quality guarantee", body: "Anything off — wrong, spoiled, or not as described — refund or replacement, on us. Photo evidence within 24 hours." },
+      { heading: "5. Subscriptions", body: "Weekly basket boxes auto-renew. Pause, skip, or cancel before the next billing date with no penalty." },
+      { heading: "6. Liability", body: "Maximum liability for any order is its value. We're not liable for indirect or consequential losses." },
+      { heading: "7. Governing law", body: "These terms are governed by the laws of Ghana." },
+    ],
+  },
+
+  privacy: {
+    eyebrow: "Privacy",
+    title: "Privacy Policy",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "What we collect", body: "Order details (name, address, phone, email), delivery preferences, dietary toggles for subscriptions, and payment data via our processors. We do not store payment cards." },
+      { heading: "How we use it", body: { intro: "We use your data to:", bullets: [
+        "Pack and deliver your order.",
+        "Send delivery updates by SMS.",
+        "Curate weekly basket boxes (only for active subscribers).",
+        "Send our weekly roundup (only if you opted in).",
+      ] } },
+      { heading: "Who we share it with", body: "Payment processors (Paystack, Stripe), delivery riders, and our SMS provider. No one else." },
+      { heading: "Your rights", body: "Under the Ghana Data Protection Act, 2012 (Act 843), you can access, correct, or delete your data. Email privacy@freshmart.test." },
+      { heading: "Retention", body: "Order records: 7 years (tax). Subscription preferences: until you cancel + 90 days." },
+    ],
+  },
+
+  shipping: {
+    eyebrow: "Delivery",
+    title: "Delivery & Pickup",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "Same-day Greater Accra", body: "Order before 2pm — in your kitchen by 5pm. Free over GH₵150." },
+      { heading: "Slot windows", body: "Choose 12pm, 3pm, or 5pm in Accra. Subscriber boxes deliver Tuesday or Friday morning." },
+      { heading: "Outside Accra", body: "Next-day shipping via partner courier; rates and ETA at checkout." },
+      { heading: "Pickup", body: "Achimota Market, stalls 14–22. Free; ready 30 minutes after order." },
+    ],
+  },
+
+  returns: {
+    eyebrow: "Quality guarantee",
+    title: "Quality Guarantee & Refunds",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "Anything off, refund", body: "Wrong, spoiled, or not as described — we refund or replace, no questions asked. Send a photo within 24 hours of delivery." },
+      { heading: "Pricing by weight", body: "Final price is computed at packing. We never charge more than 10% over the listed estimate; if the actual is more, we trim or call you." },
+      { heading: "Subscription pause", body: "Pause, skip, or cancel any week before the next billing date." },
+    ],
+  },
+
+  accessibility: {
+    eyebrow: "Accessibility",
+    title: "Accessibility Statement",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "Online", body: "We aim for WCAG 2.1 AA on this site." },
+      { heading: "At Achimota Market", body: "Our stalls are at ground level. The market itself has step-free pathways; ask any staff member to direct you." },
+      { heading: "Reporting issues", body: "Email accessibility@freshmart.test. We respond within 5 business days." },
+    ],
+  },
+
+  account: {
+    loginEyebrow: "Welcome back",
+    loginTitle: "Sign in to FreshMart",
+    loginSubtitle: "Manage orders, your weekly box, and your delivery preferences.",
+    signupEyebrow: "Welcome",
+    signupTitle: "Create your account",
+    signupSubtitle: "Save addresses, set dietary preferences, and manage your weekly basket box.",
+    accountEyebrow: "Your account",
+    accountTitle: "Welcome back",
+  },
+
+  contactPage: {
+    eyebrow: "Contact",
+    title: "How can we help?",
+    body: "Order question, subscription change, or wholesale enquiry — we'll reply within a business day.",
+    reasons: ["General question", "An order issue", "Weekly box subscription", "Wholesale", "Press / partnerships", "Something else"],
+    directLines: [
+      { label: "Email", value: "hello@freshmart.test", href: "mailto:hello@freshmart.test" },
+      { label: "Phone", value: "+233 244 555 100", href: "tel:+233244555100" },
+      { label: "WhatsApp", value: "+233 244 555 100", href: "https://wa.me/233244555100" },
+    ],
+  },
+
+  trackOrder: {
+    eyebrow: "Track an order",
+    title: "Where's my order?",
+    body: "Enter your order number and the email used at checkout. We'll show the picking status, the rider, and the live ETA.",
+  },
+
+  footer: {
+    blurb:
+      "Local produce, weekly basket boxes, and pantry staples. Sourced from Ghanaian farms, delivered same-day across Accra.",
+    sitemap: [
+      {
+        title: "Shop",
+        links: [
+          { label: "All products", href: "/shop" },
+          { label: "Produce", href: "/categories/produce" },
+          { label: "Dairy & eggs", href: "/categories/dairy" },
+          { label: "Pantry", href: "/categories/pantry" },
+          { label: "Frozen", href: "/categories/frozen" },
+          { label: "Deals", href: "/categories/deals" },
+        ],
+      },
+      {
+        title: "Subscribe",
+        links: [
+          { label: "Weekly basket box", href: "/categories/baskets" },
+          { label: "How it works", href: "/about" },
+          { label: "Manage subscription", href: "/about" },
+        ],
+      },
+      {
+        title: "Help",
+        links: [
+          { label: "Contact", href: "/contact" },
+          { label: "Track an order", href: "/track-order" },
+          { label: "Delivery", href: "/shipping" },
+          { label: "Quality guarantee", href: "/returns" },
+          { label: "FAQ", href: "/faq" },
+        ],
+      },
+      {
+        title: "Account",
+        links: [
+          { label: "Sign in", href: "/login" },
+          { label: "Create account", href: "/signup" },
+          { label: "Your orders", href: "/account/orders" },
+          { label: "Settings", href: "/account/settings" },
+        ],
+      },
+      {
+        title: "Legal",
+        links: [
+          { label: "Terms of Service", href: "/terms" },
+          { label: "Privacy Policy", href: "/privacy" },
+          { label: "Accessibility", href: "/accessibility" },
+          { label: "Sitemap", href: "/sitemap-page" },
+        ],
+      },
+    ],
+    poweredBy: { label: "Cimplify", href: "https://app.cimplify.io" },
+  },
+
+  llms: {
+    summary:
+      "FreshMart — grocery delivery from Achimota Market, Accra. Direct-from-farm produce, weekly basket box subscriptions, pantry staples. Same-day delivery in Greater Accra; free over GH₵150. Pause-anytime subscriptions for households and wholesale tiers for cafés.",
+  },
+
+  mock: {
+    seed: "grocery",
+    businessId: "bus_freshmart",
+  },
+};

package/templates/storefront-grocery/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-grocery/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-grocery/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 grocery --quiet\" \"next dev\"",
+    "dev:storefront": "next dev",
+    "dev:mock": "bunx @cimplify/sdk --seed grocery",
+    "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-grocery/postcss.config.mjs

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

package/templates/storefront-grocery/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-restaurant/.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 (restaurant: Mama's Kitchen).
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_mamas_kitchen
+
+# 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-restaurant/AGENTS.md

@@ -0,0 +1,39 @@
+# AGENTS.md — Restaurant 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_mamas_kitchen` for the bundled seed.
+
+## Aesthetic
+
+Boutique restaurant — Sweetgreen / chef-table feel:
+
+- **Lora serif** for headings (warm, food-leaning).
+- **Inter** for body and UI.
+- **Forest green + cream**: deep sage primary, warm cream background, subtle warm accents.
+- **Mid-radius**: `0.625rem` — softer than retail, tighter than spa.
+
+## Industry-specific copy patterns
+
+- `brand.hero.badge` is `"Tonight's special · Banku & Tilapia"` — a daily-special call-out.
+- `brand.hero.primaryCtaLabel` is `"Reserve a table"`.
+- `brand.tradeIn` is omitted.
+- `brand.faq` covers reservations, dietary, delivery, allergens.
+- Schema.org type is `Restaurant`.
+
+## Mock seed
+
+Wired to `--seed restaurant` (Mama's Kitchen).
+
+## Quick start
+
+```bash
+bun install
+bun dev
+```
+
+Open <http://localhost:3000>.

package/templates/storefront-restaurant/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`.

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

@@ -0,0 +1,38 @@
+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;
+  const titleParts = a.title.split("\n");
+  return (
+    <article className="max-w-3xl mx-auto px-8 py-16">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2">
+        {a.eyebrow}
+      </p>
+      <h1 className="font-serif text-[clamp(2.25rem,5vw,3.5rem)] font-semibold mb-6 -tracking-[0.02em]">
+        {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="font-serif text-3xl font-semibold mt-10 mb-3">{s.heading}</h2>
+            <p>{s.body}</p>
+          </div>
+        ))}
+      </div>
+    </article>
+  );
+}