@cimplify/sdk 0.40.1 → 0.42.0

package/templates/storefront-fashion/app/sitemap-page/page.tsx

@@ -0,0 +1,167 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { cacheTag, cacheLife } from "next/cache";
+import { getServerClient, tags, type Product } from "@cimplify/sdk/server";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Sitemap — ${brand.name}`,
+  description: "A human-readable index of every page on this site.",
+};
+
+interface SitemapData {
+  products: { slug: string; name: string }[];
+  categories: { slug: string; name: string }[];
+  collections: { slug: string; name: string }[];
+}
+
+async function getSitemap(): Promise<SitemapData> {
+  "use cache";
+  cacheTag(tags.products(), tags.categories(), tags.collections());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const [pRes, cRes, colRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+  return {
+    products: (pRes.ok ? pRes.value.items : []).map((p: Product) => ({
+      slug: p.slug ?? p.id,
+      name: p.name,
+    })),
+    categories: (cRes.ok ? cRes.value : []).map((c) => ({ slug: c.slug, name: c.name })),
+    collections: (colRes.ok ? colRes.value : []).map((c) => ({ slug: c.slug, name: c.name })),
+  };
+}
+
+const STATIC_LINKS: { title: string; links: { href: string; label: string }[] }[] = [
+  {
+    title: "Browse",
+    links: [
+      { href: "/", label: "Home" },
+      { href: "/shop", label: "Shop" },
+      { href: "/search", label: "Search" },
+    ],
+  },
+  {
+    title: "Account",
+    links: [
+      { href: "/account", label: "Account" },
+      { href: "/account/orders", label: "Orders" },
+      { href: "/account/addresses", label: "Addresses" },
+      { href: "/account/settings", label: "Settings" },
+      { href: "/login", label: "Sign in" },
+      { href: "/signup", label: "Create account" },
+      { href: "/track-order", label: "Track an order" },
+      { href: "/cart", label: "Cart" },
+      { href: "/checkout", label: "Checkout" },
+    ],
+  },
+  {
+    title: "About",
+    links: [
+      { href: "/about", label: "About" },
+      { href: "/faq", label: "FAQ" },
+      { href: "/contact", label: "Contact" },
+    ],
+  },
+  {
+    title: "Policies",
+    links: [
+      { href: "/shipping", label: "Shipping" },
+      { href: "/returns", label: "Returns" },
+      { href: "/accessibility", label: "Accessibility" },
+      { href: "/terms", label: "Terms of Service" },
+      { href: "/privacy", label: "Privacy Policy" },
+    ],
+  },
+  {
+    title: "Machine-readable",
+    links: [
+      { href: "/sitemap.xml", label: "sitemap.xml (search engines)" },
+      { href: "/llms.txt", label: "llms.txt (LLM agents)" },
+      { href: "/robots.txt", label: "robots.txt" },
+      { href: "/opensearch.xml", label: "opensearch.xml (browser search)" },
+    ],
+  },
+];
+
+export default async function SitemapHtmlPage() {
+  const { products, categories, collections } = await getSitemap();
+
+  return (
+    <article className="max-w-5xl mx-auto px-6 sm:px-8 py-16">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2">
+        Sitemap
+      </p>
+      <h1 className="text-[clamp(2rem,4vw,2.75rem)] font-semibold mb-2 -tracking-[0.02em]">
+        Every page, in one place.
+      </h1>
+      <p className="text-muted-foreground mb-12">
+        For search engines, see <Link href="/sitemap.xml" className="text-primary hover:underline">/sitemap.xml</Link>.
+        For LLM agents, see <Link href="/llms.txt" className="text-primary hover:underline">/llms.txt</Link>.
+      </p>
+      <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-10">
+        {STATIC_LINKS.map((s) => (
+          <Section key={s.title} title={s.title}>
+            {s.links.map((l) => (
+              <li key={l.href}>
+                <Link href={l.href} className="hover:text-primary transition-colors">
+                  {l.label}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        ))}
+        {categories.length > 0 && (
+          <Section title="Categories">
+            {categories.map((c) => (
+              <li key={c.slug}>
+                <Link href={`/categories/${c.slug}`} className="hover:text-primary transition-colors">
+                  {c.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+        {collections.length > 0 && (
+          <Section title="Collections">
+            {collections.map((c) => (
+              <li key={c.slug}>
+                <Link href={`/collections/${c.slug}`} className="hover:text-primary transition-colors">
+                  {c.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+        {products.length > 0 && (
+          <Section title={`Products (${products.length})`}>
+            {products.map((p) => (
+              <li key={p.slug}>
+                <Link href={`/shop?product=${encodeURIComponent(p.slug)}`} className="hover:text-primary transition-colors">
+                  {p.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+      </div>
+    </article>
+  );
+}
+
+function Section({ title, children }: { title: string; children: React.ReactNode }) {
+  return (
+    <div>
+      <p className="font-semibold text-[12px] uppercase tracking-[0.12em] text-foreground mb-3">
+        {title}
+      </p>
+      <ul className="space-y-2 m-0 p-0 list-none text-sm text-muted-foreground">
+        {children}
+      </ul>
+    </div>
+  );
+}

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

@@ -0,0 +1,59 @@
+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,
+  }));
+
+  const productEntries: MetadataRoute.Sitemap = products.map((p: Product) => ({
+    url: `${SITE_URL}/products/${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-fashion/app/size-guide/page.tsx

@@ -0,0 +1,155 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Size Guide — ${brand.name}`,
+  description: "Chest, length, and shoulder measurements for every Studio FRX piece.",
+};
+
+interface SizeRow {
+  size: string;
+  chest: string;
+  length: string;
+  shoulder: string;
+}
+
+const TOPS_CHART: SizeRow[] = [
+  { size: "XS", chest: "104 cm / 41 in", length: "68 cm / 26.8 in", shoulder: "50 cm / 19.7 in" },
+  { size: "S", chest: "110 cm / 43.3 in", length: "70 cm / 27.5 in", shoulder: "52 cm / 20.5 in" },
+  { size: "M", chest: "116 cm / 45.7 in", length: "72 cm / 28.3 in", shoulder: "54 cm / 21.3 in" },
+  { size: "L", chest: "122 cm / 48 in", length: "74 cm / 29.1 in", shoulder: "56 cm / 22 in" },
+  { size: "XL", chest: "128 cm / 50.4 in", length: "76 cm / 29.9 in", shoulder: "58 cm / 22.8 in" },
+  { size: "2XL", chest: "134 cm / 52.7 in", length: "78 cm / 30.7 in", shoulder: "60 cm / 23.6 in" },
+  { size: "3XL", chest: "140 cm / 55.1 in", length: "80 cm / 31.5 in", shoulder: "62 cm / 24.4 in" },
+];
+
+const BOTTOMS_CHART: { size: string; waist: string; hip: string; inseam: string }[] = [
+  { size: "XS", waist: "72 cm / 28 in", hip: "92 cm / 36 in", inseam: "78 cm / 30.7 in" },
+  { size: "S", waist: "76 cm / 30 in", hip: "96 cm / 38 in", inseam: "78 cm / 30.7 in" },
+  { size: "M", waist: "82 cm / 32 in", hip: "102 cm / 40 in", inseam: "80 cm / 31.5 in" },
+  { size: "L", waist: "88 cm / 35 in", hip: "108 cm / 42.5 in", inseam: "80 cm / 31.5 in" },
+  { size: "XL", waist: "94 cm / 37 in", hip: "114 cm / 45 in", inseam: "82 cm / 32.3 in" },
+  { size: "2XL", waist: "102 cm / 40 in", hip: "122 cm / 48 in", inseam: "82 cm / 32.3 in" },
+];
+
+export default function SizeGuidePage() {
+  return (
+    <article className="max-w-4xl mx-auto px-6 sm:px-8 py-16">
+      <p className="text-[11px] font-mono uppercase tracking-[0.2em] text-primary mb-2">
+        Size guide
+      </p>
+      <h1 className="font-display text-[clamp(2.5rem,7vw,5rem)] uppercase mb-4 -tracking-[0.04em] leading-[0.95]">
+        Find your fit.
+      </h1>
+      <p className="text-base text-muted-foreground leading-relaxed max-w-2xl mb-12">
+        Our pieces are cut for an oversized, dropped-shoulder fit. Order true to size for
+        the intended fit; size down for a regular cut. All measurements are flat-laid
+        garment measurements.
+      </p>
+
+      <section className="mb-14">
+        <h2 className="text-2xl font-bold mb-2 -tracking-[0.025em]">Tops & outerwear</h2>
+        <p className="text-sm text-muted-foreground mb-4">
+          Hoodies, tees, sweats, jackets. Chest measured pit-to-pit, doubled. Length
+          measured from highest shoulder seam to hem.
+        </p>
+        <SizeTable
+          headings={["Size", "Chest", "Length", "Shoulder"]}
+          rows={TOPS_CHART.map((r) => [r.size, r.chest, r.length, r.shoulder])}
+        />
+      </section>
+
+      <section className="mb-14">
+        <h2 className="text-2xl font-bold mb-2 -tracking-[0.025em]">Bottoms</h2>
+        <p className="text-sm text-muted-foreground mb-4">
+          Trousers, shorts, sweats. Waist measured flat across the top of the
+          waistband, doubled.
+        </p>
+        <SizeTable
+          headings={["Size", "Waist", "Hip", "Inseam"]}
+          rows={BOTTOMS_CHART.map((r) => [r.size, r.waist, r.hip, r.inseam])}
+        />
+      </section>
+
+      <section className="rounded-2xl bg-foreground text-background p-8">
+        <h2 className="text-xl font-bold mb-3 -tracking-[0.025em]">How to measure yourself</h2>
+        <ul className="space-y-3 text-background/85 leading-relaxed">
+          <li>
+            <strong className="text-background">Chest</strong> — Wrap a soft tape around
+            the fullest part of your chest, under the arms, keeping the tape level.
+          </li>
+          <li>
+            <strong className="text-background">Waist</strong> — Around the narrowest part
+            of your waist, just above the navel.
+          </li>
+          <li>
+            <strong className="text-background">Hip</strong> — Around the fullest part of
+            your hips, feet together.
+          </li>
+          <li>
+            <strong className="text-background">Inseam</strong> — From the very top of the
+            inside of your leg down to the floor (no shoes).
+          </li>
+        </ul>
+      </section>
+
+      <p className="mt-12 text-sm text-muted-foreground">
+        Still unsure?{" "}
+        <a
+          href={`mailto:${brand.faq.contactEmail}`}
+          className="text-primary font-semibold hover:underline"
+        >
+          Email us your usual size in another brand
+        </a>{" "}
+        and we'll recommend a fit.
+      </p>
+    </article>
+  );
+}
+
+function SizeTable({
+  headings,
+  rows,
+}: {
+  headings: string[];
+  rows: string[][];
+}) {
+  return (
+    <div className="overflow-x-auto rounded-2xl border border-border">
+      <table className="w-full text-sm">
+        <thead className="bg-muted">
+          <tr>
+            {headings.map((h) => (
+              <th
+                key={h}
+                className="text-left font-semibold uppercase tracking-wider text-[11px] text-muted-foreground px-4 py-3"
+              >
+                {h}
+              </th>
+            ))}
+          </tr>
+        </thead>
+        <tbody>
+          {rows.map((r, i) => (
+            <tr
+              key={r[0]}
+              className={i % 2 === 0 ? "bg-background" : "bg-muted/30"}
+            >
+              {r.map((cell, j) => (
+                <td
+                  key={j}
+                  className={[
+                    "px-4 py-3 tabular-nums",
+                    j === 0 ? "font-semibold text-foreground" : "text-foreground/80",
+                  ].join(" ")}
+                >
+                  {cell}
+                </td>
+              ))}
+            </tr>
+          ))}
+        </tbody>
+      </table>
+    </div>
+  );
+}

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

@@ -0,0 +1,44 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  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-mono uppercase tracking-[0.16em] text-primary mb-2 not-prose">
+        {t.eyebrow}
+      </p>
+      <h1 className="text-[clamp(2.25rem,5vw,3.5rem)] font-bold mb-2 -tracking-[0.025em]">
+        {t.title}
+      </h1>
+      <p className="text-sm text-muted-foreground not-prose mb-10">
+        Last updated: {t.lastUpdated}
+      </p>
+
+      <section className="space-y-5 leading-relaxed text-foreground/90">
+        {t.sections.map((s) => (
+          <div key={s.heading}>
+            <h2 className="text-2xl font-semibold mt-0 -tracking-[0.02em]">{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-fashion/app/track-order/page.tsx

@@ -0,0 +1,24 @@
+import type { Metadata } from "next";
+import { TrackOrderForm } from "./track-order-form";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Track an order — ${brand.name}`,
+  description: brand.trackOrder.body,
+};
+
+export default function TrackOrderPage() {
+  const t = brand.trackOrder;
+  return (
+    <article className="max-w-2xl mx-auto px-6 sm:px-8 py-16">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2">
+        {t.eyebrow}
+      </p>
+      <h1 className="font-serif text-[clamp(2rem,5vw,3rem)] font-semibold mb-4 -tracking-[0.02em]">
+        {t.title}
+      </h1>
+      <p className="text-muted-foreground leading-relaxed mb-8">{t.body}</p>
+      <TrackOrderForm />
+    </article>
+  );
+}

