npm - @cimplify/sdk - Versions diffs - 0.42.0 → 0.42.1 - Mend

@cimplify/sdk 0.42.0 → 0.42.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/package.json +1 -1
package/templates/storefront-bakery/AGENTS.md +61 -10
package/templates/storefront-fashion/AGENTS.md +80 -26
package/templates/storefront-grocery/AGENTS.md +56 -11
package/templates/storefront-restaurant/AGENTS.md +64 -13
package/templates/storefront-retail/AGENTS.md +65 -24
package/templates/storefront-services/AGENTS.md +64 -16

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.42.0",
+  "version": "0.42.1",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",

package/templates/storefront-bakery/AGENTS.md CHANGED Viewed

@@ -6,8 +6,8 @@ If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this store
 To rebrand this storefront end-to-end as a different merchant:
-1. **Edit `lib/brand.ts`.** Every visible string reads from this file. Replace each field with the merchant's actual content.
-2. **Edit `app/globals.css`** — the `@theme { … }` block holds the design tokens (palette, radius, font references). Tweak to match the merchant's brand.
+1. **Edit `lib/brand.ts`.** Every visible string reads from this file.
+2. **Edit `app/globals.css`** — the `@theme { … }` block holds the design tokens (palette, radius, font references).
 3. **Edit `.env.local`** — set `NEXT_PUBLIC_CIMPLIFY_API_URL`, `NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`, `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`, `NEXT_PUBLIC_SITE_URL`.
 That is the entire rebrand. Do not modify any `.tsx` file in `app/` or `components/` for content changes — they are design-only and read from `brand`.
