@cimplify/sdk 0.40.1 → 0.41.0

package/templates/storefront-grocery/components/header.tsx

@@ -0,0 +1,43 @@
+import Link from "next/link";
+import { Suspense } from "react";
+import { NavLink } from "./nav-link";
+import { CartPill, CartPillSkeleton } from "./cart-pill";
+import { brand } from "@/lib/brand";
+
+/**
+ * Server-rendered header chrome. Brand mark + nav layout streams from the
+ * cache; the active-link styling and live cart count are dynamic islands
+ * mounted in their own Suspense boundaries so the chrome never blocks.
+ */
+export function Header() {
+  return (
+    <header className="sticky top-0 z-30 flex items-center justify-between px-8 py-4 border-b border-border bg-background/90 backdrop-blur-md">
+      <Link href="/" className="flex items-baseline gap-2">
+        <span className="font-serif text-[22px] font-semibold -tracking-[0.02em]">
+          {brand.shortName}
+        </span>
+        <span className="text-[11px] font-medium uppercase tracking-[0.12em] text-muted-foreground">
+          {brand.microTag}
+        </span>
+      </Link>
+      <nav className="flex items-center gap-6">
+        {brand.header.nav.map((link) => (
+          <Suspense key={link.href} fallback={<NavLinkFallback>{link.label}</NavLinkFallback>}>
+            <NavLink href={link.href}>{link.label}</NavLink>
+          </Suspense>
+        ))}
+        <Suspense fallback={<CartPillSkeleton />}>
+          <CartPill />
+        </Suspense>
+      </nav>
+    </header>
+  );
+}
+
+function NavLinkFallback({ children }: { children: React.ReactNode }) {
+  return (
+    <span className="text-[13px] font-medium tracking-wide text-muted-foreground">
+      {children}
+    </span>
+  );
+}

package/templates/storefront-grocery/components/hero.tsx

@@ -0,0 +1,25 @@
+interface HeroProps {
+  badge?: string;
+  title: string;
+  subtitle?: string;
+}
+
+export function Hero({ badge, title, subtitle }: HeroProps) {
+  return (
+    <section className="px-8 py-16 text-center bg-gradient-to-b from-accent to-background">
+      {badge && (
+        <span className="inline-block mb-4 px-3.5 py-1.5 rounded-full bg-card border border-accent text-accent-foreground text-[11px] font-semibold uppercase tracking-[0.12em]">
+          {badge}
+        </span>
+      )}
+      <h1 className="font-serif text-[clamp(2.25rem,5vw,3.5rem)] font-semibold m-0 -tracking-[0.02em]">
+        {title}
+      </h1>
+      {subtitle && (
+        <p className="mx-auto mt-2 max-w-xl text-base text-muted-foreground">
+          {subtitle}
+        </p>
+      )}
+    </section>
+  );
+}

package/templates/storefront-grocery/components/nav-link.tsx

@@ -0,0 +1,20 @@
+"use client";
+
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+
+export function NavLink({ href, children }: { href: string; children: React.ReactNode }) {
+  const pathname = usePathname();
+  const active = pathname === href;
+  return (
+    <Link
+      href={href}
+      className={[
+        "text-[13px] font-medium tracking-wide transition-colors",
+        active ? "text-primary" : "text-muted-foreground hover:text-foreground",
+      ].join(" ")}
+    >
+      {children}
+    </Link>
+  );
+}

package/templates/storefront-grocery/components/providers.tsx

