@cimplify/sdk 0.44.34 → 0.45.0

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

@@ -1,375 +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: "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

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

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

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