@cimplify/sdk 0.40.1 → 0.41.0

package/templates/storefront-bakery/app/layout.tsx

@@ -6,6 +6,7 @@ import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
 import { Suspense } from "react";
+import { brand } from "@/lib/brand";
 
 const inter = Inter({
   subsets: ["latin"],
@@ -19,9 +20,39 @@ const playfair = Playfair_Display({
   display: "swap",
 });
 
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
 export const metadata: Metadata = {
-  title: "Akua's Bakery",
-  description: "Sourdough, croissants, cakes, and more — handcrafted in East Legon, delivered across Accra.",
+  metadataBase: new URL(SITE_URL),
+  title: {
+    default: brand.name,
+    template: `%s — ${brand.name}`,
+  },
+  description: brand.description,
+  openGraph: {
+    type: "website",
+    siteName: brand.name,
+    locale: brand.locale,
+  },
+  twitter: { card: "summary_large_image" },
+};
+
+const ORGANIZATION_LD = {
+  "@context": "https://schema.org",
+  "@type": brand.schemaType,
+  name: brand.name,
+  url: SITE_URL,
+  description: brand.description,
+  email: brand.contact.email,
+  telephone: brand.contact.phoneTel,
+  address: {
+    "@type": "PostalAddress",
+    streetAddress: brand.contact.streetAddress,
+    addressLocality: brand.contact.city,
+    addressCountry: brand.contact.countryCode,
+  },
+  sameAs: brand.socials.map((s) => s.href),
 };
 
 export default function RootLayout({ children }: { children: React.ReactNode }) {
@@ -31,6 +62,10 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         suppressHydrationWarning
         className="min-h-screen flex flex-col bg-background text-foreground font-sans"
       >
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(ORGANIZATION_LD) }}
+        />
         <Providers>
           <Header />
           <main className="flex-1 pb-12 w-full">{children}</main>

package/templates/storefront-bakery/app/llms.txt/route.ts

@@ -0,0 +1,94 @@
+import { cacheTag, cacheLife } from "next/cache";
+import { getServerClient, tags, type Product } from "@cimplify/sdk/server";
+import { brand } from "@/lib/brand";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+async function buildLlmsTxt(): Promise<string> {
+  "use cache";
+  cacheTag(tags.products(), tags.categories(), tags.collections());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const [productsRes, categoriesRes, collectionsRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+
+  const products: Product[] = productsRes.ok ? productsRes.value.items : [];
+  const categories = categoriesRes.ok ? categoriesRes.value : [];
+  const collections = collectionsRes.ok ? collectionsRes.value : [];
+
+  const lines: string[] = [];
+  lines.push(`# ${brand.name}`);
+  lines.push("");
+  lines.push(`> ${brand.llms.summary}`);
+  lines.push("");
+  lines.push("## Browse");
+  lines.push(`- [Home](${SITE_URL}/)`);
+  lines.push(`- [Shop](${SITE_URL}/shop): Full menu with filter and sort.`);
+
+  if (categories.length > 0) {
+    lines.push("");
+    lines.push("## Categories");
+    for (const c of categories) {
+      lines.push(
+        `- [${c.name}](${SITE_URL}/categories/${c.slug})${c.description ? `: ${c.description}` : ""}`,
+      );
+    }
+  }
+
+  if (collections.length > 0) {
+    lines.push("");
+    lines.push("## Collections");
+    for (const c of collections) {
+      lines.push(
+        `- [${c.name}](${SITE_URL}/collections/${c.slug})${c.description ? `: ${c.description}` : ""}`,
+      );
+    }
+  }
+
+  if (products.length > 0) {
+    lines.push("");
+    lines.push("## Products");
+    for (const p of products) {
+      const slug = p.slug ?? p.id;
+      const price = `${p.currency ?? brand.currency} ${p.default_price}`;
+      const desc = p.description ? ` — ${p.description.replace(/\s+/g, " ").slice(0, 200)}` : "";
+      lines.push(`- [${p.name}](${SITE_URL}/shop?product=${slug}) (${price})${desc}`);
+    }
+  }
+
+  lines.push("");
+  lines.push("## Information");
+  lines.push(`- [About](${SITE_URL}/about)`);
+  lines.push(`- [FAQ](${SITE_URL}/faq)`);
+  lines.push(`- [Terms of Service](${SITE_URL}/terms)`);
+  lines.push(`- [Privacy Policy](${SITE_URL}/privacy)`);
+  lines.push(`- [Sitemap (XML)](${SITE_URL}/sitemap.xml)`);
+  lines.push("");
+  lines.push("## Contact");
+  lines.push(`- Email: ${brand.contact.email}`);
+  lines.push(`- Phone: ${brand.contact.phone}`);
+  lines.push(`- Address: ${brand.contact.address}`);
+
+  return lines.join("\n") + "\n";
+}
+
+/**
+ * `/llms.txt` — machine-readable site index for LLMs (per llmstxt.org).
+ * Lets coding agents and chat assistants find products, categories, and
+ * support pages without scraping HTML. Plain Markdown so it streams cheaply
+ * into context windows.
+ */
+export async function GET(): Promise<Response> {
+  const body = await buildLlmsTxt();
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=0, s-maxage=3600, stale-while-revalidate=86400",
+    },
+  });
+}

