@cimplify/cli 0.2.7 → 0.3.0

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

@@ -0,0 +1,12 @@
+"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-auto/lib/cimplify-loader.ts

@@ -0,0 +1,19 @@
+import type { ImageLoader } from "next/image";
+
+import { assetUrl, isCimplifyAsset } from "@cimplify/sdk";
+
+const cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;
+
+const cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {
+  if (isCimplifyAsset(src, cdnBase)) {
+    return assetUrl(src, {
+      base: cdnBase,
+      w: width,
+      quality,
+      format: "auto",
+    });
+  }
+  return src;
+};
+
+export default cimplifyImageLoader;

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

@@ -0,0 +1,45 @@
+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: {
+    loader: "custom",
+    loaderFile: "./lib/cimplify-loader.ts",
+    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: "storefrontassetscdn.cimplify.io", pathname: "/**" },
+      { protocol: "https", hostname: "cdn.cimplify.io", pathname: "/**" },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/storefront-auto/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "__STOREFRONT_NAME__",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "dev": "concurrently -k -n mock,next -c blue,magenta \"cimplify-mock --seed auto --quiet\" \"next dev\"",
+    "dev:storefront": "next dev",
+    "dev:mock": "cimplify-mock --seed auto",
+    "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.46.0",
+    "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-auto/postcss.config.mjs

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

package/templates/storefront-auto/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront-auto/vitest.config.ts

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

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

@@ -11,8 +11,8 @@ NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
 NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_default_akua_bakery
 
 # 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).
+# and OpenGraph metadata. Set this on production deploys; `cimplify env push`
+# wires it into your linked project.
 NEXT_PUBLIC_SITE_URL=https://example.com
 
 # Business handle (human-readable slug, e.g. "akua-bakery"). Used by the

package/templates/storefront-bakery/README.md

@@ -70,4 +70,4 @@ Update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local` to match the seeded bu
 + 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`.
+Deploy with `cimplify deploy --prod` after linking the project. See [`cimplify` CLI docs](https://docs.cimplify.io/cli/deploy). `next.config.ts` already whitelists the SDK image hosts under `images.remotePatterns`.

package/templates/storefront-bakery/lib/cimplify-loader.ts

@@ -0,0 +1,19 @@
+import type { ImageLoader } from "next/image";
+
+import { assetUrl, isCimplifyAsset } from "@cimplify/sdk";
+
+const cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;
+
+const cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {
+  if (isCimplifyAsset(src, cdnBase)) {
+    return assetUrl(src, {
+      base: cdnBase,
+      w: width,
+      quality,
+      format: "auto",
+    });
+  }
+  return src;
+};
+
+export default cimplifyImageLoader;

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

@@ -27,6 +27,8 @@ const nextConfig: NextConfig = {
     ];
   },
   images: {
+    loader: "custom",
+    loaderFile: "./lib/cimplify-loader.ts",
     remotePatterns: [
       { protocol: "http", hostname: "127.0.0.1", port: "8787", pathname: "/img/**" },
       { protocol: "http", hostname: "localhost", port: "8787", pathname: "/img/**" },
@@ -34,6 +36,7 @@ const nextConfig: NextConfig = {
       { protocol: "https", hostname: "loremflickr.com", pathname: "/**" },
       { protocol: "https", hostname: "images.unsplash.com", pathname: "/**" },
       { protocol: "https", hostname: "static-tmp.cimplify.io", pathname: "/**" },
+      { protocol: "https", hostname: "storefrontassetscdn.cimplify.io", pathname: "/**" },
       { protocol: "https", hostname: "cdn.cimplify.io", pathname: "/**" },
     ],
   },

package/templates/storefront-bakery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.3",
+    "@cimplify/sdk": "^0.46.0",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

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

@@ -11,8 +11,8 @@ NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
 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).
+# and OpenGraph metadata. Set this on production deploys; `cimplify env push`
+# wires it into your linked project.
 NEXT_PUBLIC_SITE_URL=https://example.com
 
 # Business handle (human-readable slug, e.g. "akua-bakery"). Used by the

package/templates/storefront-fashion/README.md

