@cimplify/sdk 0.40.1 → 0.42.0

package/templates/storefront-restaurant/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-restaurant/lib/brand.ts

@@ -0,0 +1,375 @@
+/**
+ * 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[] };
+  shipping: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  returns: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  accessibility: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  account: {
+    loginEyebrow: string; loginTitle: string; loginSubtitle: string;
+    signupEyebrow: string; signupTitle: string; signupSubtitle: string;
+    accountEyebrow: string; accountTitle: string;
+  };
+  contactPage: {
+    eyebrow: string; title: string; body: string;
+    reasons: string[];
+    directLines: { label: string; value: string; href: string }[];
+  };
+  trackOrder: { eyebrow: string; title: string; body: string };
+  footer: {
+    blurb: string; sitemap: BrandSitemapSection[];
+    poweredBy?: { label: string; href: string };
+  };
+  llms: { summary: string };
+  mock: { seed: string; businessId: string };
+}
+
+export const brand: Brand = {
+  name: "Mama's Kitchen",
+  shortName: "Mama's",
+  microTag: "EAST LEGON · ACCRA",
+  description:
+    "West African plates, prepared by our matriarchs, served family-style in East Legon. Dine in, take out, deliver.",
+  schemaType: "Restaurant",
+
+  currency: "GHS",
+  locale: "en_GH",
+
+  contact: {
+    address: "21 Adjiringanor Road, East Legon, Accra",
+    streetAddress: "21 Adjiringanor Road, East Legon",
+    city: "Accra",
+    countryCode: "GH",
+    phone: "+233 244 200 100",
+    phoneTel: "+233244200100",
+    email: "hello@mamaskitchen.test",
+    privacyEmail: "privacy@mamaskitchen.test",
+    hours: "Tue–Sun · 12pm–10pm · brunch Sat–Sun, 10am",
+  },
+
+  socials: [
+    { label: "Instagram", href: "https://instagram.com/mamaskitchen", icon: "instagram" },
+    { label: "TikTok", href: "https://tiktok.com/@mamaskitchen", icon: "tiktok" },
+    { label: "Facebook", href: "https://facebook.com/mamaskitchen", icon: "facebook" },
+    { label: "WhatsApp", href: "https://wa.me/233244200100", icon: "whatsapp" },
+  ],
+
+  header: {
+    nav: [
+      { label: "Menu", href: "/shop" },
+      { label: "Reservations", href: "/categories/reservations" },
+      { label: "About", href: "/about" },
+      { label: "FAQ", href: "/faq" },
+    ],
+  },
+
+  hero: {
+    badge: "Tonight's special · Banku & Tilapia",
+    title: "Family recipes,\nfamily tables.",
+    subtitle:
+      "Mama's serves the West African food we grew up with — banku, jollof, palaver sauce, suya — at one long table or to your door. Open Tuesday through Sunday.",
+    primaryCtaLabel: "Reserve a table",
+    secondaryCtaLabel: "See the menu",
+    secondaryCtaHref: "/shop",
+  },
+
+  trustItems: [
+    { label: "Reservations", value: "Same-week tables", description: "Bookings up to 21 days out.", iconKey: "verified" },
+    { label: "Delivery", value: "60-minute, in Accra", description: "Order before 9pm Tue–Sun.", iconKey: "delivery" },
+    { label: "Family-style", value: "Tables for 2 to 20", description: "Long table for 12 reservable.", iconKey: "support" },
+    { label: "Specials", value: "Daily off-menu", description: "Posted on Instagram by 11am.", iconKey: "warranty" },
+  ],
+
+  promo: {
+    badge: "Sunday only",
+    title: "The Long Lunch — three courses, one long table.",
+    body: "Sunday set lunch from 1pm. Three courses, family-style, GH₵180 per head. We send out the menu the Friday before; reserve any time on Saturday.",
+    ctaLabel: "Book the Long Lunch",
+    ctaHref: "/shop",
+  },
+
+  newsletter: {
+    eyebrow: "From the kitchen",
+    title: "Tonight's specials, in your inbox.",
+    body: "Daily specials, off-menu plates, and the events worth knowing about. One email a day, 5 days a week. Unsubscribe in one click.",
+    placeholder: "you@email.com",
+    submitLabel: "Subscribe",
+    successLabel: "Subscribed ✓",
+  },
+
+  about: {
+    eyebrow: "About Mama's",
+    title: "Family recipes,\nfamily tables.",
+    paragraphs: [
+      "Mama's started in 2019 around our grandmother's kitchen — a long table, a heavy stock pot of palaver sauce, and Sunday lunches that lasted three hours. We opened a public room in 2021 and brought the long table with us.",
+      "Every recipe on our menu was cooked first by someone in our family. We built the kitchen around them: three matriarchs lead our line, each in charge of the dishes they grew up making. We don't substitute spice blends. We grind ours from the same Volta-Region peppers Akua's grandmother used.",
+      "We're a small room — 38 covers, plus a long table for 12 reservable as a single party. Open Tuesday through Sunday. Brunch on weekends.",
+    ],
+    sections: [
+      {
+        heading: "The long table",
+        body: "Our 12-seater long table can be reserved as a single party on weekends and weekday evenings. It's the heart of the room. Booking opens three weeks in advance.",
+      },
+      {
+        heading: "Private events",
+        body: "We host private dinners (12–32 people) on Mondays when the public room is closed. Custom menus, full-room buy-out, in-room music. Email events@mamaskitchen.test.",
+      },
+      {
+        heading: "Visit",
+        body: "21 Adjiringanor Road, East Legon · Tue–Sun, 12pm–10pm. Brunch Sat–Sun from 10am.",
+      },
+    ],
+  },
+
+  faq: {
+    eyebrow: "Q&A",
+    title: "Things people ask.",
+    sections: [
+      {
+        title: "Reservations & seating",
+        items: [
+          { q: "How do I book a table?", a: "Online via the Reservations link, or message us on WhatsApp +233 244 200 100. Bookings open 21 days in advance." },
+          { q: "Do you take walk-ins?", a: "Yes — we keep half our tables for walk-ins. Best chance is between 12 and 2pm, or after 9pm." },
+          { q: "Can I book the long table?", a: "Yes — it seats 12 as a single party. Bookable for weekend lunches and weekday evenings, three weeks out." },
+          { q: "What's your cancellation policy?", a: "Free cancellation up to 4 hours before your reservation. After that we charge GH₵60 per cover for no-shows on parties of 6+." },
+        ],
+      },
+      {
+        title: "Menu & dietary",
+        items: [
+          { q: "Do you have vegetarian / vegan options?", a: "Yes — palaver sauce, kontomire stew, plantain, garden eggs. Half our menu is plant-based; the rest can be made vegetarian on request." },
+          { q: "How spicy is your food?", a: "Honestly: medium-hot to hot. Tell your server how you want it; the kitchen adjusts." },
+          { q: "Can you handle allergies?", a: "We're a kitchen, not a lab — we use peanuts, shellfish, dairy, and gluten daily. Tell us in advance and we'll cook around it where we can." },
+        ],
+      },
+      {
+        title: "Delivery & takeout",
+        items: [
+          { q: "Where do you deliver?", a: "Greater Accra, between 12pm and 9pm Tue–Sun. Free over GH₵250." },
+          { q: "How long does delivery take?", a: "60 minutes from order, give or take. We bake the jollof to order, so it arrives still steaming." },
+          { q: "Can I order ahead for pickup?", a: "Yes. Order online, choose a pickup time, and skip the queue." },
+        ],
+      },
+    ],
+    contactPrompt: "Other questions? Email",
+    contactEmail: "hello@mamaskitchen.test",
+  },
+
+  terms: {
+    eyebrow: "Terms of service",
+    title: "Terms of Service",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "1. Who we are", body: "Mama's Kitchen (\"we\", \"us\") is a restaurant operating at 21 Adjiringanor Road, East Legon, Accra. By booking a table or placing an order, you (\"you\", \"guest\") agree to these terms." },
+      { heading: "2. Reservations", body: "Tables held with name + phone. Card guarantee required for parties of 6+." },
+      { heading: "3. Cancellations", body: "Free cancellation up to 4 hours ahead. Within 4 hours, parties of 6+ are charged GH₵60/cover for no-shows." },
+      { heading: "4. Pricing & payment", body: "Prices in GH₵ include VAT and 10% service. Card, mobile money, or cash. Tipping appreciated, never required." },
+      { heading: "5. Delivery", body: "60-minute window from confirmation. We're not liable for delays caused by traffic, weather, or events outside our control." },
+      { heading: "6. Allergens", body: "Our kitchen handles peanuts, shellfish, dairy, gluten. Cross-contamination is possible." },
+      { heading: "7. Liability", body: "Maximum liability for any reservation or order is the cost of that booking. We're not liable for indirect or consequential losses." },
+      { heading: "8. 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: "Reservation details (name, phone, party size, allergies if you share them), order details, 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: [
+        "Confirm and seat reservations.",
+        "Fulfil and deliver orders.",
+        "Send reminders by SMS.",
+        "Send specials (only if you opted in).",
+      ] } },
+      { heading: "Allergy notes", body: "Treated as sensitive — only the kitchen team handling your booking accesses these notes. Never shared." },
+      { heading: "Who we share it with", body: "Payment processors, our SMS provider, and the rider service for delivery. 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@mamaskitchen.test." },
+      { heading: "Retention", body: "Order records: 7 years (tax). Marketing list: until you unsubscribe." },
+    ],
+  },
+
+  shipping: {
+    eyebrow: "Delivery",
+    title: "Delivery & Pickup",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "Greater Accra", body: "Same-day, 12pm–9pm Tue–Sun. Free over GH₵250; GH₵35 below. Typical 60-minute window from order." },
+      { heading: "Pickup", body: "Skip the queue: order ahead, pick a window, walk in. Free." },
+      { heading: "Catering & private events", body: "Off-site catering (12+ people) requires 5 days' notice. Email events@mamaskitchen.test." },
+    ],
+  },
+
+  returns: {
+    eyebrow: "Refunds",
+    title: "Refunds & Quality",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "Quality guarantee", body: "If anything is wrong with your order — wrong dish, cold, off — message us within 2 hours and we'll replace, refund, or credit." },
+      { heading: "Reservation cancellations", body: "Free up to 4 hours before. Within 4 hours, parties of 6+ are charged GH₵60/cover for no-shows." },
+      { heading: "Custom event deposits", body: "Refundable up to 7 days before the event. Within 7 days, deposits are non-refundable." },
+    ],
+  },
+
+  accessibility: {
+    eyebrow: "Accessibility",
+    title: "Accessibility Statement",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "In the dining room", body: "Step-free entrance, accessible bathroom, and a flat path from the curb. Service dogs welcome. We can move tables in advance — let us know at booking." },
+      { heading: "Online", body: "We aim for WCAG 2.1 AA on the website and test it on every release." },
+      { heading: "Reporting issues", body: "Email accessibility@mamaskitchen.test or call ahead — we respond within a business day." },
+    ],
+  },
+
+  account: {
+    loginEyebrow: "Welcome back",
+    loginTitle: "Sign in to Mama's",
+    loginSubtitle: "Pick up where you left off — orders, reservations, and your favourites.",
+    signupEyebrow: "Welcome",
+    signupTitle: "Create an account",
+    signupSubtitle: "Reorder in one tap, hold tables faster, and get first-look at the long-table evenings.",
+    accountEyebrow: "Your account",
+    accountTitle: "Welcome back",
+  },
+
+  contactPage: {
+    eyebrow: "Contact",
+    title: "Talk to the kitchen.",
+    body: "Reservation question, dietary need, private event — message us and we'll reply within a business day.",
+    reasons: ["Reservation question", "An order issue", "Dietary / allergens", "Private event", "Press / partnerships", "Something else"],
+    directLines: [
+      { label: "Email", value: "hello@mamaskitchen.test", href: "mailto:hello@mamaskitchen.test" },
+      { label: "Phone", value: "+233 244 200 100", href: "tel:+233244200100" },
+      { label: "WhatsApp", value: "+233 244 200 100", href: "https://wa.me/233244200100" },
+    ],
+  },
+
+  trackOrder: {
+    eyebrow: "Track an order",
+    title: "Where's my order?",
+    body: "Enter your order number and the email used at checkout. We'll show the kitchen status, the rider, and the live ETA.",
+  },
+
+  footer: {
+    blurb:
+      "West African plates, prepared by our matriarchs, served family-style in East Legon. Dine in, take out, deliver.",
+    sitemap: [
+      {
+        title: "Menu",
+        links: [
+          { label: "Full menu", href: "/shop" },
+          { label: "Brunch", href: "/categories/brunch" },
+          { label: "Mains", href: "/categories/mains" },
+          { label: "Sides", href: "/categories/sides" },
+          { label: "Drinks", href: "/categories/drinks" },
+        ],
+      },
+      {
+        title: "Visit",
+        links: [
+          { label: "Reservations", href: "/categories/reservations" },
+          { label: "The long table", href: "/about" },
+          { label: "Private events", href: "mailto:events@mamaskitchen.test" },
+          { label: "Hours & location", href: "/about" },
+        ],
+      },
+      {
+        title: "Help",
+        links: [
+          { label: "Contact", href: "/contact" },
+          { label: "Track an order", href: "/track-order" },
+          { label: "Delivery", href: "/shipping" },
+          { label: "Refunds", href: "/returns" },
+          { label: "FAQ", href: "/faq" },
+        ],
+      },
+      {
+        title: "Account",
+        links: [
+          { label: "Sign in", href: "/login" },
+          { label: "Create account", href: "/signup" },
+          { label: "Your orders", href: "/account/orders" },
+          { label: "Settings", href: "/account/settings" },
+        ],
+      },
+      {
+        title: "Legal",
+        links: [
+          { label: "Terms of Service", href: "/terms" },
+          { label: "Privacy Policy", href: "/privacy" },
+          { label: "Accessibility", href: "/accessibility" },
+          { label: "Sitemap", href: "/sitemap-page" },
+        ],
+      },
+    ],
+    poweredBy: { label: "Cimplify", href: "https://app.cimplify.io" },
+  },
+
+  llms: {
+    summary:
+      "Mama's Kitchen — small West African restaurant in East Legon, Accra. Family-recipe banku, jollof, palaver sauce, suya. 38-cover dining room with a 12-seater long table. Open Tue–Sun, brunch on weekends. Reservations and delivery in Greater Accra.",
+  },
+
+  mock: {
+    seed: "restaurant",
+    businessId: "bus_mamas_kitchen",
+  },
+};

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

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

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

@@ -9,3 +9,8 @@ NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY=mock-dev
 
 # Business id used by the mock seed (retail: Currents Electronics).
 NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_currents_electronics
+
+# 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-retail/AGENTS.md

@@ -0,0 +1,64 @@
+# AGENTS.md — Retail / electronics storefront template
+
+If you are an AI agent (Claude, Cursor, Aider, devin, …) working on this storefront, **start here.**
+
+## TL;DR for rebranding
+
+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.
+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`.
+
+## Rules
+
+- ✅ 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.
+
+## File map (what reads from where)
+
+| File | Reads from `brand` |
+|---|---|
+| `app/layout.tsx` | metadata, OpenGraph, Organization 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/llms.txt/route.ts` | `brand.llms`, contact, currency |
+| `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/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` |
+| `components/trust-bar.tsx` | `brand.trustItems` |
+| `components/newsletter.tsx` | `brand.newsletter` |
+
+## 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.
+
+## 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`.
+
+## Quick start
+
+```bash
+bun install
+bun dev                 # boots mock + Next dev server
+```
+
+Open <http://localhost:3000>.