@cimplify/sdk 0.44.34 → 0.45.1

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

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

package/templates/storefront-bakery/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-bakery/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-fashion/.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.

package/templates/storefront-fashion/.cursor/rules/cimplify-storefront.mdc

@@ -1,25 +0,0 @@
----
-description: Cimplify storefront — architectural rules and rebrand contract for a project scaffolded from `bunx @cimplify/sdk init`. Triggers when files like lib/brand.ts, app/globals.css, components/header.tsx, or .cimplify/project.json are in the workspace.
-globs: ["lib/brand.ts", "app/**", "components/**", ".env.local", "next.config.ts"]
-alwaysApply: true
----
-
-# Cimplify storefront
-
-This project was scaffolded from a Cimplify template. Read `AGENTS.md` at the project root for the file ↔ `brand.X` field map and `.claude/skills/cimplify-storefront/SKILL.md` for the full playbook.
-
-## The contract
-
-1. **`lib/brand.ts`** — every visible string. If something isn't there, add a field to the `Brand` interface; don't hardcode.
-2. **`app/globals.css` `@theme` block** — palette, radius, font references.
-3. **Server Components are cached** via `'use cache'` + `cacheTag(tags.X())` + `cacheLife("hours")`. Don't downgrade to client to silence a warning.
-4. **Client islands** behind `<Suspense>`.
-5. **`cacheComponents: true`** in `next.config.ts` is non-negotiable.
-6. Use **`bun run test:run`** (vitest), not `bun test`.
-
-## Don't
-
-- Hardcode visible strings in pages/components.
-- Use `unstable_cache` (Next 16 uses `'use cache'`).
-- Bypass `getServerClient()` (loses per-request memoization).
-- Mutate without calling the matching `revalidate*` helper from `@cimplify/sdk/server`.

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

@@ -1,16 +0,0 @@
-# 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 (fashion: Studio FRX).
-NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_studio_frx
-
-# 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