@@ -74,4 +74,4 @@ cimplify init my-store --template grocery    # coming soon
 + 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`.
+Deploy with `cimplify deploy --prod` after linking the project. See [`cimplify` CLI docs](https://docs.cimplify.io/cli/deploy). `next.config.ts` already whitelists the SDK image hosts under `images.remotePatterns`.

package/templates/storefront-fashion/lib/cimplify-loader.ts

@@ -0,0 +1,19 @@
+import type { ImageLoader } from "next/image";
+
+import { assetUrl, isCimplifyAsset } from "@cimplify/sdk";
+
+const cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;
+
+const cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {
+  if (isCimplifyAsset(src, cdnBase)) {
+    return assetUrl(src, {
+      base: cdnBase,
+      w: width,
+      quality,
+      format: "auto",
+    });
+  }
+  return src;
+};
+
+export default cimplifyImageLoader;

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

@@ -27,6 +27,8 @@ const nextConfig: NextConfig = {
     ];
   },
   images: {
+    loader: "custom",
+    loaderFile: "./lib/cimplify-loader.ts",
     remotePatterns: [
       { protocol: "http", hostname: "127.0.0.1", port: "8787", pathname: "/img/**" },
       { protocol: "http", hostname: "localhost", port: "8787", pathname: "/img/**" },
@@ -34,6 +36,7 @@ const nextConfig: NextConfig = {
       { protocol: "https", hostname: "loremflickr.com", pathname: "/**" },
       { protocol: "https", hostname: "images.unsplash.com", pathname: "/**" },
       { protocol: "https", hostname: "static-tmp.cimplify.io", pathname: "/**" },
+      { protocol: "https", hostname: "storefrontassetscdn.cimplify.io", pathname: "/**" },
       { protocol: "https", hostname: "cdn.cimplify.io", pathname: "/**" },
     ],
   },

package/templates/storefront-fashion/package.json

@@ -19,7 +19,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.3",
+    "@cimplify/sdk": "^0.46.0",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

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

@@ -11,8 +11,8 @@ NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
 NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_freshmart
 
 # 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).
+# and OpenGraph metadata. Set this on production deploys; `cimplify env push`
+# wires it into your linked project.
 NEXT_PUBLIC_SITE_URL=https://example.com
 
 # Business handle (human-readable slug, e.g. "akua-bakery"). Used by the

package/templates/storefront-grocery/README.md

@@ -70,4 +70,4 @@ Update `NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID` in `.env.local` to match the seeded bu
 + 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`.
+Deploy with `cimplify deploy --prod` after linking the project. See [`cimplify` CLI docs](https://docs.cimplify.io/cli/deploy). `next.config.ts` already whitelists the SDK image hosts under `images.remotePatterns`.

package/templates/storefront-grocery/lib/cimplify-loader.ts

@@ -0,0 +1,19 @@
+import type { ImageLoader } from "next/image";
+
+import { assetUrl, isCimplifyAsset } from "@cimplify/sdk";
+
+const cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;
+
+const cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {
+  if (isCimplifyAsset(src, cdnBase)) {
+    return assetUrl(src, {
+      base: cdnBase,
+      w: width,
+      quality,
+      format: "auto",
+    });
+  }
+  return src;
+};
+
+export default cimplifyImageLoader;

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

@@ -27,6 +27,8 @@ const nextConfig: NextConfig = {
     ];
   },
   images: {
+    loader: "custom",
+    loaderFile: "./lib/cimplify-loader.ts",
     remotePatterns: [
       { protocol: "http", hostname: "127.0.0.1", port: "8787", pathname: "/img/**" },
       { protocol: "http", hostname: "localhost", port: "8787", pathname: "/img/**" },
@@ -34,6 +36,7 @@ const nextConfig: NextConfig = {
       { protocol: "https", hostname: "loremflickr.com", pathname: "/**" },
       { protocol: "https", hostname: "images.unsplash.com", pathname: "/**" },
       { protocol: "https", hostname: "static-tmp.cimplify.io", pathname: "/**" },
+      { protocol: "https", hostname: "storefrontassetscdn.cimplify.io", pathname: "/**" },
       { protocol: "https", hostname: "cdn.cimplify.io", pathname: "/**" },
     ],
   },

package/templates/storefront-grocery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.3",
+    "@cimplify/sdk": "^0.46.0",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

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

@@ -0,0 +1,145 @@
+---
+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 `cimplify 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
+cimplify list
+cimplify add product-card --dir src/components/cimplify
+```
+
+Once ejected, the file is yours. Hooks/types still come from `@cimplify/sdk`.
+
+### Deploy
+
+```bash
+cimplify login
+cimplify projects create my-store
+cimplify link <project-id>
+cimplify env push
+cimplify deploy --prod
+cimplify logs --follow
+cimplify 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-pharmacy/.cursor/rules/cimplify-storefront.mdc

@@ -0,0 +1,25 @@
+---
+description: Cimplify storefront — architectural rules and rebrand contract for a project scaffolded from `cimplify 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-pharmacy/.env.example

@@ -0,0 +1,22 @@
+# 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 (pharmacy: Wellspring Pharmacy).
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_wellspring_pharmacy
+
+# Canonical public site URL — used by sitemap.xml, robots.txt, llms.txt,
+# and OpenGraph metadata. Set this on production deploys; `cimplify env push`
+# wires it into your linked project.
+NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=