@cimplify/sdk 0.44.34 → 0.45.0

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

@@ -1,377 +0,0 @@
-/**
- * Brand & content configuration — single source of truth for every visible
- * string. Edit this file to rebrand. See ../AGENTS.md.
- */
-
-import type { SeedName } from "@cimplify/sdk/testing/suite";
-
-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: SeedName; businessId: string };
-}
-
-export const brand: Brand = {
-  name: "Mama's Kitchen",
-  shortName: "Mama's",
-  microTag: "EAST LEGON · ACCRA",
-  description:
-    "West African plates, prepared by our matriarchs, served family-style in East Legon. Dine in, take out, deliver.",
-  schemaType: "Restaurant",
-
-  currency: "GHS",
-  locale: "en_GH",
-
-  contact: {
-    address: "21 Adjiringanor Road, East Legon, Accra",
-    streetAddress: "21 Adjiringanor Road, East Legon",
-    city: "Accra",
-    countryCode: "GH",
-    phone: "+233 244 200 100",
-    phoneTel: "+233244200100",
-    email: "hello@mamaskitchen.test",
-    privacyEmail: "privacy@mamaskitchen.test",
-    hours: "Tue–Sun · 12pm–10pm · brunch Sat–Sun, 10am",
-  },
-
-  socials: [
-    { label: "Instagram", href: "https://instagram.com/mamaskitchen", icon: "instagram" },
-    { label: "TikTok", href: "https://tiktok.com/@mamaskitchen", icon: "tiktok" },
-    { label: "Facebook", href: "https://facebook.com/mamaskitchen", icon: "facebook" },
-    { label: "WhatsApp", href: "https://wa.me/233244200100", icon: "whatsapp" },
-  ],
-
-  header: {
-    nav: [
-      { label: "Menu", href: "/shop" },
-      { label: "Reservations", href: "/categories/reservations" },
-      { label: "About", href: "/about" },
-      { label: "FAQ", href: "/faq" },
-    ],
-  },
-
-  hero: {
-    badge: "Tonight's special · Banku & Tilapia",
-    title: "Family recipes,\nfamily tables.",
-    subtitle:
-      "Mama's serves the West African food we grew up with — banku, jollof, palaver sauce, suya — at one long table or to your door. Open Tuesday through Sunday.",
-    primaryCtaLabel: "Reserve a table",
-    secondaryCtaLabel: "See the menu",
-    secondaryCtaHref: "/shop",
-  },
-
-  trustItems: [
-    { label: "Reservations", value: "Same-week tables", description: "Bookings up to 21 days out.", iconKey: "verified" },
-    { label: "Delivery", value: "60-minute, in Accra", description: "Order before 9pm Tue–Sun.", iconKey: "delivery" },
-    { label: "Family-style", value: "Tables for 2 to 20", description: "Long table for 12 reservable.", iconKey: "support" },
-    { label: "Specials", value: "Daily off-menu", description: "Posted on Instagram by 11am.", iconKey: "warranty" },
-  ],
-
-  promo: {
-    badge: "Sunday only",
-    title: "The Long Lunch — three courses, one long table.",
-    body: "Sunday set lunch from 1pm. Three courses, family-style, GH₵180 per head. We send out the menu the Friday before; reserve any time on Saturday.",
-    ctaLabel: "Book the Long Lunch",
-    ctaHref: "/shop",
-  },
-
-  newsletter: {
-    eyebrow: "From the kitchen",
-    title: "Tonight's specials, in your inbox.",
-    body: "Daily specials, off-menu plates, and the events worth knowing about. One email a day, 5 days a week. Unsubscribe in one click.",
-    placeholder: "you@email.com",
-    submitLabel: "Subscribe",
-    successLabel: "Subscribed ✓",
-  },
-
-  about: {
-    eyebrow: "About Mama's",
-    title: "Family recipes,\nfamily tables.",
-    paragraphs: [
-      "Mama's started in 2019 around our grandmother's kitchen — a long table, a heavy stock pot of palaver sauce, and Sunday lunches that lasted three hours. We opened a public room in 2021 and brought the long table with us.",
-      "Every recipe on our menu was cooked first by someone in our family. We built the kitchen around them: three matriarchs lead our line, each in charge of the dishes they grew up making. We don't substitute spice blends. We grind ours from the same Volta-Region peppers Akua's grandmother used.",
-      "We're a small room — 38 covers, plus a long table for 12 reservable as a single party. Open Tuesday through Sunday. Brunch on weekends.",
-    ],
-    sections: [
-      {
-        heading: "The long table",
-        body: "Our 12-seater long table can be reserved as a single party on weekends and weekday evenings. It's the heart of the room. Booking opens three weeks in advance.",
-      },
-      {
-        heading: "Private events",
-        body: "We host private dinners (12–32 people) on Mondays when the public room is closed. Custom menus, full-room buy-out, in-room music. Email events@mamaskitchen.test.",
-      },
-      {
-        heading: "Visit",
-        body: "21 Adjiringanor Road, East Legon · Tue–Sun, 12pm–10pm. Brunch Sat–Sun from 10am.",
-      },
-    ],
-  },
-
-  faq: {
-    eyebrow: "Q&A",
-    title: "Things people ask.",
-    sections: [
-      {
-        title: "Reservations & seating",
-        items: [
-          { q: "How do I book a table?", a: "Online via the Reservations link, or message us on WhatsApp +233 244 200 100. Bookings open 21 days in advance." },
-          { q: "Do you take walk-ins?", a: "Yes — we keep half our tables for walk-ins. Best chance is between 12 and 2pm, or after 9pm." },
-          { q: "Can I book the long table?", a: "Yes — it seats 12 as a single party. Bookable for weekend lunches and weekday evenings, three weeks out." },
-          { q: "What's your cancellation policy?", a: "Free cancellation up to 4 hours before your reservation. After that we charge GH₵60 per cover for no-shows on parties of 6+." },
-        ],
-      },
-      {
-        title: "Menu & dietary",
-        items: [
-          { q: "Do you have vegetarian / vegan options?", a: "Yes — palaver sauce, kontomire stew, plantain, garden eggs. Half our menu is plant-based; the rest can be made vegetarian on request." },
-          { q: "How spicy is your food?", a: "Honestly: medium-hot to hot. Tell your server how you want it; the kitchen adjusts." },
-          { q: "Can you handle allergies?", a: "We're a kitchen, not a lab — we use peanuts, shellfish, dairy, and gluten daily. Tell us in advance and we'll cook around it where we can." },
-        ],
-      },
-      {
-        title: "Delivery & takeout",
-        items: [
-          { q: "Where do you deliver?", a: "Greater Accra, between 12pm and 9pm Tue–Sun. Free over GH₵250." },
-          { q: "How long does delivery take?", a: "60 minutes from order, give or take. We bake the jollof to order, so it arrives still steaming." },
-          { q: "Can I order ahead for pickup?", a: "Yes. Order online, choose a pickup time, and skip the queue." },
-        ],
-      },
-    ],
-    contactPrompt: "Other questions? Email",
-    contactEmail: "hello@mamaskitchen.test",
-  },
-
-  terms: {
-    eyebrow: "Terms of service",
-    title: "Terms of Service",
-    lastUpdated: "1 May 2026",
-    sections: [
-      { heading: "1. Who we are", body: "Mama's Kitchen (\"we\", \"us\") is a restaurant operating at 21 Adjiringanor Road, East Legon, Accra. By booking a table or placing an order, you (\"you\", \"guest\") agree to these terms." },
-      { heading: "2. Reservations", body: "Tables held with name + phone. Card guarantee required for parties of 6+." },
-      { heading: "3. Cancellations", body: "Free cancellation up to 4 hours ahead. Within 4 hours, parties of 6+ are charged GH₵60/cover for no-shows." },
-      { heading: "4. Pricing & payment", body: "Prices in GH₵ include VAT and 10% service. Card, mobile money, or cash. Tipping appreciated, never required." },
-      { heading: "5. Delivery", body: "60-minute window from confirmation. We're not liable for delays caused by traffic, weather, or events outside our control." },
-      { heading: "6. Allergens", body: "Our kitchen handles peanuts, shellfish, dairy, gluten. Cross-contamination is possible." },
-      { heading: "7. Liability", body: "Maximum liability for any reservation or order is the cost of that booking. We're not liable for indirect or consequential losses." },
-      { heading: "8. 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: "Reservation details (name, phone, party size, allergies if you share them), order details, 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: [
-        "Confirm and seat reservations.",
-        "Fulfil and deliver orders.",
-        "Send reminders by SMS.",
-        "Send specials (only if you opted in).",
-      ] } },
-      { heading: "Allergy notes", body: "Treated as sensitive — only the kitchen team handling your booking accesses these notes. Never shared." },
-      { heading: "Who we share it with", body: "Payment processors, our SMS provider, and the rider service for delivery. 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@mamaskitchen.test." },
-      { heading: "Retention", body: "Order records: 7 years (tax). Marketing list: until you unsubscribe." },
-    ],
-  },
-
-  shipping: {
-    eyebrow: "Delivery",
-    title: "Delivery & Pickup",
-    lastUpdated: "1 May 2026",
-    sections: [
-      { heading: "Greater Accra", body: "Same-day, 12pm–9pm Tue–Sun. Free over GH₵250; GH₵35 below. Typical 60-minute window from order." },
-      { heading: "Pickup", body: "Skip the queue: order ahead, pick a window, walk in. Free." },
-      { heading: "Catering & private events", body: "Off-site catering (12+ people) requires 5 days' notice. Email events@mamaskitchen.test." },
-    ],
-  },
-
-  returns: {
-    eyebrow: "Refunds",
-    title: "Refunds & Quality",
-    lastUpdated: "1 May 2026",
-    sections: [
-      { heading: "Quality guarantee", body: "If anything is wrong with your order — wrong dish, cold, off — message us within 2 hours and we'll replace, refund, or credit." },
-      { heading: "Reservation cancellations", body: "Free up to 4 hours before. Within 4 hours, parties of 6+ are charged GH₵60/cover for no-shows." },
-      { heading: "Custom event deposits", body: "Refundable up to 7 days before the event. Within 7 days, deposits are non-refundable." },
-    ],
-  },
-
-  accessibility: {
-    eyebrow: "Accessibility",
-    title: "Accessibility Statement",
-    lastUpdated: "1 May 2026",
-    sections: [
-      { heading: "In the dining room", body: "Step-free entrance, accessible bathroom, and a flat path from the curb. Service dogs welcome. We can move tables in advance — let us know at booking." },
-      { heading: "Online", body: "We aim for WCAG 2.1 AA on the website and test it on every release." },
-      { heading: "Reporting issues", body: "Email accessibility@mamaskitchen.test or call ahead — we respond within a business day." },
-    ],
-  },
-
-  account: {
-    loginEyebrow: "Welcome back",
-    loginTitle: "Sign in to Mama's",
-    loginSubtitle: "Pick up where you left off — orders, reservations, and your favourites.",
-    signupEyebrow: "Welcome",
-    signupTitle: "Create an account",
-    signupSubtitle: "Reorder in one tap, hold tables faster, and get first-look at the long-table evenings.",
-    accountEyebrow: "Your account",
-    accountTitle: "Welcome back",
-  },
-
-  contactPage: {
-    eyebrow: "Contact",
-    title: "Talk to the kitchen.",
-    body: "Reservation question, dietary need, private event — message us and we'll reply within a business day.",
-    reasons: ["Reservation question", "An order issue", "Dietary / allergens", "Private event", "Press / partnerships", "Something else"],
-    directLines: [
-      { label: "Email", value: "hello@mamaskitchen.test", href: "mailto:hello@mamaskitchen.test" },
-      { label: "Phone", value: "+233 244 200 100", href: "tel:+233244200100" },
-      { label: "WhatsApp", value: "+233 244 200 100", href: "https://wa.me/233244200100" },
-    ],
-  },
-
-  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 kitchen status, the rider, and the live ETA.",
-  },
-
-  footer: {
-    blurb:
-      "West African plates, prepared by our matriarchs, served family-style in East Legon. Dine in, take out, deliver.",
-    sitemap: [
-      {
-        title: "Menu",
-        links: [
-          { label: "Full menu", href: "/shop" },
-          { label: "Brunch", href: "/categories/brunch" },
-          { label: "Mains", href: "/categories/mains" },
-          { label: "Sides", href: "/categories/sides" },
-          { label: "Drinks", href: "/categories/drinks" },
-        ],
-      },
-      {
-        title: "Visit",
-        links: [
-          { label: "Reservations", href: "/categories/reservations" },
-          { label: "The long table", href: "/about" },
-          { label: "Private events", href: "mailto:events@mamaskitchen.test" },
-          { label: "Hours & location", href: "/about" },
-        ],
-      },
-      {
-        title: "Help",
-        links: [
-          { label: "Contact", href: "/contact" },
-          { label: "Track an order", href: "/track-order" },
-          { label: "Delivery", href: "/shipping" },
-          { label: "Refunds", 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:
-      "Mama's Kitchen — small West African restaurant in East Legon, Accra. Family-recipe banku, jollof, palaver sauce, suya. 38-cover dining room with a 12-seater long table. Open Tue–Sun, brunch on weekends. Reservations and delivery in Greater Accra.",
-  },
-
-  mock: {
-    seed: "restaurant",
-    businessId: "bus_mamas_kitchen",
-  },
-};

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

@@ -1,12 +0,0 @@
-"use client";
-
-import { useCart } from "@cimplify/sdk/react";
-
-/**
- * Reactive cart count for the header pill. Subscribes to the SDK cart
- * state — updates immediately on add / remove / quantity change.
- */
-export function useCartCount(): { count: number } {
-  const { itemCount } = useCart();
-  return { count: itemCount };
-}

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

@@ -1,42 +0,0 @@
-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: "/**" },
-      { protocol: "https", hostname: "static-tmp.cimplify.io", pathname: "/**" },
-      { protocol: "https", hostname: "cdn.cimplify.io", pathname: "/**" },
-    ],
-  },
-};
-
-export default nextConfig;

