@morphika/andami 0.8.1 → 0.8.5

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/layout.tsx

@@ -2,6 +2,9 @@ import type { Metadata } from "next";
 import { VisualEditing } from "next-sanity/visual-editing";
 import { draftMode } from "next/headers";
 import { registerConfig, getSiteConfig } from "../lib/config";
+import { getCachedSiteSettings } from "../lib/seo/site-settings";
+import { assetUrl } from "../lib/assets";
+import { buildFaviconMetadata } from "../lib/seo/favicon";
 import siteConfig from "../site.config";
 import "./globals.css";
 
@@ -12,26 +15,40 @@ registerConfig(siteConfig);
 
 const cfg = getSiteConfig();
 
-export const metadata: Metadata = {
-  title: {
-    default: cfg.defaults.metaTitle,
-    template: `%s — ${cfg.name}`,
-  },
-  description: cfg.defaults.metaDescription,
-  metadataBase: new URL(cfg.domain),
-  openGraph: {
-    title: cfg.defaults.metaTitle,
-    description: cfg.defaults.metaDescription,
-    siteName: cfg.name,
-    type: "website",
-    url: cfg.domain,
-  },
-  twitter: {
-    card: "summary_large_image",
-    title: cfg.defaults.metaTitle,
+// Use generateMetadata (dynamic) instead of `export const metadata` (static)
+// so we can read `siteSettings.favicon_path` from Sanity per render. The
+// underlying `getCachedSiteSettings()` is React-cache-dedup'd across the same
+// render pass, so SiteSeoHead (which also reads settings) shares the fetch.
+// With ISR enabled on pages, this effectively means one Sanity read per page
+// per revalidation window — negligible cost.
+export async function generateMetadata(): Promise<Metadata> {
+  const settings = await getCachedSiteSettings();
+  const faviconUrl = settings?.favicon_path
+    ? assetUrl(settings.favicon_path)
+    : undefined;
+
+  return {
+    title: {
+      default: cfg.defaults.metaTitle,
+      template: `%s — ${cfg.name}`,
+    },
     description: cfg.defaults.metaDescription,
-  },
-};
+    metadataBase: new URL(cfg.domain),
+    icons: buildFaviconMetadata(faviconUrl),
+    openGraph: {
+      title: cfg.defaults.metaTitle,
+      description: cfg.defaults.metaDescription,
+      siteName: cfg.name,
+      type: "website",
+      url: cfg.domain,
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: cfg.defaults.metaTitle,
+      description: cfg.defaults.metaDescription,
+    },
+  };
+}
 
 export default async function RootLayout({
   children,

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/favicon.ts

@@ -0,0 +1,20 @@
+/**
+ * Favicon — builder for the Next.js Metadata.icons field.
+ *
+ * The favicon URL should be pre-resolved to an absolute or root-relative
+ * URL by the caller (e.g. via assetUrl()) — this helper just shapes the
+ * Metadata.icons value and handles the empty case.
+ *
+ * Returns undefined when no URL is supplied so callers can spread the
+ * result into a Metadata object without leaving an empty `icons` field
+ * (Next.js would otherwise emit a default favicon hint).
+ */
+
+import type { Metadata } from "next";
+
+export function buildFaviconMetadata(
+  faviconUrl: string | null | undefined
+): Metadata["icons"] | undefined {
+  if (!faviconUrl) return undefined;
+  return { icon: faviconUrl };
+}

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.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphika/andami",
-  "version": "0.8.1",
+  "version": "0.8.5",
   "description": "Visual Page Builder — core library. A reusable website builder with visual editing, CMS integration, and asset management.",
   "type": "module",
   "license": "MIT",
@@ -82,6 +82,7 @@
     "./lib/editor": "./lib/editor/index.ts",
     "./lib/editor/*": "./lib/editor/*.ts",
     "./lib/animation/*": "./lib/animation/*.ts",
+    "./lib/seo/*": "./lib/seo/*.ts",
     "./lib/shader/glsl": "./lib/shader/glsl/index.ts",
     "./lib/backup/manifest": "./lib/backup/manifest.ts",
     "./lib/backup/export": "./lib/backup/export.ts",

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";