package/templates/storefront-fashion/app/track-order/track-order-form.tsx

@@ -0,0 +1,69 @@
+"use client";
+
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+
+/**
+ * Guest order tracker. Routes /orders/<id> with the entered id; the
+ * post-checkout confirmation page already lives at /orders/[id] so this
+ * just sends the visitor there. Replace the redirect with a real lookup
+ * (e.g. Cimplify orders API + email-match guard) for production.
+ */
+export function TrackOrderForm() {
+  const router = useRouter();
+  const [orderId, setOrderId] = useState("");
+  const [email, setEmail] = useState("");
+
+  return (
+    <form
+      onSubmit={(e) => {
+        e.preventDefault();
+        if (!orderId.trim()) return;
+        router.push(`/orders/${encodeURIComponent(orderId.trim())}`);
+      }}
+      className="space-y-4 rounded-2xl border border-border bg-card p-6"
+    >
+      <div>
+        <label
+          htmlFor="orderId"
+          className="text-xs font-semibold uppercase tracking-wider text-muted-foreground block mb-1.5"
+        >
+          Order number
+        </label>
+        <input
+          id="orderId"
+          name="orderId"
+          required
+          value={orderId}
+          onChange={(e) => setOrderId(e.target.value)}
+          placeholder="ord_abc123…"
+          className="w-full px-4 py-3 rounded-md bg-background border border-border focus:border-primary focus:ring-2 focus:ring-primary/20 outline-none text-sm"
+        />
+      </div>
+      <div>
+        <label
+          htmlFor="email"
+          className="text-xs font-semibold uppercase tracking-wider text-muted-foreground block mb-1.5"
+        >
+          Order email
+        </label>
+        <input
+          id="email"
+          name="email"
+          type="email"
+          required
+          value={email}
+          onChange={(e) => setEmail(e.target.value)}
+          placeholder="you@email.com"
+          className="w-full px-4 py-3 rounded-md bg-background border border-border focus:border-primary focus:ring-2 focus:ring-primary/20 outline-none text-sm"
+        />
+      </div>
+      <button
+        type="submit"
+        className="w-full inline-flex items-center justify-center px-5 py-3 rounded-md bg-primary text-primary-foreground font-semibold text-sm hover:bg-primary/90 transition-colors"
+      >
+        Track order
+      </button>
+    </form>
+  );
+}