@@ -1,126 +0,0 @@
-# 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 lives here.
-2. **Edit `app/globals.css`** — `@theme { … }` for palette + radius + font references.
-3. **Edit `.env.local`** — `NEXT_PUBLIC_CIMPLIFY_API_URL`, `NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`, `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`, `NEXT_PUBLIC_SITE_URL`.
-
-## Aesthetic
-
-Streetwear / lookbook-led brands (Nike, Aritzia, Highsnobiety, drop culture):
-
-- **Anton display + Inter** — uppercase condensed display, clean body sans.
-- **High-contrast palette** — near-black foreground on near-white background, electric primary (default coral, `oklch(0.7 0.24 30)`).
-- **Sharp corners**: `0.125rem` — minimal rounding.
-- **Editorial full-bleed hero** with image gradient overlay.
-- **Block-letter header** — no logo mark, just the shortName in display type.
-- Schema.org `@type` is `Store`.
-
-## Page surface
-
-```
-app/
-  page.tsx                       Multi-section home — full-bleed editorial hero,
-                                  trust bar, category tiles, promo banner,
-                                  "Just dropped" grid, brand strip, collections,
-                                  studio-collective CTA, best sellers, newsletter
-  shop/page.tsx                  SDK <CataloguePage/> with custom hero
-  search/page.tsx                Search
-  collections/[slug]/page.tsx    Collection landing (drops)
-  categories/[slug]/page.tsx     Category landing
-  products/[slug]/page.tsx       Full product detail page (Product JSON-LD)
-
-  size-guide/page.tsx            ⭐ Fashion-specific: chest/length/shoulder + waist/hip/inseam
-                                  tables, "how to measure" callout
-  lookbook/page.tsx              ⭐ Fashion-specific: editorial multi-drop lookbook —
-                                  hero + 3-up tile galleries per drop, "Shop Drop X" CTAs
-
-  cart/page.tsx, checkout/page.tsx, orders/[id]/page.tsx
-
-  account/page.tsx               <CimplifyAccount /> (iframe)
-  account/orders/page.tsx        <CimplifyAccount section="orders" />
-  account/addresses/page.tsx     <CimplifyAccount section="addresses" />
-  account/settings/page.tsx      <CimplifyAccount section="settings" />
-  login/page.tsx, signup/page.tsx  redirects → /account
-
-  contact/page.tsx, track-order/page.tsx
-
-  about/page.tsx, faq/page.tsx
-  shipping/page.tsx (DHL Express worldwide), returns/page.tsx (30 days),
-  accessibility/page.tsx, terms/page.tsx, privacy/page.tsx
-
-  sitemap-page/page.tsx, sitemap.ts, robots.ts, llms.txt/route.ts, opensearch.xml/route.ts
-  error.tsx, not-found.tsx
-```
-
-## File ↔ brand-field map
-
-| File | Reads from `brand` |
-|---|---|
-| `app/layout.tsx` | identity, contact, socials, Store JSON-LD |
-| `app/page.tsx` | `brand.hero`, `brand.trustItems`, `brand.brandStrip`, `brand.promo`, `brand.tradeIn` (= studio-collective copy), `brand.newsletter` |
-| `app/about/page.tsx` | `brand.about` |
-| `app/faq/page.tsx` | `brand.faq` (sizing, drops, returns, customs) |
-| `app/shipping/page.tsx` | `brand.shipping` (worldwide DHL, customs) |
-| `app/returns/page.tsx` | `brand.returns` (30 days, free US/UK/EU) |
-| `app/accessibility/page.tsx` | `brand.accessibility` |
-| `app/terms/page.tsx`, `app/privacy/page.tsx` | `brand.terms`, `brand.privacy` |
-| `app/contact/page.tsx` | `brand.contactPage`, `brand.contact` |
-| `app/track-order/page.tsx` | `brand.trackOrder` |
-| `app/account/*/page.tsx` | `brand.account` (iframe owns UI) |
-| `app/products/[slug]/page.tsx` | `brand.name`, `brand.currency` (Product JSON-LD) |
-| `app/size-guide/page.tsx` | currently has its size charts inlined — hoist to `brand.sizeGuide` if you want agents to edit them |
-| `app/lookbook/page.tsx` | currently has the lookbook entries inlined (image URLs + drop names) — hoist to `brand.lookbook` for agent editing |
-| `app/llms.txt/route.ts` | `brand.llms`, contact, currency |
-| `components/header.tsx`, `footer.tsx` | `brand.header`, `brand.footer`, `brand.contact`, `brand.socials` |
-| `components/promo-banner.tsx`, `trade-in-cta.tsx`, `brand-marquee.tsx`, `trust-bar.tsx`, `newsletter.tsx` | corresponding optional sections in `brand` |
-
-## Fashion-specific notes
-
-- **Hero is full-bleed editorial.** Replace `HERO_FALLBACK_IMAGE` in `app/page.tsx` with the merchant's drop campaign shot for maximum impact.
-- **Drop badges and "limited run" copy** drive urgency. Keep `brand.hero.badge` and `brand.promo.badge` short and time-bounded.
-- **`brand.tradeIn`** is repurposed as the "Studio collective" / membership programme — three-step access flow.
-- **Product detail uses the page-driven model** (`/products/[slug]`) — fashion is a consideration purchase (sizing, fit, fabric details), not impulse.
-- **`brandStrip.headline` is `"Stocked at"`** with editorial publication wordmarks (Vogue, Highsnobiety, etc.) — typography-led, no logo licensing required.
-
-## Known TODOs
-
-- `app/size-guide/page.tsx` has its size charts inlined as constants. Move them to `brand.sizeGuide` (typed) so agents can edit per-merchant size charts in one file.
-- `app/lookbook/page.tsx` has its drop entries inlined. Move to `brand.lookbook` for agent editing — each drop becomes `{ drop, title, date, byline, hero, tiles[] }`.
-- Contact form + newsletter fake submits.
-
-## Mock seed
-
-Wired to `--seed fashion` (Studio FRX apparel catalogue — 14 products with size variants XS–2XL, Drop 04 + Best Sellers collections, full-bleed product imagery served from `static-tmp.cimplify.io`).
-
-## Customizing SDK components
-
-For anything beyond `lib/brand.ts` + `app/globals.css`, you'll likely want to lean on the SDK's prebuilt components rather than reinvent. Particularly for **product customization** (variants, add-ons, bundles, composites, services with scheduling), the SDK already gets the price math, variant axis matching, and cart payload contracts right. Default to ejecting and restyling:
-
-```bash
-bunx @cimplify/sdk add variant-selector    # copies into ./components/
-bunx @cimplify/sdk add cart-drawer
-bunx @cimplify/sdk add product-page
-```
-
-Then edit the local copy. **Don't change the cart payload shape** unless you're also touching the SDK's mock and the backend lens.
-
-If you're considering a from-scratch rebuild of the customizer, read these SDK source files first to understand the contract you must reproduce:
-- `src/react/product-customizer.tsx` — top-level state machine + final `onAddToCart` payload assembly
-- `src/react/variant-selector.tsx` — multi-axis matching via `display_attributes`; default-variant init runs in a `useEffect` and is easy to break
-- `src/react/{add-on,bundle,composite}-selector.tsx` — group constraints, exclusivity rules, per-component variants
-- `src/mock/domain/cart/{index,pricing}.ts` — the contract: `computeUnitPrice`, `computeBundlePrice`, `computeCompositePrice` (4 modes), `computeLineKey`
-
-Full ejection + customization rules are in the SDK-level [`AGENTS.md`](../../AGENTS.md) under "Don't reinvent product customization".
-
-## Quick start
-
-```bash
-bun install
-bun dev
-```
-
-Open <http://localhost:3000>.