@@ -22,30 +22,81 @@ That is the entire rebrand. Do not modify any `.tsx` file in `app/` or `componen
 - ❌ Don't disable `cacheComponents: true` in `next.config.ts`.
 - ❌ Don't use `unstable_cache` — Next 16 uses the `'use cache'` directive.
-## File map (what reads from where)
+## Page surface
+```
+app/
+  page.tsx                       Home — hero, collection strips, category grid
+  shop/page.tsx                  Full catalogue (SDK <CataloguePage/>)
+  search/page.tsx                Search (SDK <SearchPage/>)
+  collections/[slug]/page.tsx    Collection landing
+  categories/[slug]/page.tsx     Category landing
+  cart/page.tsx                  SDK <CartPage/>
+  checkout/page.tsx              SDK <CheckoutPage/>
+  orders/[id]/page.tsx           Post-checkout confirmation (also target of /track-order)
+  account/page.tsx               <CimplifyAccount /> (iframe — handles sign-in, dashboard)
+  account/orders/page.tsx        <CimplifyAccount section="orders" />
+  account/addresses/page.tsx     <CimplifyAccount section="addresses" />
+  account/settings/page.tsx      <CimplifyAccount section="settings" />
+  login/page.tsx                 redirect → /account (iframe owns sign-in UI)
+  signup/page.tsx                redirect → /account (iframe owns sign-up UI)
+  contact/page.tsx               Contact form (Server Action wiring TODO; currently fakes submit)
+  track-order/page.tsx           Guest order lookup → /orders/[id]
+  about/page.tsx                 Brand story
+  faq/page.tsx                   FAQ
+  shipping/page.tsx              Standalone shipping policy
+  returns/page.tsx               Standalone returns policy
+  accessibility/page.tsx         Accessibility statement (WCAG 2.1 AA)
+  terms/page.tsx                 Terms of Service
+  privacy/page.tsx               Privacy Policy
+  sitemap-page/page.tsx          Human-readable HTML sitemap
+  sitemap.ts                     XML sitemap (search engines)
+  robots.ts                      robots.txt
+  llms.txt/route.ts              LLM-friendly Markdown index
+  opensearch.xml/route.ts        Browser address-bar search description
+  error.tsx, not-found.tsx       Global boundaries
+```
+## File ↔ brand-field map
 | File | Reads from `brand` |
 |---|---|
-| `app/layout.tsx` | metadata, OpenGraph, Organization JSON-LD |
+| `app/layout.tsx` | identity, contact, socials, schemaType (Organization JSON-LD), `metadataBase` |
 | `app/page.tsx` | `brand.hero` (Hero badge / title / subtitle) |
 | `app/about/page.tsx` | `brand.about` |
 | `app/faq/page.tsx` | `brand.faq` |
 | `app/terms/page.tsx` | `brand.terms` |
 | `app/privacy/page.tsx` | `brand.privacy` |
+| `app/shipping/page.tsx` | `brand.shipping` |
+| `app/returns/page.tsx` | `brand.returns` |
+| `app/accessibility/page.tsx` | `brand.accessibility` |
+| `app/contact/page.tsx` | `brand.contactPage`, `brand.contact` |
+| `app/track-order/page.tsx` | `brand.trackOrder` |
+| `app/account/*/page.tsx` | `brand.account` (eyebrows + titles only — Cimplify Link iframe owns the UI) |
+| `app/login/page.tsx`, `app/signup/page.tsx` | `brand.account` (metadata only — both redirect to `/account`) |
 | `app/llms.txt/route.ts` | `brand.llms`, contact, currency |
-| `app/sitemap.ts`, `robots.ts` | (no brand strings — derives from product data) |
+| `app/opensearch.xml/route.ts` | `brand.shortName`, `brand.name` |
+| `app/sitemap.ts`, `robots.ts` | derives URLs from product/category data |
 | `app/not-found.tsx` | `brand.name` (page title) |
 | `components/header.tsx` | `brand.shortName`, `brand.microTag`, `brand.header.nav` |
-| `components/footer.tsx` | `brand.footer`, contact, socials |
+| `components/footer.tsx` | `brand.footer`, `brand.contact`, `brand.socials` |
 ## Bakery-specific notes
-- Product detail uses a **URL-driven modal** (`?product=<slug>`), not a static `/products/[slug]` route. This fits impulse-purchase food UX. Don't refactor without a reason.
-- Schema.org type is `Bakery`. `lib/brand.ts` sets this in `schemaType` — change if rebranding to a different industry.
+- Product detail uses a **URL-driven modal** (`?product=<slug>`), not a static `/products/[slug]` route. Fits impulse-purchase food UX.
+- Schema.org `@type` is `Bakery` — set in `brand.schemaType`.
+- Mock seed: `--seed default` (Akua's Bakery). To preview a different industry, edit `dev:mock` in `package.json` and update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`.
-## Mock seed
+## Known TODOs (not blocking, but worth knowing)
-Wired to `--seed default` (Akua's Bakery) via `package.json` `dev:mock`. To preview another seed, change the flag or run `bunx @cimplify/sdk --seed restaurant` directly and update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local`.
+- `app/contact/contact-form.tsx` fakes a successful submit. In production, wire a Server Action that calls `client.support.sendMessage(...)` from `@cimplify/sdk/server`.
+- `components/newsletter.tsx` (homepage strip) similarly fakes submit. Wire to a real list provider.
+- Hero / lookbook imagery is Unsplash placeholder — replace with merchant assets.
 ## Quick start

package/templates/storefront-fashion/AGENTS.md CHANGED Viewed

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

package/templates/storefront-grocery/AGENTS.md CHANGED Viewed

@@ -10,24 +10,69 @@ If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this store
 ## Aesthetic
-Approachable grocer — Trader Joe's / Whole Foods / abundant-feel:
 - **Inter sans only** (no serif) — friendly, readable for dense product grids.
-- **Fresh green + cream**: vibrant green primary, warm cream background.
+- **Fresh green + cream** — vibrant green primary, warm cream background.
 - **Generous radius**: `0.875rem` — softer than retail.
 - **Bold, slightly heavy** headings.
+- Schema.org `@type` is `GroceryStore`.
+## Page surface
+```
+app/
+  page.tsx                       Home — hero ("Free delivery over GH₵150"),
+                                  collection strips, category grid, newsletter
+  shop/page.tsx                  Aisle (SDK <CataloguePage/>)
+  search/page.tsx                Search
+  collections/[slug]/page.tsx    Collection landing (e.g. weekly box, deals)
+  categories/[slug]/page.tsx     Category landing
+  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 (delivery + slots), returns/page.tsx (quality guarantee),
+  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, GroceryStore JSON-LD |
+| `app/page.tsx` | `brand.hero` (free-delivery badge) |
+| `app/about/page.tsx` | `brand.about` |
+| `app/faq/page.tsx` | `brand.faq` (delivery slots, sourcing, subscription boxes) |
+| `app/shipping/page.tsx` | `brand.shipping` (delivery slots + free-over threshold) |
+| `app/returns/page.tsx` | `brand.returns` (quality guarantee) |
+| `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/llms.txt/route.ts` | `brand.llms`, contact, currency |
+| `components/header.tsx`, `footer.tsx` | `brand.header`, `brand.footer`, `brand.contact`, `brand.socials` |
-## Industry-specific copy patterns
+## Grocery-specific notes
-- `brand.hero.badge` is `"Free delivery over GH₵150"` — pricing-led trust signal.
-- `brand.hero.primaryCtaLabel` is `"Shop the aisle"`.
-- `brand.tradeIn` is omitted.
-- `brand.faq` covers delivery slots, sourcing/quality, subscription boxes.
-- Schema.org type is `GroceryStore`.
+- **Subscription boxes** are modelled as products with `billing_plans` (renders the SubscriptionCard variant). The basket-box landing lives at `/categories/baskets`.
+- **Weight-based pricing**: SDK supports `quantity_pricing` tiers per product, but most grocery products are sold by unit/kg. Real weight-at-pack pricing happens on the backend pricing rule.
+- Mock seed: `--seed grocery` (FreshMart).
-## Mock seed
+## Known TODOs
-Wired to `--seed grocery` (FreshMart).
+- Contact + newsletter fake submits.
+- Hero / category / product imagery is Unsplash placeholder — replace with merchant photography.
 ## Quick start

package/templates/storefront-restaurant/AGENTS.md CHANGED Viewed

@@ -10,24 +10,75 @@ If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this store
 ## Aesthetic
-Boutique restaurant — Sweetgreen / chef-table feel:
+- **Lora serif + Inter** — warm, food-friendly headings + clean body.
+- **Forest green + cream** — deep sage primary, warm cream background.
+- **Mid radius**: `0.625rem`.
+- Schema.org `@type` is `Restaurant`.
-- **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.
+## Page surface
-## Industry-specific copy patterns
+```
+app/
+  page.tsx                       Home — hero with daily-special badge,
+                                  collection strips, category grid
+  shop/page.tsx                  Full menu (SDK <CataloguePage/>)
+  search/page.tsx                Search
+  collections/[slug]/page.tsx    Collection landing (e.g. brunch, mains)
+  categories/[slug]/page.tsx     Category landing
+  reservations/page.tsx          ⭐ Restaurant-specific: reservation widget
+                                  (date + lunch/dinner slot + party size)
+                                  backed by service-type "seating" products
+  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 (delivery), returns/page.tsx (refunds), 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, Restaurant JSON-LD |
+| `app/page.tsx` | `brand.hero` (daily-special badge) |
+| `app/about/page.tsx` | `brand.about` |
+| `app/faq/page.tsx` | `brand.faq` (reservations, dietary, delivery) |
+| `app/shipping/page.tsx` | `brand.shipping` (delivery + pickup) |
+| `app/returns/page.tsx` | `brand.returns` (refund + cancellation) |
+| `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 the UI) |
+| `app/reservations/*` | derives seating from service-type products in the catalogue |
+| `app/llms.txt/route.ts` | `brand.llms`, contact, currency |
+| `components/header.tsx`, `footer.tsx` | `brand.header`, `brand.footer`, `brand.contact`, `brand.socials` |
+## Restaurant-specific notes
-- `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`.
+- **Reservations are service-type products.** Add seating options like "Two-top", "Four-top", "Long table for 12" to the catalogue with `type: "service"`. The `/reservations` page filters them in.
+- The reservation widget adds the chosen seating to cart with the date, time, party size, and notes as cart-item notes; checkout finalises the booking via Cimplify's order pipeline.
+- Schema.org `@type` is `Restaurant`. `servesCuisine` etc. can be added to the JSON-LD object in `app/layout.tsx` if needed.
+- Mock seed: `--seed restaurant` (Mama's Kitchen).
-## Mock seed
+## Known TODOs
-Wired to `--seed restaurant` (Mama's Kitchen).
+- `/reservations` widget assumes every slot is bookable. For production, wire `useAvailableSlots({ serviceId, date })` from `@cimplify/sdk/react` to filter to actually-free windows.
+- Contact form + newsletter fake their submits.
+- Hero / dish photography is Unsplash — replace with merchant photos.
 ## Quick start

package/templates/storefront-retail/AGENTS.md CHANGED Viewed

@@ -4,39 +4,75 @@ If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this store
 ## TL;DR for rebranding
-To rebrand this storefront end-to-end as a different merchant:
+1. **Edit `lib/brand.ts`** — every visible string lives here.
+2. **Edit `app/globals.css`** — `@theme { … }` block 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`.
-1. **Edit `lib/brand.ts`.** Every visible string reads from this file. Replace each field with the merchant's actual content.
-2. **Edit `app/globals.css`** — the `@theme { … }` block holds the design tokens (palette, radius, font references). Tweak to match the merchant's brand.
-3. **Edit `.env.local`** — set `NEXT_PUBLIC_CIMPLIFY_API_URL`, `NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`, `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID`, `NEXT_PUBLIC_SITE_URL`.
+## Aesthetic
-That is the entire rebrand. Do not modify any `.tsx` file in `app/` or `components/` for content changes — they are design-only and read from `brand`.
+- **Inter + JetBrains Mono** — clean modern sans, mono-spaced labels for spec-feel.
+- **Cool navy + electric blue**: dark foreground, electric primary.
+- **Sharp corners**: `0.5rem` — modern retail.
+- **Section heroes** in dark with mono-spaced eyebrow labels.
-## Rules
+## Page surface
-- ✅ All content edits → `lib/brand.ts`
-- ✅ All design-token edits → `app/globals.css` `@theme` block
-- ✅ Server Components stay cached via `'use cache'` + `cacheTag(tags.X())` + `cacheLife("hours")`
-- ✅ Client islands (header active link, cart pill, product card link) live behind `<Suspense>`
-- ❌ Don't hardcode strings. If a string isn't in `brand`, add a new field to the `Brand` interface.
-- ❌ Don't disable `cacheComponents: true` in `next.config.ts`.
-- ❌ Don't use `unstable_cache` — Next 16 uses the `'use cache'` directive.
+```
+app/
+  page.tsx                       Multi-section home — split hero, trust bar, category tiles,
+                                  promo banner, "Just dropped" grid, brand strip, collections,
+                                  trade-in CTA, best sellers, newsletter
+  shop/page.tsx                  SDK <CataloguePage/> with custom hero
+  search/page.tsx                Search (SDK <SearchPage/>)
+  collections/[slug]/page.tsx    Collection landing
+  categories/[slug]/page.tsx     Category landing
+  products/[slug]/page.tsx       Full product detail page (Product JSON-LD)
+  cart/page.tsx                  SDK <CartPage/>
+  checkout/page.tsx              SDK <CheckoutPage/>
+  orders/[id]/page.tsx           Post-checkout confirmation
+  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               Branded contact form
+  track-order/page.tsx           Guest lookup → /orders/[id]
+  about/page.tsx, faq/page.tsx   Brand pages
+  shipping/page.tsx, returns/page.tsx, accessibility/page.tsx  Standalone policies
+  terms/page.tsx, privacy/page.tsx
+  sitemap-page/page.tsx          HTML sitemap
+  sitemap.ts, robots.ts          XML sitemap, robots.txt
+  llms.txt/route.ts              LLM-friendly site index
+  opensearch.xml/route.ts        Browser search description
+  error.tsx, not-found.tsx       Global boundaries
+```
-## File map (what reads from where)
+## File ↔ brand-field map
 | File | Reads from `brand` |
 |---|---|
-| `app/layout.tsx` | metadata, OpenGraph, Organization JSON-LD |
+| `app/layout.tsx` | identity, contact, socials, schemaType (Store JSON-LD) |
 | `app/page.tsx` | `brand.hero`, `brand.trustItems`, `brand.brandStrip`, `brand.promo`, `brand.tradeIn`, `brand.newsletter` |
 | `app/about/page.tsx` | `brand.about` |
 | `app/faq/page.tsx` | `brand.faq` |
 | `app/terms/page.tsx` | `brand.terms` |
 | `app/privacy/page.tsx` | `brand.privacy` |
-| `app/products/[slug]/page.tsx` | `brand.name`, `brand.currency` (Product JSON-LD) |
+| `app/shipping/page.tsx` | `brand.shipping` (warranty + returns + same-day delivery copy) |
+| `app/returns/page.tsx` | `brand.returns` |
+| `app/accessibility/page.tsx` | `brand.accessibility` |
+| `app/contact/page.tsx` | `brand.contactPage`, `brand.contact` |
+| `app/track-order/page.tsx` | `brand.trackOrder` |
+| `app/account/*/page.tsx` | `brand.account` (Cimplify Link iframe owns the UI) |
+| `app/products/[slug]/page.tsx` | `brand.name`, `brand.currency` (Product JSON-LD: brand, offer, availability) |
 | `app/llms.txt/route.ts` | `brand.llms`, contact, currency |
-| `app/not-found.tsx` | `brand.name` (page title) |
+| `app/opensearch.xml/route.ts` | `brand.shortName`, `brand.name` |
 | `components/header.tsx` | `brand.shortName`, `brand.microTag`, `brand.header.nav` |
-| `components/footer.tsx` | `brand.footer`, contact, socials |
+| `components/footer.tsx` | `brand.footer`, `brand.contact`, `brand.socials` |
 | `components/promo-banner.tsx` | `brand.promo` (renders nothing if absent) |
 | `components/trade-in-cta.tsx` | `brand.tradeIn` (renders nothing if absent) |
 | `components/brand-marquee.tsx` | `brand.brandStrip` |
@@ -45,20 +81,25 @@ That is the entire rebrand. Do not modify any `.tsx` file in `app/` or `componen
 ## Retail-specific notes