package/templates/storefront-fashion/components/account-iframe.tsx

@@ -0,0 +1,13 @@
+"use client";
+
+import { CimplifyAccount } from "@cimplify/sdk/react";
+
+/**
+ * Cimplify Account portal — iframe-mounted UI hosted by Cimplify Link.
+ * Handles sign-in, sign-up, OTP, addresses, payment methods, sessions,
+ * and order history. The iframe owns auth state; we just choose which
+ * `section` to land on.
+ */
+export function AccountIframe({ section }: { section?: string }) {
+  return <CimplifyAccount section={section} />;
+}

package/templates/storefront-fashion/components/brand-marquee.tsx

@@ -0,0 +1,27 @@
+import { brand } from "@/lib/brand";
+
+/**
+ * Brand authority strip. Wordmark-only (avoids licensing issues with real
+ * logos), monospaced for the brand-as-typography aesthetic.
+ */
+export function BrandMarquee() {
+  const strip = brand.brandStrip;
+  if (!strip || strip.brands.length === 0) return null;
+  return (
+    <section className="border-y border-border bg-background py-8 sm:py-10 overflow-hidden">
+      <p className="text-center text-[11px] font-mono uppercase tracking-[0.2em] text-muted-foreground mb-6">
+        {strip.headline}
+      </p>
+      <div className="flex items-center justify-around gap-10 sm:gap-14 flex-wrap px-6">
+        {strip.brands.map((b) => (
+          <span
+            key={b}
+            className="text-[clamp(1.25rem,2vw,1.75rem)] font-semibold text-muted-foreground hover:text-foreground transition-colors -tracking-[0.025em] opacity-70 hover:opacity-100"
+          >
+            {b}
+          </span>
+        ))}
+      </div>
+    </section>
+  );
+}