package/templates/storefront-restaurant/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "__STOREFRONT_NAME__",
-  "private": true,
-  "version": "0.0.0",
-  "scripts": {
-    "dev": "concurrently -k -n mock,next -c blue,magenta \"bunx @cimplify/sdk --seed restaurant --quiet\" \"next dev\"",
-    "dev:storefront": "next dev",
-    "dev:mock": "bunx @cimplify/sdk --seed restaurant",
-    "build": "next build",
-    "start": "next start",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "check:brand": "vitest run __tests__/brand.test.ts",
-    "check:cart": "vitest run __tests__/cart-flow.test.ts",
-    "check:contract": "vitest run __tests__/contract.test.ts",
-    "check": "bun run typecheck && bun run test:run"
-  },
-  "dependencies": {
-    "@cimplify/sdk": "^0.44.34",
-    "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",
-    "vitest": "^4.1.5"
-  }
-}

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

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

package/templates/storefront-restaurant/tsconfig.json

@@ -1,23 +0,0 @@
-{
-  "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/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    environment: "node",
-    include: ["__tests__/**/*.test.ts"],
-    globals: false,
-  },
-});

package/templates/storefront-retail/.claude/skills/cimplify-storefront/SKILL.md

@@ -1,145 +0,0 @@
----
-name: cimplify-storefront
-description: Build, customize, rebrand, or deploy a Cimplify-scaffolded storefront. Triggers when the user asks to create a storefront, rebrand a Cimplify template, change the palette, add a page, deploy to Cimplify, or works in a project containing `lib/brand.ts` and `next.config.ts` with `cacheComponents`.
----
-
-# Cimplify Storefront skill
-
-You're working on a project scaffolded from `bunx @cimplify/sdk init`. The architecture is opinionated and the rebrand surface is intentionally small. Read `AGENTS.md` at the project root for the file ↔ brand-field map for *this template's* industry; this skill gives you the playbook that's the same across all six.
-
-## The contract — never break
-
-1. **`lib/brand.ts` is the only place for content edits.** Every visible string reads from this file. If a string isn't in `brand`, *add a field* to the `Brand` interface — don't hardcode it in a page or component.
-2. **`app/globals.css` `@theme { … }`** holds palette + radius + font references. To re-skin the entire site, edit only this block.
-3. **Server Components are cached** via `'use cache'` + `cacheTag(tags.X())` + `cacheLife("hours")`. Don't downgrade them to `"use client"` to avoid an issue — fix the issue.
-4. **Client islands** (anything reading `useSearchParams`, `usePathname`, `useRouter`, `useState`) live behind `<Suspense>`.
-5. **`cacheComponents: true`** in `next.config.ts` is non-negotiable. Don't turn it off.
-6. **`bun run test:run` (vitest)** is the canonical test runner. `bun test` will show false failures because Bun's `vi` shim is incomplete.
-7. **Cart, checkout, orders stay client.** They're session-bound. Don't try to SSR them.
-
-## The brand-field schema (in `lib/brand.ts`)
-
-```
-identity:        name, shortName, microTag, description, schemaType, currency, locale
-contact:         address, streetAddress, city, countryCode, phone, phoneTel, email, privacyEmail, hours
-socials:         [{ label, href, icon }]   // icon ∈ instagram|x|tiktok|facebook|youtube|linkedin|whatsapp
-header:          { nav: [{ label, href }] }
-hero:            { badge, title, subtitle, primaryCtaLabel, secondaryCtaLabel?, secondaryCtaHref? }
-optional:        trustItems[]?, brandStrip?, promo?, tradeIn?     // render conditionally
-newsletter:      { eyebrow, title, body, placeholder, submitLabel, successLabel }
-about:           { eyebrow, title, paragraphs[], sections[{ heading, body }] }
-faq:             { eyebrow, title, sections[{ title, items[{ q, a }] }], contactPrompt, contactEmail }
-terms,
-privacy,
-shipping,
-returns,
-accessibility:   { eyebrow, title, lastUpdated, sections[{ heading, body | { intro, bullets[] } }] }
-account:         eyebrows + titles for /account, /login, /signup
-contactPage:     { eyebrow, title, body, reasons[], directLines[{ label, value, href }] }
-trackOrder:      { eyebrow, title, body }
-footer:          { blurb, sitemap[{ title, links[] }], poweredBy? }
-llms:            { summary }                           // opens /llms.txt
-mock:            { seed, businessId }
-```
-
-## Playbook — common tasks
-
-### Rebrand a storefront for a new merchant
-
-1. Edit `lib/brand.ts`. Replace every field with the merchant's content. Use the brief / context the user gave you.
-2. Edit `app/globals.css` `@theme { … }`. Change `--color-primary`, `--color-background`, `--color-foreground`, optionally `--radius`. Use OKLCH; if the brand only gave hex, convert.
-3. (Optional) Swap fonts in `app/layout.tsx` — `next/font/google` import + the variable wired into the `<html>` className.
-4. Set `.env.local`: `NEXT_PUBLIC_CIMPLIFY_API_URL`, `NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`, `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`, `NEXT_PUBLIC_SITE_URL`.
-
-Don't touch any other file. If the rebrand needs content not in the schema, add the field to `Brand` first, populate it, then read it from the page.
-
-### Add a new section / component
-
-1. Build it as a Server Component in `components/` (or a client island in `*-client.tsx` if interactive).
-2. Read merchant copy from `brand`. Add new fields to the `Brand` interface if needed.
-3. Wrap interactive bits in `<Suspense fallback={…}>` so the cached chrome streams.
-4. Compose into the page.
-
-### Wire a Server Action that mutates data
-
-```ts
-"use server";
-import { getServerClient, revalidateProducts } from "@cimplify/sdk/server";
-
-export async function createProduct(input: ProductInput) {
-  await getServerClient().catalogue.createProduct(input);
-  revalidateProducts();
-}
-```
-
-After every mutation, call the matching `revalidate*` helper from `@cimplify/sdk/server`: `revalidateProducts`, `revalidateProduct(id)`, `revalidateCategories`, `revalidateCategory(id)`, `revalidateCollections`, `revalidateCollection(id)`, `revalidateBusiness`.
-
-### Add a Server Component data fetch
-
-```ts
-import { cacheTag, cacheLife } from "next/cache";
-import { getServerClient, tags } from "@cimplify/sdk/server";
-
-async function getX() {
-  "use cache";
-  cacheTag(tags.products());
-  cacheLife("hours");
-  const r = await getServerClient().catalogue.getProducts({ limit: 24 });
-  if (!r.ok) throw new Error(r.error.message);
-  return r.value.items;
-}
-```
-
-### Eject an SDK component for deeper customization
-
-Try `classNames`, `renderImage`, `renderLink`, slot props first. If those run out:
-
-```bash
-bunx @cimplify/sdk eject --list
-bunx @cimplify/sdk eject product-card --dir src/components/cimplify
-```
-
-Once ejected, the file is yours. Hooks/types still come from `@cimplify/sdk`.
-
-### Deploy
-
-```bash
-bunx @cimplify/sdk login
-bunx @cimplify/sdk projects create my-store
-bunx @cimplify/sdk link <project-id>
-bunx @cimplify/sdk env push
-bunx @cimplify/sdk deploy --prod
-bunx @cimplify/sdk logs --follow
-bunx @cimplify/sdk domains add my-store.com
-```
-
-## Pitfalls — explicit ❌ list
-
-- ❌ Hardcoding any visible string in a page or component. Always `brand.X`.
-- ❌ Disabling `cacheComponents: true` to silence a warning. Fix the warning by wrapping the dynamic call in `<Suspense>`.
-- ❌ Using `unstable_cache` — Next 16's canonical primitive is `'use cache'` + `cacheTag` + `cacheLife`.
-- ❌ Bypassing `getServerClient()` and calling `createCimplifyClient` directly in a Server Component — loses per-request memoization.
-- ❌ Mutating data without calling the matching `revalidate*` helper.
-- ❌ Adding an `app/error.tsx` handler that calls `reset()` without logging — silently swallowed errors hide bugs.
-- ❌ Running `bun test` and reporting failures. Use `bun run test:run` (vitest).
-- ❌ Editing the per-template `AGENTS.md` to remove notes about TODOs (contact form, newsletter fake submits) — they're real.
-
-## Where things live
-
-| Need | Look here |
-|---|---|
-| Which page reads which `brand.X` field | `AGENTS.md` at project root |
-| Architectural rules | `AGENTS.md` at project root + this skill |
-| Running locally | `bun dev` (boots mock + Next together) |
-| Switching mock seed | edit `dev:mock` in `package.json` and `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local` |
-| Full SDK reference | `docs/sdk/storefronts.md` in the Cimplify repo |
-
-## What to do when the user asks something out-of-scope
-
-If the user asks for something the template doesn't support out of the box:
-
-1. **Check first** — is there an SDK component or hook that does it? `@cimplify/sdk/react` has 50+ components, 30+ hooks. Search `node_modules/@cimplify/sdk/dist/react.d.mts` if needed.
-2. **Compose from existing parts** before authoring new ones.
-3. **If genuinely missing** — build the new component, hoist its strings into `brand.ts`, document in `AGENTS.md`.
-
-Don't introduce competing patterns (a new caching strategy, a new auth flow, a new theming system). The template's opinions are intentional.