@@ -0,0 +1,31 @@
+"use client";
+
+import { useMemo, type ReactNode } from "react";
+import { createCimplifyClient } from "@cimplify/sdk";
+import { CimplifyProvider } from "@cimplify/sdk/react";
+
+/**
+ * Boots the Cimplify SDK client once on the client-side and exposes it via
+ * <CimplifyProvider/>.
+ *
+ * Base-URL resolution:
+ *   1) If NEXT_PUBLIC_CIMPLIFY_API_URL is set, use it verbatim.
+ *   2) Otherwise use the current origin so requests flow through the
+ *      Next.js rewrite in `next.config.ts` to the mock at :8787 (no CORS).
+ *   3) Fall back to 127.0.0.1:8787 only during SSR, when there's no window.
+ */
+export function Providers({ children }: { children: ReactNode }) {
+  const client = useMemo(() => {
+    const baseUrl =
+      process.env.NEXT_PUBLIC_CIMPLIFY_API_URL?.trim() ||
+      (typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787");
+    const publicKey = process.env.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY ?? "mock-dev";
+    return createCimplifyClient({
+      baseUrl,
+      publicKey,
+      suppressPublicKeyWarning: true,
+    });
+  }, []);
+
+  return <CimplifyProvider client={client}>{children}</CimplifyProvider>;
+}

package/templates/storefront-grocery/components/store-product-card.tsx

@@ -0,0 +1,83 @@
+"use client";
+
+import Link from "next/link";
+import {
+  CardVariant,
+  FoodProductCard,
+  RetailProductCard,
+  WholesaleProductCard,
+  DigitalProductCard,
+  BundleProductCard,
+  CompositeProductCard,
+  StandardServiceCard,
+  RentalServiceCard,
+  AccommodationCard,
+  LeaseServiceCard,
+  SubscriptionCard,
+} from "@cimplify/sdk/react";
+import type { CardLayoutProps } from "@cimplify/sdk/react";
+import type { Product } from "@cimplify/sdk";
+import { PRODUCT_TYPE, RENDER_HINT, DURATION_UNIT } from "@cimplify/sdk";
+
+const RENTAL_UNITS = new Set<string>([DURATION_UNIT.Days, DURATION_UNIT.Hours]);
+const LEASE_UNITS = new Set<string>([DURATION_UNIT.Weeks, DURATION_UNIT.Months, DURATION_UNIT.Years]);
+
+const VARIANT_CARDS: Record<CardVariant, React.ComponentType<CardLayoutProps>> = {
+  [CardVariant.Food]: FoodProductCard,
+  [CardVariant.Retail]: RetailProductCard,
+  [CardVariant.Wholesale]: WholesaleProductCard,
+  [CardVariant.Digital]: DigitalProductCard,
+  [CardVariant.Bundle]: BundleProductCard,
+  [CardVariant.Composite]: CompositeProductCard,
+  [CardVariant.Standard]: StandardServiceCard,
+  [CardVariant.Rental]: RentalServiceCard,
+  [CardVariant.Accommodation]: AccommodationCard,
+  [CardVariant.Lease]: LeaseServiceCard,
+  [CardVariant.Subscription]: SubscriptionCard,
+};
+
+function resolveVariant(p: Product): CardVariant {
+  if (p.type === PRODUCT_TYPE.Bundle) return CardVariant.Bundle;
+  if (p.type === PRODUCT_TYPE.Composite) return CardVariant.Composite;
+  if (p.quantity_pricing && p.quantity_pricing.length > 1) return CardVariant.Wholesale;
+  if (p.type === PRODUCT_TYPE.Digital) return CardVariant.Digital;
+  if (p.type === PRODUCT_TYPE.Service) {
+    if (p.duration_unit && RENTAL_UNITS.has(p.duration_unit)) return CardVariant.Rental;
+    if (p.duration_unit === DURATION_UNIT.Nights) return CardVariant.Accommodation;
+    if (p.duration_unit && LEASE_UNITS.has(p.duration_unit)) return CardVariant.Lease;
+    if (p.billing_plans && p.billing_plans.length > 0 && !p.duration_minutes) return CardVariant.Subscription;
+    return CardVariant.Standard;
+  }
+  if (p.render_hint === RENDER_HINT.Food) return CardVariant.Food;
+  return CardVariant.Retail;
+}
+
+interface Props {
+  product: Product;
+  /** Override the auto-detected card variant. */
+  variant?: CardVariant;
+}
+
+/**
+ * Variant-aware product card that opens the URL-driven product modal on
+ * click. Uses `next/link` with `?product=<slug>` so the link is statically
+ * pre-renderable — no `useSearchParams` dependency means cards don't
+ * become dynamic islands. The modal (which already reads `useSearchParams`
+ * inside a Suspense boundary in the root layout) handles the rest.
+ */
+export function StoreProductCard({ product, variant }: Props) {
+  const slug = product.slug || product.id;
+  const Card = VARIANT_CARDS[variant ?? resolveVariant(product)];
+  const href = `?product=${encodeURIComponent(slug)}`;
+
+  return (
+    <Card
+      product={product}
+      renderLink={({ className, children }) => (
+        <Link href={href} scroll={false} prefetch={false} className={className}>
+          {children}
+        </Link>
+      )}
+    />
+  );
+}

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

@@ -0,0 +1,284 @@
+/**
+ * Brand & content configuration — single source of truth for every visible
+ * string. Edit this file to rebrand. See ../AGENTS.md.
+ */
+
+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[] };
+  footer: {
+    blurb: string; sitemap: BrandSitemapSection[];
+    poweredBy?: { label: string; href: string };
+  };
+  llms: { summary: string };
+  mock: { seed: string; 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." },
+    ],
+  },
+
+  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: "mailto:hello@freshmart.test" },
+          { label: "FAQ", href: "/faq" },
+          { label: "Quality guarantee", href: "/faq" },
+          { label: "Wholesale", href: "mailto:wholesale@freshmart.test" },
+        ],
+      },
+      {
+        title: "Legal",
+        links: [
+          { label: "Terms of Service", href: "/terms" },
+          { label: "Privacy Policy", href: "/privacy" },
+        ],
+      },
+    ],
+    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

@@ -0,0 +1,27 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { useCimplifyClient } from "@cimplify/sdk/react";
+
+/**
+ * Tiny hook for the live cart-count pill in the header. Re-fetches on
+ * mount and exposes a refresh callback. The SDK's `useCart` hook is
+ * fine-grained but heavier — this is enough for a header badge.
+ */
+export function useCartCount(): { count: number; refresh: () => void } {
+  const { client } = useCimplifyClient();
+  const [count, setCount] = useState(0);
+
+  const refresh = () => {
+    void client.cart.getCount().then((r) => {
+      if (r.ok) setCount(r.value);
+    });
+  };
+
+  useEffect(() => {
+    refresh();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [client]);
+
+  return { count, refresh };
+}

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

@@ -0,0 +1,40 @@
+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: "/**" },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/storefront-grocery/package.json

@@ -0,0 +1,28 @@
+{
+  "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",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@cimplify/sdk": "^0.40.1",
+    "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"
+  }
+}

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

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

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

@@ -0,0 +1,16 @@
+# 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 (restaurant: Mama's Kitchen).
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_mamas_kitchen
+
+# 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