package/templates/storefront-bakery/app/not-found.tsx

@@ -0,0 +1,39 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Page not found — ${brand.name}`,
+  description: "We couldn't find that page.",
+};
+
+export default function NotFound() {
+  return (
+    <section className="max-w-2xl mx-auto px-8 py-20 text-center">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-3">
+        404
+      </p>
+      <h1 className="font-serif text-[clamp(2.5rem,5vw,3.5rem)] font-semibold mb-4">
+        Page not found.
+      </h1>
+      <p className="text-muted-foreground leading-relaxed mb-8">
+        The URL you followed might be old, a typo, or pointing at a product
+        that&apos;s sold out for the day. Try the menu or head back home.
+      </p>
+      <div className="flex flex-wrap items-center justify-center gap-3">
+        <Link
+          href="/shop"
+          className="inline-block px-6 py-3 rounded-full bg-primary text-primary-foreground font-semibold text-sm transition-colors hover:bg-primary/90"
+        >
+          Browse the menu
+        </Link>
+        <Link
+          href="/"
+          className="inline-block px-6 py-3 rounded-full border border-border hover:bg-muted transition-colors text-sm font-medium"
+        >
+          Back home
+        </Link>
+      </div>
+    </section>
+  );
+}

package/templates/storefront-bakery/app/page.tsx

@@ -5,11 +5,11 @@ import { getServerClient, tags, type Product } from "@cimplify/sdk/server";
 import { Hero } from "@/components/hero";
 import { CollectionStrip } from "@/components/collection-strip";
 import { CategoryGrid } from "@/components/category-grid";
+import { brand } from "@/lib/brand";
 
 export const metadata: Metadata = {
-  title: "Akua's Bakery — Fresh from the oven, every day",
-  description:
-    "Sourdough, croissants, cakes, and more — handcrafted in East Legon, delivered across Accra.",
+  title: `${brand.name} — ${brand.hero.title}`,
+  description: brand.description,
 };
 
 async function getHomeData() {
@@ -47,9 +47,9 @@ export default async function HomePage() {
   return (
     <>
       <Hero
-        badge="BAKERY · PÂTISSERIE · COFFEE"
-        title="Fresh from the oven, every day."
-        subtitle="Sourdough, croissants, cakes, and more — handcrafted in East Legon, delivered across Accra."
+        badge={brand.hero.badge}
+        title={brand.hero.title}
+        subtitle={brand.hero.subtitle}
       />
       {collections.map(({ collection, products }) => (
         <Suspense

package/templates/storefront-bakery/app/privacy/page.tsx

@@ -1,87 +1,43 @@
 import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
 
 export const metadata: Metadata = {
-  title: "Privacy Policy — Akua's Bakery",
-  description:
-    "How Akua's Bakery collects, uses, and protects your personal data.",
+  title: `Privacy Policy — ${brand.name}`,
+  description: `How ${brand.name} collects, uses, and protects your personal data.`,
 };
 
 export default function PrivacyPage() {
+  const p = brand.privacy;
   return (
     <article className="max-w-3xl mx-auto px-8 py-16 prose prose-lg max-w-none">
       <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2 not-prose">
-        Privacy
+        {p.eyebrow}
       </p>
       <h1 className="font-serif text-[clamp(2.25rem,5vw,3.5rem)] font-semibold mb-2 -tracking-[0.02em]">
-        Privacy Policy
+        {p.title}
       </h1>
       <p className="text-sm text-muted-foreground not-prose mb-10">
-        Last updated: 1 May 2026
+        Last updated: {p.lastUpdated}
       </p>
 
       <section className="space-y-5 leading-relaxed text-foreground/90">
-        <h2 className="font-serif text-2xl font-semibold mt-0">What we collect</h2>
-        <p>
-          We collect only what we need to fulfil your order: your name, phone,
-          delivery address, email, and the items in your order. Payment details
-          are processed by our payment partners (Paystack, Stripe) and never
-          stored on our servers.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">How we use it</h2>
-        <ul className="list-disc pl-6 space-y-2">
-          <li>To prepare, deliver, and confirm your order.</li>
-          <li>To send order updates by SMS and email.</li>
-          <li>
-            To send occasional product news — only if you opted in. Unsubscribe
-            anytime in one click.
-          </li>
-          <li>
-            To analyse aggregated, anonymised browsing patterns so we can
-            improve the site.
-          </li>
-        </ul>
-
-        <h2 className="font-serif text-2xl font-semibold">Who we share it with</h2>
-        <p>
-          We share data only with the partners required to fulfil your order:
-          payment processors (Paystack, Stripe), delivery riders, and our
-          email/SMS providers. We do not sell or rent personal data to third
-          parties — ever.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">Cookies</h2>
-        <p>
-          We use a small number of strictly-necessary cookies to keep your cart
-          working and your session signed in. We don't use third-party
-          advertising or tracking cookies.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">Your rights</h2>
-        <p>
-          Under the Ghana Data Protection Act, 2012 (Act 843), you have the
-          right to access the data we hold about you, correct it, or have it
-          deleted. Email{" "}
-          <a
-            href="mailto:privacy@akuasbakery.test"
-            className="text-primary font-semibold hover:underline"
-          >
-            privacy@akuasbakery.test
-          </a>{" "}
-          and we'll respond within 14 days.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">Retention</h2>
-        <p>
-          We keep order records for 7 years to comply with Ghanaian tax law.
-          Marketing-list opt-ins are kept until you unsubscribe.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">Changes</h2>
-        <p>
-          If we make material changes to this policy, we'll email customers on
-          our marketing list and update the &quot;last updated&quot; date above.
-        </p>
+        {p.sections.map((s) => (
+          <div key={s.heading}>
+            <h2 className="font-serif text-2xl font-semibold mt-0">{s.heading}</h2>
+            {typeof s.body === "string" ? (
+              <p>{s.body}</p>
+            ) : (
+              <>
+                <p>{s.body.intro}</p>
+                <ul className="list-disc pl-6 space-y-2">
+                  {s.body.bullets.map((b) => (
+                    <li key={b}>{b}</li>
+                  ))}
+                </ul>
+              </>
+            )}
+          </div>
+        ))}
       </section>
     </article>
   );

package/templates/storefront-bakery/app/robots.ts

@@ -0,0 +1,18 @@
+import type { MetadataRoute } from "next";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [
+      {
+        userAgent: "*",
+        allow: "/",
+        disallow: ["/cart", "/checkout", "/orders/", "/api/"],
+      },
+    ],
+    sitemap: `${SITE_URL}/sitemap.xml`,
+    host: SITE_URL,
+  };
+}

package/templates/storefront-bakery/app/shop/page.tsx

@@ -2,10 +2,11 @@ import type { Metadata } from "next";
 import { cacheTag, cacheLife } from "next/cache";
 import { getServerClient, tags } from "@cimplify/sdk/server";
 import { ShopClient } from "./shop-client";
+import { brand } from "@/lib/brand";
 
 export const metadata: Metadata = {
-  title: "Shop — Akua's Bakery",
-  description: "Browse the full catalogue: breads, pastries, cakes, drinks, merch, and more.",
+  title: `Shop — ${brand.name}`,
+  description: brand.description,
 };
 
 async function getShopData() {

package/templates/storefront-bakery/app/sitemap.ts

@@ -0,0 +1,62 @@
+import type { MetadataRoute } from "next";
+import { getServerClient, type Product } from "@cimplify/sdk/server";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+const STATIC_ROUTES: { path: string; priority: number; changeFrequency: "daily" | "weekly" | "monthly" }[] = [
+  { path: "/", priority: 1.0, changeFrequency: "daily" },
+  { path: "/shop", priority: 0.9, changeFrequency: "daily" },
+  { path: "/about", priority: 0.5, changeFrequency: "monthly" },
+  { path: "/faq", priority: 0.4, changeFrequency: "monthly" },
+  { path: "/terms", priority: 0.2, changeFrequency: "monthly" },
+  { path: "/privacy", priority: 0.2, changeFrequency: "monthly" },
+];
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const now = new Date();
+  const client = getServerClient();
+
+  const [productsRes, categoriesRes, collectionsRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+
+  const products = productsRes.ok ? productsRes.value.items : [];
+  const categories = categoriesRes.ok ? categoriesRes.value : [];
+  const collections = collectionsRes.ok ? collectionsRes.value : [];
+
+  const staticEntries: MetadataRoute.Sitemap = STATIC_ROUTES.map((r) => ({
+    url: `${SITE_URL}${r.path}`,
+    lastModified: now,
+    changeFrequency: r.changeFrequency,
+    priority: r.priority,
+  }));
+
+  // Bakery uses a URL-driven product modal (`?product=<slug>` on the home or
+  // shop pages). Emit those as deep-linkable URLs so search engines and LLMs
+  // can index each product canonically.
+  const productEntries: MetadataRoute.Sitemap = products.map((p: Product) => ({
+    url: `${SITE_URL}/shop?product=${encodeURIComponent(p.slug ?? p.id)}`,
+    lastModified: p.updated_at ? new Date(p.updated_at) : now,
+    changeFrequency: "weekly",
+    priority: 0.7,
+  }));
+
+  const categoryEntries: MetadataRoute.Sitemap = categories.map((c) => ({
+    url: `${SITE_URL}/categories/${c.slug}`,
+    lastModified: now,
+    changeFrequency: "weekly",
+    priority: 0.6,
+  }));
+
+  const collectionEntries: MetadataRoute.Sitemap = collections.map((c) => ({
+    url: `${SITE_URL}/collections/${c.slug}`,
+    lastModified: now,
+    changeFrequency: "weekly",
+    priority: 0.6,
+  }));
+
+  return [...staticEntries, ...categoryEntries, ...collectionEntries, ...productEntries];
+}

package/templates/storefront-bakery/app/terms/page.tsx

@@ -1,101 +1,43 @@
 import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
 
 export const metadata: Metadata = {
-  title: "Terms of Service — Akua's Bakery",
-  description: "The rules of the road for ordering from Akua's Bakery.",
+  title: `Terms of Service — ${brand.name}`,
+  description: `The rules of the road for ordering from ${brand.name}.`,
 };
 
 export default function TermsPage() {
+  const t = brand.terms;
   return (
     <article className="max-w-3xl mx-auto px-8 py-16 prose prose-lg max-w-none">
       <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2 not-prose">
-        Terms of service
+        {t.eyebrow}
       </p>
       <h1 className="font-serif text-[clamp(2.25rem,5vw,3.5rem)] font-semibold mb-2 -tracking-[0.02em]">
-        Terms of Service
+        {t.title}
       </h1>
       <p className="text-sm text-muted-foreground not-prose mb-10">
-        Last updated: 1 May 2026
+        Last updated: {t.lastUpdated}
       </p>
 
       <section className="space-y-5 leading-relaxed text-foreground/90">
-        <h2 className="font-serif text-2xl font-semibold mt-0">1. Who we are</h2>
-        <p>
-          Akua's Bakery (&quot;we&quot;, &quot;us&quot;) is a bakery and pâtisserie operating
-          at 12 Independence Avenue, Accra, Ghana. By placing an order through this
-          website, you (&quot;you&quot;, &quot;customer&quot;) agree to these terms.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">2. Orders and acceptance</h2>
-        <p>
-          Placing an order constitutes an offer to buy. We confirm acceptance by
-          sending an order confirmation email or SMS. Until acceptance, we may
-          decline an order — we'll refund any payment in full, immediately.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">3. Pricing and payment</h2>
-        <p>
-          Prices are in Ghana Cedis (GH₵) and include VAT where applicable.
-          Payment is due at checkout via Mobile Money, card, or cash on delivery.
-          We reserve the right to correct typographical pricing errors before
-          fulfilment.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">4. Delivery and pickup</h2>
-        <p>
-          Delivery times are estimates, not guarantees. We're not liable for
-          delays caused by weather, traffic, or events outside our control. If
-          a rider can't reach you within 30 minutes of arrival, the order may be
-          returned to the kitchen — please make sure your address and phone are
-          correct.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">5. Custom cakes</h2>
-        <p>
-          Custom cake orders require a 50% deposit at booking and the balance
-          before pickup or dispatch. Cancellations more than 72 hours before the
-          event date receive a full refund of the deposit; within 72 hours,
-          the deposit is non-refundable.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">6. Allergens</h2>
-        <p>
-          Our kitchen handles wheat, dairy, eggs, and tree nuts. We can't
-          guarantee freedom from cross-contamination. Customers with severe
-          allergies order at their own risk.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">7. Returns</h2>
-        <p>
-          Baked goods are non-returnable for food-safety reasons. If something
-          is wrong with your order, contact us within 24 hours of delivery and
-          we'll replace it, refund it, or credit your account — your choice.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">8. Liability</h2>
-        <p>
-          To the maximum extent permitted by Ghanaian law, our liability for any
-          claim arising from this website or your order is limited to the value
-          of the order. We're not liable for indirect or consequential losses.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">9. Governing law</h2>
-        <p>
-          These terms are governed by the laws of Ghana. Disputes will be
-          resolved in the courts of Greater Accra.
-        </p>
-
-        <h2 className="font-serif text-2xl font-semibold">10. Contact</h2>
-        <p>
-          Questions? Email{" "}
-          <a
-            href="mailto:hello@akuasbakery.test"
-            className="text-primary font-semibold hover:underline"
-          >
-            hello@akuasbakery.test
-          </a>
-          .
-        </p>
+        {t.sections.map((s) => (
+          <div key={s.heading}>
+            <h2 className="font-serif text-2xl font-semibold mt-0">{s.heading}</h2>
+            {typeof s.body === "string" ? (
+              <p>{s.body}</p>
+            ) : (
+              <>
+                <p>{s.body.intro}</p>
+                <ul className="list-disc pl-6 space-y-2">
+                  {s.body.bullets.map((b) => (
+                    <li key={b}>{b}</li>
+                  ))}
+                </ul>
+              </>
+            )}
+          </div>
+        ))}
       </section>
     </article>
   );