package/templates/storefront-fashion/components/cart-pill.tsx

@@ -0,0 +1,32 @@
+"use client";
+
+import Link from "next/link";
+import { useCartCount } from "@/lib/cart";
+
+/**
+ * Cart pill — dynamic island. Reads the live cart count via the SDK and
+ * renders a link to `/cart`. Wrap in `<Suspense fallback={<CartPillSkeleton/>}>`
+ * so the cached header chrome streams without blocking on the cart fetch.
+ */
+export function CartPill() {
+  const { count } = useCartCount();
+  return (
+    <Link
+      href="/cart"
+      className="inline-flex items-center gap-1.5 px-3.5 py-2 rounded-full bg-foreground text-background text-xs font-semibold tracking-wide transition-transform hover:scale-105"
+    >
+      Cart · {count}
+    </Link>
+  );
+}
+
+export function CartPillSkeleton() {
+  return (
+    <span
+      aria-hidden
+      className="inline-flex items-center gap-1.5 px-3.5 py-2 rounded-full bg-foreground/80 text-background text-xs font-semibold tracking-wide"
+    >
+      Cart · …
+    </span>
+  );
+}

package/templates/storefront-fashion/components/category-grid.tsx

@@ -0,0 +1,28 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { CategoryGrid as SdkCategoryGrid } from "@cimplify/sdk/react";
+import type { Category } from "@cimplify/sdk";
+
+/**
+ * Homepage category tiles — defers to the SDK's <CategoryGrid/> for layout
+ * and accessibility, and routes selections to /categories/:slug.
+ */
+export function CategoryGrid({ categories }: { categories?: Category[] }) {
+  const router = useRouter();
+  return (
+    <section className="max-w-7xl mx-auto px-8 pt-14">
+      <h2 className="font-serif text-[28px] font-semibold m-0 mb-5">Browse the menu</h2>
+      <SdkCategoryGrid
+        categories={categories}
+        onSelect={(c) => router.push(`/categories/${c.slug}`)}
+        classNames={{
+          item: "flex flex-col gap-1 p-6 bg-card border border-border rounded-2xl cursor-pointer text-left transition-all hover:border-primary hover:-translate-y-0.5",
+          name: "font-serif text-lg font-semibold text-foreground",
+          description: "text-xs text-muted-foreground",
+          count: "text-xs text-muted-foreground mt-1",
+        }}
+      />
+    </section>
+  );
+}