-- Product detail is a **full `/products/[slug]` page** with image gallery, customizer, related products rail, and Product JSON-LD. This fits consideration-purchase electronics UX (specs, reviews, warranty). Do not replace with a modal.
-- Schema.org type is `Store`. Change in `lib/brand.ts` (`schemaType`) for a different industry.
-- Optional sections render conditionally: `brand.promo`, `brand.tradeIn`, `brand.trustItems`, `brand.brandStrip` — set to `undefined` to hide.
-- `app/page.tsx` uses Unsplash fallback hero image (`HERO_FALLBACK_IMAGE`) — replace with your own asset URL.
+- Product detail is a **full `/products/[slug]` page** with image gallery, customizer, related products rail, and Product JSON-LD. Consideration purchases (phones, laptops, headphones) need real estate. Don't replace with a modal.
+- Schema.org `@type` is `Store`.
+- Optional sections render conditionally: set `brand.promo`, `brand.tradeIn`, `brand.trustItems`, or `brand.brandStrip` to `undefined` to hide them.
+- `app/page.tsx` uses an Unsplash fallback hero (`HERO_FALLBACK_IMAGE`) — replace with the merchant's own product photography.
+## Known TODOs
+- Contact form + newsletter signup currently fake their submit. Wire `client.support.sendMessage(...)` for contact and a real list provider for newsletter.
+- Trust-bar / brand-marquee imagery / wordmarks are placeholders — swap for the merchant's real partners.
 ## Mock seed
