@morphika/andami 0.8.1 → 0.8.3

package/app/(site)/[slug]/page.tsx

@@ -7,6 +7,7 @@ import type { Page } from "../../../lib/sanity/types";
 import { PageRenderer } from "../../../components/blocks";
 import { getSiteConfig } from "../../../lib/config";
 import { assetUrl } from "../../../lib/assets";
+import BreadcrumbJsonLd from "../../../components/seo/BreadcrumbJsonLd";
 
 const cfg = getSiteConfig();
 
@@ -83,6 +84,12 @@ export default async function DynamicPage({ params }: PageProps) {
 
   return (
     <main className="min-h-screen">
+      <BreadcrumbJsonLd
+        items={[
+          { name: "Home", path: "/" },
+          { name: page.title },
+        ]}
+      />
       <PageRenderer page={page} />
     </main>
   );

package/app/(site)/work/[slug]/page.tsx

@@ -8,6 +8,7 @@ import { PageRenderer } from "../../../../components/blocks";
 import { getSiteConfig } from "../../../../lib/config";
 import { assetUrl } from "../../../../lib/assets";
 import ProjectJsonLd from "../../../../components/seo/ProjectJsonLd";
+import BreadcrumbJsonLd from "../../../../components/seo/BreadcrumbJsonLd";
 
 const cfg = getSiteConfig();
 
@@ -85,6 +86,13 @@ export default async function ProjectPage({ params }: ProjectPageProps) {
   return (
     <main className="min-h-screen">
       <ProjectJsonLd page={page} />
+      <BreadcrumbJsonLd
+        items={[
+          { name: "Home", path: "/" },
+          { name: "Work", path: "/work" },
+          { name: page.title },
+        ]}
+      />
       <PageRenderer page={page} />
     </main>
   );

package/app/llms.txt/route.ts

@@ -96,8 +96,12 @@ export async function GET() {
     lines.push("**Social profiles:**");
     for (const link of settings.social_links) {
       if (!link.url) continue;
-      const label = link.label ? link.label : link.url;
-      lines.push(`- ${label}: ${link.url}`);
+      const label = link.label?.trim();
+      // Emit "Label: URL" only when a meaningful label is present (and is not
+      // just a duplicate of the URL). Otherwise emit the URL alone — avoids
+      // the "URL: URL" duplication when a user types the URL into both fields.
+      const showLabel = label && label !== link.url;
+      lines.push(showLabel ? `- ${label}: ${link.url}` : `- ${link.url}`);
     }
     lines.push("");
   }

package/components/seo/BreadcrumbJsonLd.tsx

@@ -0,0 +1,49 @@
+/**
+ * BreadcrumbJsonLd — Server component that emits a `BreadcrumbList` JSON-LD
+ * record for nested pages. Helps Google understand site hierarchy and can
+ * replace the plain URL in SERP with visual breadcrumbs.
+ *
+ * Accepts items as relative paths (e.g. "/work") — the component resolves
+ * them against the configured domain so callers don't have to construct
+ * absolute URLs themselves. The last item typically omits `path` to indicate
+ * the current page.
+ *
+ * Example (project page):
+ *   <BreadcrumbJsonLd items={[
+ *     { name: "Home", path: "/" },
+ *     { name: "Work", path: "/work" },
+ *     { name: project.title },
+ *   ]} />
+ *
+ * Returns null (via the underlying builder) when fewer than 2 items are
+ * supplied — a single-item breadcrumb is not a breadcrumb.
+ */
+
+import JsonLd from "./JsonLd";
+import { buildBreadcrumbJsonLd } from "../../lib/seo/jsonld";
+import { getSiteConfig } from "../../lib/config";
+
+interface BreadcrumbJsonLdItem {
+  /** Display name of the crumb. */
+  name: string;
+  /** Relative path (e.g. "/work"). Omit for the current page (last item). */
+  path?: string;
+}
+
+interface BreadcrumbJsonLdProps {
+  items: BreadcrumbJsonLdItem[];
+}
+
+export default function BreadcrumbJsonLd({ items }: BreadcrumbJsonLdProps) {
+  const cfg = getSiteConfig();
+  const baseUrl = cfg.domain.replace(/\/$/, "");
+
+  const ld = buildBreadcrumbJsonLd({
+    items: items.map((item) => ({
+      name: item.name,
+      url: item.path ? `${baseUrl}${item.path.startsWith("/") ? "" : "/"}${item.path}` : undefined,
+    })),
+  });
+
+  return <JsonLd data={ld} />;
+}

package/lib/seo/jsonld.ts

@@ -60,6 +60,18 @@ export interface CreativeWorkInput {
   authorName?: string;
 }
 
+export interface BreadcrumbItem {
+  /** Display name of the crumb (e.g. "Work", "About"). */
+  name: string;
+  /** Absolute URL of the crumb's page. Omit for the current page (last item). */
+  url?: string;
+}
+
+export interface BreadcrumbInput {
+  /** Ordered list from root → current. First item is typically "Home". */
+  items: BreadcrumbItem[];
+}
+
 // ============================================
 // Builders
 // ============================================
@@ -172,3 +184,36 @@ export function buildCreativeWorkJsonLd(
 
   return ld;
 }
+
+/**
+ * BreadcrumbList — emitted on nested pages (project detail, regular pages
+ * below the homepage). Helps Google understand site hierarchy and can replace
+ * the plain URL in SERP with visual breadcrumbs (`morphika.tv › Work › Udon`).
+ *
+ * Per schema.org guidance, the last item (the current page) typically omits
+ * the `item` URL — the trailing item is the page the breadcrumb is rendered
+ * on, so the URL is redundant.
+ *
+ * Returns null when fewer than 2 items are supplied (a single-item breadcrumb
+ * is not a breadcrumb).
+ */
+export function buildBreadcrumbJsonLd(
+  input: BreadcrumbInput
+): Record<string, unknown> | null {
+  const items = (input.items || []).filter((i) => i && i.name);
+  if (items.length < 2) return null;
+
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((item, index) => {
+      const listItem: Record<string, unknown> = {
+        "@type": "ListItem",
+        position: index + 1,
+        name: item.name,
+      };
+      if (item.url) listItem.item = item.url;
+      return listItem;
+    }),
+  };
+}

package/lib/version.ts

@@ -6,4 +6,4 @@
  * Exposed as a plain constant so it can be imported without reading
  * package.json at runtime.
  */
-export const ANDAMI_VERSION = "0.8.1";
+export const ANDAMI_VERSION = "0.8.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphika/andami",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Visual Page Builder — core library. A reusable website builder with visual editing, CMS integration, and asset management.",
   "type": "module",
   "license": "MIT",

package/site/llms-txt.ts

@@ -2,9 +2,22 @@
  * @morphika/andami/site/llms-txt — AI/LLM-friendly site summary route.
  *
  * Re-exports the framework's /llms.txt route handler so instances can mount
- * it at `/llms.txt`. Required instance setup (one-time, see CHANGELOG):
+ * it at `/llms.txt`.
+ *
+ * Required instance setup (one-time):
  *
  *   // app/llms.txt/route.ts (in your instance repo)
- *   export { GET, revalidate } from "@morphika/andami/site/llms-txt";
+ *   import "@/lib/config-init";
+ *
+ *   // IMPORTANT: declare revalidate locally — Next.js requires
+ *   // statically-parseable route segment config and rejects re-exports.
+ *   export const revalidate = 86400;
+ *
+ *   export { GET } from "@morphika/andami/site/llms-txt";
+ *
+ * Note: `revalidate` is re-exported from this barrel only as a convenience
+ * value for instances that want to reference the same default — it must
+ * NOT be re-exported via `export { revalidate } from ...` inside the
+ * instance's route file (Turbopack/Next will fail the build).
  */
 export { GET, revalidate } from "../app/llms.txt/route";