package/templates/storefront-fashion/CLAUDE.md

@@ -1,22 +0,0 @@
-# CLAUDE.md
-
-This project was scaffolded from a Cimplify storefront template (`bunx @cimplify/sdk init`).
-
-## Read these first
-
-- **`AGENTS.md`** at the project root — the file ↔ `brand.X` field map for *this template's* industry, plus the architectural rules.
-- **`.claude/skills/cimplify-storefront/SKILL.md`** — the playbook for common tasks (rebrand, add a section, wire a Server Action, deploy, eject a component). Invoke it whenever you're asked to change content, palette, copy, or routing.
-
-## The two-line summary
-
-1. **Edit `lib/brand.ts`** for any visible string.
-2. **Edit `app/globals.css` `@theme` block** for any palette / radius / font change.
-
-That covers ~95% of what merchants ask for. For anything else, follow the `cimplify-storefront` skill.
-
-## Don't do
-
-- Hardcode strings in pages or components.
-- Disable `cacheComponents: true` in `next.config.ts`.
-- Use `unstable_cache` — Next 16's canonical primitive is `'use cache'`.
-- Run `bun test` (Bun's `vi` shim is incomplete) — use `bun run test:run`.

package/templates/storefront-fashion/README.md

@@ -1,77 +0,0 @@
-# __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/__tests__/brand.test.ts

@@ -1,4 +0,0 @@
-import { createBrandSuite } from "@cimplify/sdk/testing/suite";
-import { brand } from "../lib/brand";
-
-createBrandSuite({ brand });

package/templates/storefront-fashion/__tests__/cart-flow.test.ts

@@ -1,55 +0,0 @@
-import { createCartFlowSuite } from "@cimplify/sdk/testing/suite";
-import { expect } from "vitest";
-import { brand } from "../lib/brand";
-
-/**
- * Cart flow suite — base + per-merchant assertions.
- *
- * The base suite (from `@cimplify/sdk/testing/suite`) exercises the
- * universal contract: empty cart, add, dedupe, remove, businessId
- * round-trip. The `extend` hook below adds Studio FRX-specific
- * invariants — copy this pattern when a merchant has unique business
- * rules that need their own coverage.
- *
- *   • `getHandle()` returns the suite's current `TestClientHandle`
- *     (per `it`) so the seed and session are already wired.
- *   • `it` is the vitest API; cases land inside the suite's `describe`
- *     so its `beforeEach`/`afterEach` hooks apply automatically.
- */
-createCartFlowSuite({
-  seed: brand.mock.seed,
-  businessId: brand.mock.businessId,
-  extend: ({ getHandle, it }) => {
-    it("Studio FRX prices everything in GHS", async () => {
-      // Currency is brand-level (not per-product) — Product carries the price
-      // string only. Catalog completeness here is just a sanity check.
-      expect(brand.currency).toBe("GHS");
-      const h = getHandle();
-      const list = await h.client.catalogue.getProducts();
-      if (!list.ok) throw list.error;
-      const items = (list.value as unknown as { items?: unknown[] }).items ?? [];
-      expect(items.length).toBeGreaterThan(0);
-    });
-
-    it("every apparel product covers the studio's core size run (S/M/L)", async () => {
-      const h = getHandle();
-      const list = await h.client.catalogue.getProducts();
-      if (!list.ok) throw list.error;
-      const items = (list.value as unknown as { items?: { id: string; name: string }[] }).items ?? [];
-
-      // Apparel only — caps/socks/totes intentionally lack size variants.
-      const apparel = items.filter((p) => /tee|hoodie|jacket|trouser|pant/i.test(p.name));
-      expect(apparel.length).toBeGreaterThan(0);
-
-      const required = new Set(["S", "M", "L"]);
-      for (const product of apparel) {
-        const variants = await h.client.catalogue.getVariants(product.id);
-        if (!variants.ok) throw variants.error;
-        const sizes = new Set(variants.value.map((v) => v.name).filter(Boolean));
-        for (const size of required) {
-          expect(sizes, `${product.name} missing size ${size}`).toContain(size);
-        }
-      }
-    });
-  },
-});

package/templates/storefront-fashion/__tests__/contract.test.ts

@@ -1,4 +0,0 @@
-import { createContractSuite } from "@cimplify/sdk/testing/suite";
-import { brand } from "../lib/brand";
-
-createContractSuite({ seed: brand.mock.seed });

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

@@ -1,41 +0,0 @@
-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/accessibility/page.tsx

@@ -1,11 +0,0 @@
-import type { Metadata } from "next";
-import { brand } from "@/lib/brand";
-import { PolicyPage } from "@/components/policy-page";
-
-export const metadata: Metadata = {
-  title: `${brand.accessibility.title} — ${brand.name}`,
-};
-
-export default function AccessibilityPage() {
-  return <PolicyPage policy={brand.accessibility} />;
-}