-Wired to `--seed retail` (Currents Electronics) via `package.json` `dev:mock`. To preview another seed, change the flag or run `bunx @cimplify/sdk --seed services` directly and update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local`.
+Wired to `--seed retail` (Currents Electronics). Edit `dev:mock` in `package.json` to preview another seed.
 ## Quick start
 ```bash
 bun install
-bun dev                 # boots mock + Next dev server
+bun dev
 ```
 Open <http://localhost:3000>.

package/templates/storefront-services/AGENTS.md CHANGED Viewed

@@ -5,31 +5,79 @@ If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this store
 ## TL;DR for rebranding
 1. **Edit `lib/brand.ts`** — every visible string lives here.
-2. **Edit `app/globals.css`** — the `@theme { … }` block holds the palette + radius.
+2. **Edit `app/globals.css`** — `@theme { … }` for palette + radius.
 3. **Edit `.env.local`** — `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_serene_spa` for the bundled seed.
 ## Aesthetic
-Calm, refined wellness — Booksy / Mindbody / boutique-spa territory:
+- **Fraunces serif + Inter** — warm, slightly editorial headings.
+- **Sand + sage palette** — warm cream background, deep sage primary.
+- **Generous radius**: `1rem` — calm, soft.
+- Lower-contrast than retail / fashion.
+- Schema.org `@type` is `BeautySalon`.
-- **Fraunces serif** for headings (warm, slightly editorial).
-- **Inter** for body and UI.
-- **Sand + sage palette**: warm cream background, deep sage primary.
-- **Soft corners**: `--radius: 1rem` — generous rounding throughout.
-- **Lower-contrast** than retail / fashion; calm-feeling.
+## Page surface
-## Industry-specific copy patterns
+```
+app/
+  page.tsx                       Home — hero ("Now booking"), service strips,
+                                  category grid, newsletter
+  shop/page.tsx                  Treatment menu (SDK <CataloguePage/>)
+  search/page.tsx                Search
+  collections/[slug]/page.tsx    Collection landing
+  categories/[slug]/page.tsx     Category landing (e.g. memberships, packages)
+  book/page.tsx                  ⭐ Services-specific: full booking widget
+                                  (treatment + 14-day date + 30-min slot grid)
+                                  → adds to cart with slot as note → /checkout
+  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 (find a booking)
+  about/page.tsx, faq/page.tsx
+  shipping/page.tsx (what to expect at the studio), returns/page.tsx (cancellations),
+  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, BeautySalon JSON-LD |
+| `app/page.tsx` | `brand.hero` ("Now booking") |
+| `app/about/page.tsx` | `brand.about` |
+| `app/faq/page.tsx` | `brand.faq` (booking, contraindications, memberships) |
+| `app/shipping/page.tsx` | `brand.shipping` (what to expect at the studio) |
+| `app/returns/page.tsx` | `brand.returns` (cancellation policy) |
+| `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` ("find a booking") |
+| `app/account/*/page.tsx` | `brand.account` (iframe owns UI) |
+| `app/book/*` | derives bookable services from product list (`type: "service"`) |
+| `app/llms.txt/route.ts` | `brand.llms`, contact, currency |
+| `components/header.tsx`, `footer.tsx` | `brand.header`, `brand.footer`, `brand.contact`, `brand.socials` |
+## Services-specific notes
-The bundled brand presets:
-- `brand.hero.badge` reads `"Now booking · April"` — month-based availability.
-- `brand.hero.primaryCtaLabel` is `"Book a treatment"`.
-- `brand.tradeIn` is omitted (irrelevant for services).
-- `brand.faq` covers booking, cancellation, contraindications, memberships.
-- Schema.org type is `BeautySalon`.
+- **Bookable services are `type: "service"` products.** The `/book` page filters the product list to type=service and treats them as treatments. Their `duration_minutes` is shown on the chip.
+- Cart-item notes carry the booked time slot — checkout sends them through Cimplify's order pipeline. The merchant's downstream system reads the note to schedule the appointment.
+- Mock seed: `--seed services` (Serene Spa).
-## Mock seed
+## Known TODOs
-Wired to `--seed services` (Serene Spa). Products in this seed are *services* (`type: "service"`), so the SDK's variant cards render `StandardServiceCard` automatically.
+- `/book` widget shows every slot as available. For production, wire `useAvailableSlots({ serviceId, date })` from `@cimplify/sdk/react` to filter to genuinely-free windows.
+- Contact + newsletter fake submits.
 ## Quick start