diff --git a/apps/web/app/_components/site-footer.tsx b/apps/web/app/_components/site-footer.tsx
index 4df64b5286..70d5a47814 100644
--- a/apps/web/app/_components/site-footer.tsx
+++ b/apps/web/app/_components/site-footer.tsx
@@ -5,7 +5,7 @@ export function SiteFooter() {
     <footer className="mt-auto border-t border-kumo-hairline">
       <div className="mx-auto flex w-full max-w-6xl items-center justify-center px-6 py-6">
         <Text variant="secondary" size="sm">
-          vinext is an open-source{" "}
+          vinext.dev is the official website for vinext, an open-source{" "}
           <a
             href="https://www.cloudflare.com/"
             className="underline underline-offset-2 hover:text-kumo-default"
diff --git a/apps/web/app/_components/site-header.tsx b/apps/web/app/_components/site-header.tsx
index 00beef5027..4370e9777b 100644
--- a/apps/web/app/_components/site-header.tsx
+++ b/apps/web/app/_components/site-header.tsx
@@ -1,7 +1,7 @@
 "use client";
 
 import { buttonVariants } from "@cloudflare/kumo/components/button";
-import { GaugeIcon, GithubLogoIcon, GraphIcon } from "@phosphor-icons/react/dist/ssr";
+import { BookOpenIcon, GaugeIcon, GithubLogoIcon, GraphIcon } from "@phosphor-icons/react/dist/ssr";
 import Link from "next/link";
 
 const navButton = buttonVariants({ variant: "ghost", size: "sm" });
@@ -14,6 +14,10 @@ export function SiteHeader() {
           <span className="font-semibold tracking-tight text-kumo-default">vinext</span>
         </Link>
         <nav className="flex items-center gap-2">
+          <Link href="/readme" className={navButton}>
+            <BookOpenIcon />
+            Docs
+          </Link>
           <Link href="/compatibility" className={navButton}>
             <GraphIcon />
             Compatibility
diff --git a/apps/web/app/_components/structured-data.tsx b/apps/web/app/_components/structured-data.tsx
new file mode 100644
index 0000000000..f25f0d9db0
--- /dev/null
+++ b/apps/web/app/_components/structured-data.tsx
@@ -0,0 +1,12 @@
+/**
+ * Emits a schema.org graph as JSON-LD. Server component — the script must be in
+ * the initial HTML, not injected on hydration, or crawlers never see it.
+ */
+export function StructuredData({ graph }: { graph: unknown }) {
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify(graph) }}
+    />
+  );
+}
diff --git a/apps/web/app/_lib/structured-data.ts b/apps/web/app/_lib/structured-data.ts
new file mode 100644
index 0000000000..736c89a823
--- /dev/null
+++ b/apps/web/app/_lib/structured-data.ts
@@ -0,0 +1,102 @@
+/**
+ * Shared schema.org graph for vinext.dev.
+ *
+ * The site competes for the "vinext" query against community mirrors that
+ * publish richer entity markup than we do. Every node here is stably `@id`'d so
+ * the whole site describes one entity rather than three unrelated graphs, and
+ * `sameAs` enumerates the corroborating profiles (repo, announcement, npm) that
+ * only the official site can legitimately claim.
+ */
+
+const SITE_URL = "https://vinext.dev";
+const REPO_URL = "https://github.com/cloudflare/vinext";
+const ANNOUNCEMENT_URL = "https://blog.cloudflare.com/vinext/";
+const CLOUDFLARE_URL = "https://www.cloudflare.com";
+
+const ORGANIZATION_ID = `${SITE_URL}/#organization`;
+const SOFTWARE_ID = `${SITE_URL}/#software`;
+const WEBSITE_ID = `${SITE_URL}/#website`;
+
+const SITE_NAME = "vinext";
+export const SITE_DESCRIPTION =
+  "Take any Next.js app and deploy it anywhere with one command. App Router, Pages Router, RSC, ISR — all on Vite.";
+
+type JsonLdNode = Record<string, unknown>;
+
+const organization: JsonLdNode = {
+  "@type": "Organization",
+  "@id": ORGANIZATION_ID,
+  name: "Cloudflare",
+  url: CLOUDFLARE_URL,
+  sameAs: [
+    "https://github.com/cloudflare",
+    "https://www.wikidata.org/wiki/Q2748854",
+    "https://en.wikipedia.org/wiki/Cloudflare",
+  ],
+};
+
+const website: JsonLdNode = {
+  "@type": "WebSite",
+  "@id": WEBSITE_ID,
+  name: SITE_NAME,
+  alternateName: "vinext — the official website",
+  description: SITE_DESCRIPTION,
+  url: `${SITE_URL}/`,
+  inLanguage: "en",
+  publisher: { "@id": ORGANIZATION_ID },
+  about: { "@id": SOFTWARE_ID },
+};
+
+const software: JsonLdNode = {
+  "@type": "SoftwareApplication",
+  "@id": SOFTWARE_ID,
+  name: SITE_NAME,
+  description: SITE_DESCRIPTION,
+  url: `${SITE_URL}/`,
+  applicationCategory: "DeveloperApplication",
+  operatingSystem: "Web",
+  isAccessibleForFree: true,
+  license: `${REPO_URL}/blob/main/LICENSE`,
+  author: { "@id": ORGANIZATION_ID },
+  creator: { "@id": ORGANIZATION_ID },
+  publisher: { "@id": ORGANIZATION_ID },
+  sameAs: [REPO_URL, ANNOUNCEMENT_URL, "https://www.npmjs.com/package/vinext"],
+};
+
+const sourceCode: JsonLdNode = {
+  "@type": "SoftwareSourceCode",
+  name: SITE_NAME,
+  description: SITE_DESCRIPTION,
+  url: `${SITE_URL}/`,
+  codeRepository: REPO_URL,
+  programmingLanguage: "TypeScript",
+  license: `${REPO_URL}/blob/main/LICENSE`,
+  author: { "@id": ORGANIZATION_ID },
+  isPartOf: { "@id": SOFTWARE_ID },
+};
+
+/** Rendered once per page from the root layout. */
+export const siteGraph = {
+  "@context": "https://schema.org",
+  "@graph": [organization, website, software, sourceCode],
+};
+
+/**
+ * Breadcrumbs for a second-level page. The home crumb is always first so every
+ * subpage restates vinext.dev as the root of the entity.
+ */
+export function breadcrumbGraph(name: string, path: string) {
+  return {
+    "@context": "https://schema.org",
+    "@graph": [
+      {
+        "@type": "BreadcrumbList",
+        "@id": `${SITE_URL}${path}#breadcrumb`,
+        itemListElement: [
+          { "@type": "ListItem", position: 1, name: SITE_NAME, item: `${SITE_URL}/` },
+          { "@type": "ListItem", position: 2, name, item: `${SITE_URL}${path}` },
+        ],
+      },
+    ],
+  };
+}
diff --git a/apps/web/app/benchmarks/metadata.ts b/apps/web/app/benchmarks/metadata.ts
index 87e39ec3ab..58991a308c 100644
--- a/apps/web/app/benchmarks/metadata.ts
+++ b/apps/web/app/benchmarks/metadata.ts
@@ -13,9 +13,11 @@ export function createBenchmarkMetadata({
   path,
   index = true,
 }: BenchmarkMetadataOptions): Metadata {
+  // The root layout templates the document title as `%s — vinext`; openGraph and
+  // twitter titles are not templated, so they still need the brand spelled out.
   const brandedTitle = `${title} — vinext`;
   return {
-    title: brandedTitle,
+    title,
     description,
     alternates: { canonical: path },
     robots: index ? undefined : { index: false, follow: true },
diff --git a/apps/web/app/benchmarks/page.tsx b/apps/web/app/benchmarks/page.tsx
index fc831a84e2..faf1d8264b 100644
--- a/apps/web/app/benchmarks/page.tsx
+++ b/apps/web/app/benchmarks/page.tsx
@@ -1,10 +1,15 @@
 import type { Metadata } from "next";
 import { Dashboard } from "./components/dashboard";
 import { getPerformanceRuns } from "@/app/lib/benchmarks/server";
+import { StructuredData } from "@/app/_components/structured-data";
+import { breadcrumbGraph } from "@/app/_lib/structured-data";
 
 export const revalidate = 300;
 
-const title = "Performance benchmarks — vinext";
+// Bare title: the root layout's `%s — vinext` template supplies the suffix.
+// openGraph/twitter titles are not templated, so they carry the brand explicitly.
+const title = "Performance benchmarks";
+const brandedTitle = `${title} — vinext`;
 const description =
   "Compare vinext and Next.js production build time, dev server startup, and bundle size.";
 
@@ -18,23 +23,24 @@ export const metadata: Metadata = {
     type: "website",
     locale: "en_US",
     siteName: "vinext",
-    title,
+    title: brandedTitle,
     description,
     url: "/benchmarks",
   },
 };
 
 /**
- * Homepage — server component shell.
+ * /benchmarks — server component shell.
  * The interactive dashboard (tabs, charts, data fetching) is a client component.
  */
-export default async function HomePage() {
+export default async function BenchmarksPage() {
   const runs = await getPerformanceRuns();
 
   return (
     <div className="mx-auto w-full max-w-6xl px-6 py-8">
+      <StructuredData graph={breadcrumbGraph(title, "/benchmarks")} />
       <div className="mb-8">
-        <h1 className="text-2xl font-bold tracking-tight">Performance Dashboard</h1>
+        <h1 className="text-3xl font-semibold tracking-tight">vinext performance benchmarks</h1>
         <p className="mt-1 text-sm text-gray-500">
           Benchmarks run on every merge to main. Comparing Next.js (Turbopack) vs vinext (Vite 8).
         </p>
diff --git a/apps/web/app/compatibility/compat-labels.ts b/apps/web/app/compatibility/compat-labels.ts
new file mode 100644
index 0000000000..3ed18e3db4
--- /dev/null
+++ b/apps/web/app/compatibility/compat-labels.ts
@@ -0,0 +1,101 @@
+/**
+ * Shared vocabulary for the compatibility views.
+ *
+ * These live in a plain module rather than in contribution-grid.tsx because
+ * that file is a client component: importing values from it into the server
+ * component turns them into client-reference proxies that throw when called.
+ * The server-rendered results table in page.tsx needs the same labels the grid
+ * uses, so they belong on this side of the boundary.
+ */
+import type { FileStatus, RouterKind } from "@/app/lib/db/schema";
+import { VITE_EQUIVALENT_LABEL, type SuiteSupportStatus } from "./suite-support";
+
+export type GridCell = {
+  suite: string;
+  status: FileStatus;
+  router: RouterKind;
+  supportStatus: SuiteSupportStatus;
+  feature: string | null;
+  reason: string | null;
+  total: number;
+  passed: number;
+  failed: number;
+  skipped: number;
+};
+
+export type DisplayStatus = FileStatus | Exclude<SuiteSupportStatus, "supported">;
+
+export const LABELS: Record<DisplayStatus, string> = {
+  pass: "Pass",
+  partial: "Partial",
+  fail: "Fail",
+  skip: "Skipped by Next.js",
+  deferred: "Deferred",
+  "needs-vite-equivalent": VITE_EQUIVALENT_LABEL,
+  unsupported: "Unsupported by vinext",
+};
+
+export const SUPPORT_LABELS: Record<SuiteSupportStatus, string> = {
+  supported: "Supported",
+  deferred: "Deferred",
+  "needs-vite-equivalent": VITE_EQUIVALENT_LABEL,
+  unsupported: "Unsupported by vinext",
+};
+
+export const ROUTER_LABELS: Record<RouterKind, string> = {
+  app: "App Router",
+  pages: "Pages Router",
+  both: "Mixed (App + Pages)",
+  unknown: "No router fixture",
+};
+
+/**
+ * The compatibility-scope classification wins over the raw test result, so a
+ * deliberately deferred suite does not read as a failure.
+ */
+export function getDisplayStatus(cell: GridCell): DisplayStatus {
+  return cell.supportStatus === "supported" ? cell.status : cell.supportStatus;
+}
+
+/**
+ * Groups a test file by the part of the Next.js suite it belongs to:
+ *
+ *   test/e2e/app-dir/foo.test.ts        → "app-dir"
+ *   test/e2e/middleware/foo.test.ts     → "middleware"
+ *   test/e2e/foo.test.ts                → "e2e"
+ *   test/integration/foo.test.ts        → "integration"
+ *   test/unit/foo.test.ts               → "unit"
+ *
+ * Returns null when the path has been collapsed to a basename (older reports
+ * that don't preserve path info) — the caller hides the row.
+ */
+export function deriveSuiteGroup(suite: string): string | null {
+  if (!suite.includes("/")) return null;
+  const parts = suite.split("/").filter(Boolean);
+  // Strip a leading "test/" if present.
+  const start = parts[0] === "test" ? 1 : 0;
+  const first = parts[start];
+  if (!first) return null;
+  // For test/e2e/<group>/file or test/integration/<group>/file, use the
+  // sub-group when there is one beyond the leaf file. Otherwise fall back
+  // to the top-level directory (e.g. "e2e", "integration").
+  if (parts.length - start >= 3) return parts[start + 1];
+  return first;
+}
+
+export function summarize(cell: GridCell): string {
+  const parts = [`${cell.passed}/${cell.total} passed`];
+  if (cell.failed > 0) parts.push(`${cell.failed} failed`);
+  if (cell.skipped > 0) parts.push(`${cell.skipped} skipped`);
+  const group = deriveSuiteGroup(cell.suite);
+  const prefix = group ? `[${group}] ${cell.suite}` : cell.suite;
+  const routerTag = ROUTER_LABELS[cell.router];
+  const displayStatus = getDisplayStatus(cell);
+  const rawStatus = displayStatus === cell.status ? "" : ` · raw result: ${LABELS[cell.status]}`;
+  return `${prefix} — ${LABELS[displayStatus]}${rawStatus} · ${routerTag} (${parts.join(", ")})`;
+}
+
+/** Groups a cell for the results table: its feature label, else its suite group. */
+export function groupKey(cell: GridCell): string {
+  return cell.feature ?? deriveSuiteGroup(cell.suite) ?? "Other";
+}
diff --git a/apps/web/app/compatibility/contribution-grid.tsx b/apps/web/app/compatibility/contribution-grid.tsx
index 6b50c20911..f2894ec6cf 100644
--- a/apps/web/app/compatibility/contribution-grid.tsx
+++ b/apps/web/app/compatibility/contribution-grid.tsx
@@ -23,9 +23,21 @@ import { Input } from "@cloudflare/kumo/components/input";
 import { Select } from "@cloudflare/kumo/components/select";
 import { Table } from "@cloudflare/kumo/components/table";
 import { Table as TableIcon, X } from "@phosphor-icons/react";
-import type { FileStatus, RouterKind } from "@/app/lib/db/schema";
+import type { FileStatus } from "@/app/lib/db/schema";
 import { cellMatchesFilter, type RouterFilter } from "./router-buckets";
 import { VITE_EQUIVALENT_LABEL, type SuiteSupportStatus } from "./suite-support";
+import {
+  deriveSuiteGroup,
+  getDisplayStatus,
+  summarize,
+  LABELS,
+  ROUTER_LABELS,
+  SUPPORT_LABELS,
+  type DisplayStatus,
+  type GridCell,
+} from "./compat-labels";
+
+export type { GridCell };
 
 // (Tabs / filter UI now lives in compatibility-views.tsx; the grid receives
 // the active filter as a prop. Filter semantics — what each value means and
@@ -35,21 +47,6 @@ import { VITE_EQUIVALENT_LABEL, type SuiteSupportStatus } from "./suite-support"
 // on the server (where there is nothing to measure anyway).
 const useIsoLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
 
-export type GridCell = {
-  suite: string;
-  status: FileStatus;
-  router: RouterKind;
-  supportStatus: SuiteSupportStatus;
-  feature: string | null;
-  reason: string | null;
-  total: number;
-  passed: number;
-  failed: number;
-  skipped: number;
-};
-
-type DisplayStatus = FileStatus | Exclude<SuiteSupportStatus, "supported">;
-
 const COLORS: Record<DisplayStatus, string> = {
   pass: "#2da44e", // green
   partial: "#e08600", // orange
@@ -60,23 +57,6 @@ const COLORS: Record<DisplayStatus, string> = {
   unsupported: "#6e7781", // dark gray
 };
 
-const LABELS: Record<DisplayStatus, string> = {
-  pass: "Pass",
-  partial: "Partial",
-  fail: "Fail",
-  skip: "Skipped by Next.js",
-  deferred: "Deferred",
-  "needs-vite-equivalent": VITE_EQUIVALENT_LABEL,
-  unsupported: "Unsupported by vinext",
-};
-
-const SUPPORT_LABELS: Record<SuiteSupportStatus, string> = {
-  supported: "Supported",
-  deferred: "Deferred",
-  "needs-vite-equivalent": VITE_EQUIVALENT_LABEL,
-  unsupported: "Unsupported by vinext",
-};
-
 const SUPPORT_COLORS: Record<SuiteSupportStatus, string> = {
   supported: "#2da44e",
   deferred: COLORS.deferred,
@@ -94,13 +74,6 @@ const LEGEND_ORDER: DisplayStatus[] = [
   "skip",
 ];
 
-const ROUTER_LABELS: Record<RouterKind, string> = {
-  app: "App Router",
-  pages: "Pages Router",
-  both: "Mixed (App + Pages)",
-  unknown: "No router fixture",
-};
-
 const CELL_SIZE = 12;
 const GAP = 3;
 const STRIDE = CELL_SIZE + GAP;
@@ -110,22 +83,6 @@ const STRIDE = CELL_SIZE + GAP;
 // the real width on the first frame.
 const SSR_COLS = 60;
 
-function summarize(cell: GridCell): string {
-  const parts = [`${cell.passed}/${cell.total} passed`];
-  if (cell.failed > 0) parts.push(`${cell.failed} failed`);
-  if (cell.skipped > 0) parts.push(`${cell.skipped} skipped`);
-  const group = deriveSuiteGroup(cell.suite);
-  const prefix = group ? `[${group}] ${cell.suite}` : cell.suite;
-  const routerTag = ROUTER_LABELS[cell.router];
-  const displayStatus = getDisplayStatus(cell);
-  const rawStatus = displayStatus === cell.status ? "" : ` · raw result: ${LABELS[cell.status]}`;
-  return `${prefix} — ${LABELS[displayStatus]}${rawStatus} · ${routerTag} (${parts.join(", ")})`;
-}
-
-function getDisplayStatus(cell: GridCell): DisplayStatus {
-  return cell.supportStatus === "supported" ? cell.status : cell.supportStatus;
-}
-
 type SupportFilter = "all" | SuiteSupportStatus;
 type ResultFilter = "all" | FileStatus;
 
@@ -292,35 +249,6 @@ export function CompatibilityTableDialog({ cells }: { cells: GridCell[] }) {
   );
 }
 
-/**
- * Derive a display "suite" (group) label from the test file path.
- *
- * Next.js's deploy tests live under predictable directories; the first
- * meaningful path segment is a reliable bucket:
- *
- *   test/e2e/app-dir/foo.test.ts        → "app-dir"
- *   test/e2e/middleware/foo.test.ts     → "middleware"
- *   test/e2e/foo.test.ts                → "e2e"
- *   test/integration/foo.test.ts        → "integration"
- *   test/unit/foo.test.ts               → "unit"
- *
- * Returns null when the path has been collapsed to a basename (older
- * reports that don't preserve path info) — the caller hides the row.
- */
-function deriveSuiteGroup(suite: string): string | null {
-  if (!suite.includes("/")) return null;
-  const parts = suite.split("/").filter(Boolean);
-  // Strip a leading "test/" if present.
-  const start = parts[0] === "test" ? 1 : 0;
-  const first = parts[start];
-  if (!first) return null;
-  // For test/e2e/<group>/file or test/integration/<group>/file, use the
-  // sub-group when there is one beyond the leaf file. Otherwise fall back
-  // to the top-level directory (e.g. "e2e", "integration").
-  if (parts.length - start >= 3) return parts[start + 1];
-  return first;
-}
-
 export function ContributionGrid({
   cells,
   filter = "all",
diff --git a/apps/web/app/compatibility/page.tsx b/apps/web/app/compatibility/page.tsx
index 6e9ca386e9..8da2132bb8 100644
--- a/apps/web/app/compatibility/page.tsx
+++ b/apps/web/app/compatibility/page.tsx
@@ -15,6 +15,8 @@ import { ArrowSquareOutIcon } from "@phosphor-icons/react/dist/ssr";
 import { and, desc, eq, sql } from "drizzle-orm";
 import type { Metadata } from "next";
 import { getDb } from "@/app/lib/db/client";
+import { StructuredData } from "@/app/_components/structured-data";
+import { breadcrumbGraph } from "@/app/_lib/structured-data";
 import {
   compatRuns,
   compatFileResults,
@@ -22,7 +24,14 @@ import {
   type RouterKind,
 } from "@/app/lib/db/schema";
 import { CompatibilityViews } from "./compatibility-views";
-import type { GridCell } from "./contribution-grid";
+import {
+  getDisplayStatus,
+  groupKey,
+  LABELS,
+  ROUTER_LABELS,
+  SUPPORT_LABELS,
+  type GridCell,
+} from "./compat-labels";
 import type { TrendPoint } from "./compatibility-line-chart";
 import { bucketByRouter, bucketPassRate, bucketSupportedPassRate } from "./router-buckets";
 import { getSuiteSupport, NON_SUPPORTED_SUITES } from "./suite-support";
@@ -32,7 +41,9 @@ import { getSuiteSupport, NON_SUPPORTED_SUITES } from "./suite-support";
 // and keeps the page snappy without re-querying D1 on every request.
 export const revalidate = 300;
 
-const title = "Next.js compatibility — vinext";
+// Bare title: the root layout's `%s — vinext` template supplies the suffix.
+const title = "Next.js compatibility";
+const brandedTitle = `${title} — vinext`;
 const description =
   "Track vinext compatibility with the Next.js API surface using results from the Next.js deploy test suite.";
 
@@ -46,7 +57,7 @@ export const metadata: Metadata = {
     type: "website",
     locale: "en_US",
     siteName: "vinext",
-    title,
+    title: brandedTitle,
     description,
     url: "/compatibility",
   },
@@ -327,6 +338,18 @@ async function runQueries(
   return { latestRun, latestFiles, trend };
 }
 
+/** Buckets cells by feature label, falling back to the path-derived suite group. */
+function groupCells(cells: GridCell[]): Map<string, GridCell[]> {
+  const groups = new Map<string, GridCell[]>();
+  for (const cell of cells) {
+    const key = groupKey(cell);
+    const existing = groups.get(key);
+    if (existing) existing.push(cell);
+    else groups.set(key, [cell]);
+  }
+  return groups;
+}
+
 export default async function CompatibilityPage() {
   const { latestRun, latestFiles, trend, error } = await loadData(KIND);
   const byRouter = bucketByRouter(latestFiles);
@@ -339,11 +362,24 @@ export default async function CompatibilityPage() {
     (file) => file.supportStatus === "supported" && file.failed > 0,
   ).length;
 
+  // Grouped copy of the same cells for the server-rendered results table below.
+  // Classified features come first (they carry the prose a reader is looking
+  // for); path-derived buckets follow, alphabetically.
+  const resultGroups = [...groupCells(latestFiles).entries()]
+    .map(([name, cells]) => ({ name, cells }))
+    .sort((a, b) => {
+      const aClassified = a.cells[0].feature !== null;
+      const bClassified = b.cells[0].feature !== null;
+      if (aClassified !== bClassified) return aClassified ? -1 : 1;
+      return a.name.localeCompare(b.name);
+    });
+
   return (
     <>
+      <StructuredData graph={breadcrumbGraph(title, "/compatibility")} />
       <section className="mx-auto w-full max-w-6xl px-6 pt-16 pb-10">
         <h1 className="text-4xl font-semibold tracking-tight text-kumo-default sm:text-5xl">
-          Next.js compatibility
+          vinext Next.js compatibility
         </h1>
         <p className="mt-4 max-w-2xl text-kumo-subtle">
           Results from the Next.js deploy test suite, run against vinext. Each dot below is one test
@@ -458,6 +494,75 @@ export default async function CompatibilityPage() {
         </div>
       </section>
 
+      {latestFiles.length > 0 ? (
+        <section className="mx-auto w-full max-w-6xl px-6 pb-20">
+          <div className="mb-4">
+            <Text variant="heading2" as="h2">
+              Full results by feature
+            </Text>
+            <p className="mt-2 max-w-3xl text-sm leading-relaxed text-kumo-subtle">
+              Every test file in the latest run, grouped by the Next.js feature it covers. The grid
+              above renders the same data as an SVG, where the file names are tooltips rather than
+              text — this table is the readable version, and the one search engines can index.
+            </p>
+          </div>
+
+          <details className="rounded-lg bg-kumo-base ring ring-kumo-hairline">
+            <summary className="cursor-pointer px-6 py-4 text-sm font-medium text-kumo-default">
+              Show all {latestFiles.length} test files
+            </summary>
+            <div className="flex flex-col gap-8 px-6 pb-6">
+              {resultGroups.map(({ name, cells }) => (
+                <div key={name}>
+                  <Text variant="heading3" as="h3">
+                    {name}
+                  </Text>
+                  <p className="mt-1 mb-3 text-sm text-kumo-subtle">
+                    {cells.length} test file{cells.length === 1 ? "" : "s"}
+                    {cells[0].reason ? ` — ${cells[0].reason}` : ""}
+                  </p>
+                  <div className="overflow-x-auto">
+                    <table className="w-full min-w-[44rem] border-collapse text-left text-sm">
+                      <thead>
+                        <tr className="border-b border-kumo-hairline text-kumo-subtle">
+                          <th className="py-2 pr-4 font-medium">Test file</th>
+                          <th className="py-2 pr-4 font-medium">Result</th>
+                          <th className="py-2 pr-4 font-medium">Router</th>
+                          <th className="py-2 pr-4 font-medium">Scope</th>
+                          <th className="py-2 pr-4 text-right font-medium">Passed</th>
+                          <th className="py-2 pr-4 text-right font-medium">Failed</th>
+                          <th className="py-2 text-right font-medium">Skipped</th>
+                        </tr>
+                      </thead>
+                      <tbody>
+                        {cells.map((cell) => (
+                          <tr
+                            key={cell.suite}
+                            className="border-b border-kumo-hairline last:border-0"
+                          >
+                            <td className="py-2 pr-4 font-mono text-xs text-kumo-default">
+                              {cell.suite}
+                            </td>
+                            <td className="py-2 pr-4">{LABELS[getDisplayStatus(cell)]}</td>
+                            <td className="py-2 pr-4">{ROUTER_LABELS[cell.router]}</td>
+                            <td className="py-2 pr-4">{SUPPORT_LABELS[cell.supportStatus]}</td>
+                            <td className="py-2 pr-4 text-right tabular-nums">
+                              {cell.passed}/{cell.total}
+                            </td>
+                            <td className="py-2 pr-4 text-right tabular-nums">{cell.failed}</td>
+                            <td className="py-2 text-right tabular-nums">{cell.skipped}</td>
+                          </tr>
+                        ))}
+                      </tbody>
+                    </table>
+                  </div>
+                </div>
+              ))}
+            </div>
+          </details>
+        </section>
+      ) : null}
+
       <section className="mx-auto w-full max-w-4xl px-6 pb-24">
         <div className="flex flex-col items-start gap-3 rounded-lg bg-kumo-base p-6 ring ring-kumo-hairline">
           <Text variant="heading3" as="h3">
diff --git a/apps/web/app/globals.css b/apps/web/app/globals.css
index 9dd867e265..e644f7b177 100644
--- a/apps/web/app/globals.css
+++ b/apps/web/app/globals.css
@@ -34,3 +34,183 @@ body {
   display: block;
   min-width: max-content;
 }
+
+/*
+ * /readme — prose styles for the build-time-rendered README.
+ *
+ * @tailwindcss/typography is in the workspace catalog but is not a dependency
+ * of this app, so the element styles are written out here. Scoped to
+ * .vinext-readme so they cannot leak into the rest of the site.
+ */
+.vinext-readme {
+  color: var(--text-color-kumo-subtle);
+  line-height: 1.7;
+  font-size: 0.9375rem;
+}
+
+.vinext-readme h2,
+.vinext-readme h3,
+.vinext-readme h4,
+.vinext-readme h5,
+.vinext-readme h6 {
+  color: var(--text-color-kumo-default);
+  font-weight: 600;
+  letter-spacing: -0.015em;
+  scroll-margin-top: 2rem;
+}
+
+.vinext-readme h2 {
+  font-size: 1.75rem;
+  margin: 3rem 0 1rem;
+  padding-top: 2rem;
+  border-top: 1px solid var(--color-kumo-hairline);
+}
+
+.vinext-readme h2:first-child {
+  margin-top: 0;
+  padding-top: 0;
+  border-top: 0;
+}
+
+.vinext-readme h3 {
+  font-size: 1.25rem;
+  margin: 2.25rem 0 0.75rem;
+}
+
+.vinext-readme h4,
+.vinext-readme h5,
+.vinext-readme h6 {
+  font-size: 1rem;
+  margin: 1.75rem 0 0.5rem;
+}
+
+.vinext-readme p {
+  margin: 0 0 1rem;
+}
+
+.vinext-readme a {
+  color: var(--text-color-kumo-default);
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+.vinext-readme strong {
+  color: var(--text-color-kumo-default);
+  font-weight: 600;
+}
+
+.vinext-readme ul,
+.vinext-readme ol {
+  margin: 0 0 1rem;
+  padding-left: 1.25rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+}
+
+.vinext-readme ul {
+  list-style: disc;
+}
+
+.vinext-readme ol {
+  list-style: decimal;
+}
+
+.vinext-readme li ul,
+.vinext-readme li ol {
+  margin: 0.375rem 0 0;
+}
+
+.vinext-readme :not(pre) > code {
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 0.85em;
+  color: var(--text-color-kumo-default);
+  background: var(--color-kumo-elevated);
+  border: 1px solid var(--color-kumo-hairline);
+  border-radius: 3px;
+  padding: 0.08em 0.32em;
+}
+
+.vinext-readme pre {
+  margin: 0 0 1.25rem;
+  padding: 1.25rem;
+  overflow-x: auto;
+  border-radius: 0.5rem;
+  border: 1px solid var(--color-kumo-hairline);
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 0.8125rem;
+  line-height: 1.7;
+}
+
+.vinext-readme blockquote {
+  margin: 0 0 1.25rem;
+  padding: 0.25rem 0 0.25rem 1rem;
+  border-left: 2px solid var(--color-kumo-hairline);
+}
+
+.vinext-readme blockquote p:last-child {
+  margin-bottom: 0;
+}
+
+.vinext-readme hr {
+  margin: 2.5rem 0;
+  border: 0;
+  border-top: 1px solid var(--color-kumo-hairline);
+}
+
+.vinext-readme details {
+  margin: 0 0 1rem;
+  padding: 1rem 1.25rem;
+  border-radius: 0.5rem;
+  border: 1px solid var(--color-kumo-hairline);
+  background: var(--color-kumo-base);
+}
+
+.vinext-readme summary {
+  cursor: pointer;
+  font-weight: 600;
+  color: var(--text-color-kumo-default);
+}
+
+.vinext-readme details[open] summary {
+  margin-bottom: 1rem;
+}
+
+.vinext-readme img {
+  max-width: 100%;
+  height: auto;
+}
+
+/* Wide tables scroll inside their own container so the page never does. */
+.vinext-table-scroll {
+  overflow-x: auto;
+  margin: 0 0 1.25rem;
+  border: 1px solid var(--color-kumo-hairline);
+  border-radius: 0.5rem;
+}
+
+.vinext-table-scroll table {
+  border-collapse: collapse;
+  width: 100%;
+  font-size: 0.875rem;
+}
+
+.vinext-table-scroll th {
+  text-align: left;
+  font-weight: 600;
+  color: var(--text-color-kumo-default);
+  background: var(--color-kumo-elevated);
+  padding: 0.625rem 0.875rem;
+  border-bottom: 1px solid var(--color-kumo-hairline);
+  white-space: nowrap;
+}
+
+.vinext-table-scroll td {
+  padding: 0.625rem 0.875rem;
+  border-bottom: 1px solid var(--color-kumo-hairline);
+  vertical-align: top;
+}
+
+.vinext-table-scroll tr:last-child td {
+  border-bottom: 0;
+}
diff --git a/apps/web/app/layout.tsx b/apps/web/app/layout.tsx
index 28eeeebb4b..e8371048a2 100644
--- a/apps/web/app/layout.tsx
+++ b/apps/web/app/layout.tsx
@@ -3,6 +3,8 @@ import { Geist, Geist_Mono } from "next/font/google";
 import "./globals.css";
 import { SiteHeader } from "./_components/site-header";
 import { SiteFooter } from "./_components/site-footer";
+import { StructuredData } from "./_components/structured-data";
+import { SITE_DESCRIPTION, siteGraph } from "./_lib/structured-data";
 
 const geistSans = Geist({
   variable: "--font-geist-sans",
@@ -16,19 +18,36 @@ const geistMono = Geist_Mono({
 
 export const metadata: Metadata = {
   metadataBase: new URL("https://vinext.dev"),
-  title: "vinext — The Next.js API surface, reimplemented on Vite",
-  description:
-    "Take any Next.js app and deploy it anywhere with one command. App Router, Pages Router, RSC, ISR — all on Vite.",
+  // `template` brands every child route, so a new page cannot silently inherit
+  // the home page title. Pages pass a bare title; use `title.absolute` to opt out.
+  title: {
+    default: "vinext — The Next.js API surface, reimplemented on Vite",
+    template: "%s — vinext",
+  },
+  description: SITE_DESCRIPTION,
   applicationName: "vinext",
   creator: "Cloudflare",
   publisher: "Cloudflare",
+  // Without an explicit googleBot block, snippets and image previews sit at
+  // Google's conservative defaults.
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: {
+      index: true,
+      follow: true,
+      "max-snippet": -1,
+      "max-image-preview": "large",
+      "max-video-preview": -1,
+    },
+  },
   openGraph: {
     type: "website",
     locale: "en_US",
     siteName: "vinext",
   },
   twitter: {
-    card: "summary",
+    card: "summary_large_image",
   },
 };
 
@@ -40,6 +59,7 @@ export default function RootLayout({
   return (
     <html lang="en" className={`${geistSans.variable} ${geistMono.variable} h-full antialiased`}>
       <body className="min-h-full flex flex-col bg-kumo-canvas text-kumo-default">
+        <StructuredData graph={siteGraph} />
         <SiteHeader />
         <main className="flex flex-1 flex-col">{children}</main>
         <SiteFooter />
diff --git a/apps/web/app/not-found.tsx b/apps/web/app/not-found.tsx
new file mode 100644
index 0000000000..2612c8f814
--- /dev/null
+++ b/apps/web/app/not-found.tsx
@@ -0,0 +1,70 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { LinkButton } from "@cloudflare/kumo/components/button";
+import { Text } from "@cloudflare/kumo/components/text";
+
+/**
+ * Without this route vinext falls back to a built-in 404 document that emits a
+ * second <title> and brands every missing URL as the home page. `title.absolute`
+ * opts out of the root layout's `%s — vinext` template.
+ *
+ * `robots` must be restated here. Metadata keys are replaced rather than merged
+ * down the tree, so without it this page inherits the root layout's
+ * `index, follow` and contradicts the `noindex` vinext emits for 404s.
+ */
+export const metadata: Metadata = {
+  title: { absolute: "Page not found — vinext" },
+  robots: { index: false, follow: true },
+};
+
+const LINKS = [
+  { href: "/", label: "Home", detail: "What vinext is and how to start." },
+  { href: "/readme", label: "Documentation", detail: "The full project README." },
+  {
+    href: "/compatibility",
+    label: "Compatibility",
+    detail: "Next.js deploy-suite results, run against vinext.",
+  },
+  {
+    href: "/benchmarks",
+    label: "Benchmarks",
+    detail: "Build time, dev startup, and bundle size over time.",
+  },
+] as const;
+
+export default function NotFound() {
+  return (
+    <section className="mx-auto flex w-full max-w-3xl flex-col px-6 pb-24 pt-24">
+      <Text variant="secondary" size="sm">
+        404
+      </Text>
+      <h1 className="mt-3 text-4xl font-semibold tracking-tight text-kumo-default sm:text-5xl">
+        That page does not exist
+      </h1>
+      <p className="mt-4 text-kumo-subtle">
+        The URL may be out of date, or the page may have moved. Everything on vinext.dev is listed
+        below.
+      </p>
+
+      <ul className="mt-10 flex flex-col divide-y divide-kumo-hairline border-y border-kumo-hairline">
+        {LINKS.map(({ href, label, detail }) => (
+          <li key={href}>
+            <Link
+              href={href}
+              className="flex flex-col gap-1 py-4 transition-colors hover:bg-kumo-elevated"
+            >
+              <span className="font-medium text-kumo-default">{label}</span>
+              <span className="text-sm text-kumo-subtle">{detail}</span>
+            </Link>
+          </li>
+        ))}
+      </ul>
+
+      <div className="mt-10">
+        <LinkButton variant="secondary" href="https://github.com/cloudflare/vinext" external>
+          Report a broken link on GitHub
+        </LinkButton>
+      </div>
+    </section>
+  );
+}
diff --git a/apps/web/app/opengraph-image.png b/apps/web/app/opengraph-image.png
new file mode 100644
index 0000000000..7ddb0919c0
Binary files /dev/null and b/apps/web/app/opengraph-image.png differ
diff --git a/apps/web/app/page.tsx b/apps/web/app/page.tsx
index 2da6c1cd41..c778cf9db2 100644
--- a/apps/web/app/page.tsx
+++ b/apps/web/app/page.tsx
@@ -21,6 +21,7 @@ import typescript from "shiki/langs/typescript.mjs";
 import githubDarkDefault from "shiki/themes/github-dark-default.mjs";
 import { createHighlighterCore } from "shiki/core";
 import { createJavaScriptRegexEngine } from "shiki/engine/javascript";
+import Link from "next/link";
 import type { Metadata } from "next";
 
 const title = "vinext — The Next.js API surface, reimplemented on Vite";
@@ -44,60 +45,35 @@ export const metadata: Metadata = {
     description,
   },
 };
-
-const structuredData = {
-  "@context": "https://schema.org",
-  "@graph": [
-    {
-      "@type": "WebSite",
-      name: "vinext",
-      description,
-      url: "https://vinext.dev",
-      publisher: {
-        "@type": "Organization",
-        name: "Cloudflare",
-        url: "https://www.cloudflare.com",
-      },
-    },
-    {
-      "@type": "SoftwareSourceCode",
-      name: "vinext",
-      description,
-      url: "https://vinext.dev",
-      codeRepository: "https://github.com/cloudflare/vinext",
-      programmingLanguage: "TypeScript",
-      author: {
-        "@type": "Organization",
-        name: "Cloudflare",
-        url: "https://www.cloudflare.com",
-      },
-    },
-  ],
-};
-
 // ISR: 5-minute revalidate. The home page is fully static so the cached
 // output is effectively reused indefinitely between deploys; the revalidate
 // window just bounds how long any change takes to roll out to viewers after
 // a redeploy.
 export const revalidate = 300;
 
+// Each stat links to the page that substantiates it. These are the only
+// internal links in the page body, and they carry the anchor text ("Next.js 16
+// API surface", "production builds") that /compatibility and /benchmarks rank for.
 const STATS = [
   {
     value: "Up to 2×",
     label: "faster production builds",
     detail: "Measured against Next.js 16 with Turbopack on a 33-route App Router benchmark app.",
+    href: "/benchmarks",
   },
   {
     value: "~33%",
     label: "smaller client bundles",
     detail:
       "185 KB → 125 KB gzipped on the same benchmark. Tree-shaking and a lighter client runtime do the work.",
+    href: "/benchmarks",
   },
   {
     value: "94%",
     label: "of the Next.js 16 API surface",
     detail:
       "App Router, Pages Router, RSC, server actions, ISR, middleware, route handlers. Coverage and gaps tracked openly.",
+    href: "/compatibility",
   },
 ] as const;
 
@@ -256,16 +232,12 @@ async function CodeExample({ code }: { code: string }) {
 export default function Home() {
   return (
     <>
-      <script
-        type="application/ld+json"
-        dangerouslySetInnerHTML={{ __html: JSON.stringify(structuredData) }}
-      />
       <section className="mx-auto flex w-full max-w-6xl flex-col items-center px-6 pb-20 pt-24 text-center">
         <Badge variant="outline" className="mb-6">
           The Next.js API surface, re-implemented on Vite
         </Badge>
         <h1 className="max-w-3xl text-5xl font-semibold leading-[1.05] tracking-tight text-kumo-default sm:text-6xl">
-          Run your Next.js app on Vite. Deploy anywhere.
+          vinext runs your Next.js app on Vite. Deploy anywhere.
         </h1>
         <p className="mt-6 max-w-2xl text-lg leading-relaxed text-kumo-subtle">
           Vinext is an open-source Vite plugin from Cloudflare that re-implements the Next.js API
@@ -299,12 +271,16 @@ export default function Home() {
 
       <section className="mx-auto w-full max-w-6xl px-6 pb-24">
         <Grid variant="1-3up" gap="base">
-          {STATS.map(({ value, label, detail }) => (
-            <div key={label} className={CARD}>
+          {STATS.map(({ value, label, detail, href }) => (
+            <Link
+              key={label}
+              href={href}
+              className={`${CARD} transition-colors hover:bg-kumo-elevated`}
+            >
               <div className="text-5xl font-semibold tracking-tight text-kumo-default">{value}</div>
               <div className="text-base font-medium text-kumo-default">{label}</div>
               <p className="text-sm leading-relaxed text-kumo-subtle">{detail}</p>
-            </div>
+            </Link>
           ))}
         </Grid>
         <p className="mt-4 text-center text-sm text-kumo-subtle">
@@ -402,7 +378,7 @@ export default function Home() {
               key={name}
               href={href}
               target="_blank"
-              rel="noopener noreferrer"
+              rel="noopener noreferrer nofollow"
               className={`${CARD} group transition-colors hover:bg-kumo-elevated`}
             >
               <div className="flex items-center justify-between">
diff --git a/apps/web/app/readme/page.tsx b/apps/web/app/readme/page.tsx
new file mode 100644
index 0000000000..0f148bb3ad
--- /dev/null
+++ b/apps/web/app/readme/page.tsx
@@ -0,0 +1,109 @@
+import type { Metadata } from "next";
+import readme from "virtual:vinext-readme";
+import { LinkButton } from "@cloudflare/kumo/components/button";
+import { Text } from "@cloudflare/kumo/components/text";
+import { GithubLogoIcon } from "@phosphor-icons/react/dist/ssr";
+import { StructuredData } from "@/app/_components/structured-data";
+import { breadcrumbGraph } from "@/app/_lib/structured-data";
+
+// Bare title: the root layout's `%s — vinext` template supplies the suffix.
+const title = "Documentation";
+const brandedTitle = `${title} — vinext`;
+const description =
+  "The full vinext documentation: quick start, CLI reference, Next.js API coverage, deployment targets, caching, and known gaps.";
+
+export const metadata: Metadata = {
+  title,
+  description,
+  alternates: {
+    canonical: "/readme",
+  },
+  openGraph: {
+    type: "article",
+    locale: "en_US",
+    siteName: "vinext",
+    title: brandedTitle,
+    description,
+    url: "/readme",
+  },
+  twitter: {
+    title: brandedTitle,
+    description,
+  },
+};
+
+/**
+ * The README rendered on the canonical domain.
+ *
+ * Note that github.com hosts the same prose and carries more authority, so
+ * search engines are likely to treat this copy as the derivative one for as
+ * long as both are full length. No `rel=canonical` to github.com is set: that
+ * would explicitly concede the ranking. The intended end state is the inverse
+ * of today — the README shrinks to an overview that links here for detail.
+ */
+export const revalidate = 300;
+
+/** Only h2/h3 make the contents list; deeper levels make it unreadable. */
+const TOC_MAX_DEPTH = 3;
+
+export default function ReadmePage() {
+  const toc = readme.headings.filter(
+    (heading) => heading.depth > 1 && heading.depth <= TOC_MAX_DEPTH,
+  );
+
+  return (
+    <>
+      <StructuredData graph={breadcrumbGraph(title, "/readme")} />
+
+      <section className="mx-auto w-full max-w-6xl px-6 pt-16 pb-8">
+        <h1 className="text-4xl font-semibold tracking-tight text-kumo-default sm:text-5xl">
+          vinext documentation
+        </h1>
+        <p className="mt-4 max-w-2xl text-kumo-subtle">{description}</p>
+        <div className="mt-6 flex flex-col gap-3 sm:flex-row">
+          <LinkButton
+            variant="secondary"
+            size="sm"
+            icon={<GithubLogoIcon />}
+            href={readme.sourceUrl}
+            external
+          >
+            Edit this page on GitHub
+          </LinkButton>
+        </div>
+      </section>
+
+      <div className="mx-auto grid w-full max-w-6xl gap-12 px-6 pb-24 lg:grid-cols-[minmax(0,1fr)_16rem]">
+        <article
+          className="vinext-readme min-w-0"
+          // Built at build time by apps/web/vite-plugins/readme-html.ts from the
+          // repo README. The input is first-party and the renderer escapes all
+          // text, so the only HTML that survives is what that renderer emits.
+          dangerouslySetInnerHTML={{ __html: readme.html }}
+        />
+
+        <nav aria-label="On this page" className="hidden lg:block">
+          <div className="sticky top-8 flex flex-col gap-2">
+            <Text variant="secondary" size="sm">
+              On this page
+            </Text>
+            <ul className="flex flex-col gap-1.5 border-l border-kumo-hairline">
+              {toc.map(({ slug, text, depth }) => (
+                <li key={slug}>
+                  <a
+                    href={`#${slug}`}
+                    className={`block border-l border-transparent pl-3 text-sm text-kumo-subtle transition-colors hover:border-kumo-hairline hover:text-kumo-default ${
+                      depth === 3 ? "pl-6" : ""
+                    }`}
+                  >
+                    {text}
+                  </a>
+                </li>
+              ))}
+            </ul>
+          </div>
+        </nav>
+      </div>
+    </>
+  );
+}
diff --git a/apps/web/app/sitemap.ts b/apps/web/app/sitemap.ts
index 2bc0294f17..9a6c53090c 100644
--- a/apps/web/app/sitemap.ts
+++ b/apps/web/app/sitemap.ts
@@ -1,21 +1,75 @@
 import type { MetadataRoute } from "next";
+import { desc, eq } from "drizzle-orm";
+import { compatRuns, performanceRuns } from "./lib/db/schema";
+
+const SITE_URL = "https://vinext.dev";
+
+/**
+ * Falls back to the build timestamp when D1 is unavailable. The sitemap is
+ * served on every crawl, so a database hiccup must not turn it into a 500 —
+ * a stale `lastmod` is far cheaper than an unreachable sitemap.
+ */
+const BUILD_TIME = new Date();
+
+/**
+ * Relative specifiers, and imported lazily, so this module can be unit-tested
+ * outside the Worker environment. The DB
+ * client imports `cloudflare:workers`, which only resolves inside the Cloudflare
+ * environment; off-Worker the import rejects and every route falls back to
+ * BUILD_TIME rather than failing to load at all.
+ */
+async function connect() {
+  const { getDb } = await import("./lib/db/client");
+  return getDb();
+}
+
+async function latestCompatRunAt(): Promise<Date> {
+  try {
+    const db = await connect();
+    const [row] = await db
+      .select({ createdAt: compatRuns.createdAt })
+      .from(compatRuns)
+      .where(eq(compatRuns.kind, "deploy"))
+      .orderBy(desc(compatRuns.createdAt))
+      .limit(1);
+    return row ? new Date(row.createdAt) : BUILD_TIME;
+  } catch {
+    return BUILD_TIME;
+  }
+}
+
+async function latestPerformanceRunAt(): Promise<Date> {
+  try {
+    const db = await connect();
+    const [row] = await db
+      .select({ measuredAt: performanceRuns.measuredAt })
+      .from(performanceRuns)
+      .where(eq(performanceRuns.kind, "main"))
+      .orderBy(desc(performanceRuns.measuredAt))
+      .limit(1);
+    const measured = row ? new Date(row.measuredAt) : BUILD_TIME;
+    return Number.isNaN(measured.getTime()) ? BUILD_TIME : measured;
+  } catch {
+    return BUILD_TIME;
+  }
+}
+
+/**
+ * `changeFrequency` and `priority` are both ignored by Google, so only
+ * `lastModified` is emitted. The two dashboard pages report the timestamp of the
+ * data they render rather than the deploy time, so a crawl scheduled off this
+ * file tracks the data rather than the release cadence.
+ */
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const [compatAt, performanceAt] = await Promise.all([
+    latestCompatRunAt(),
+    latestPerformanceRunAt(),
+  ]);
 
-export default function sitemap(): MetadataRoute.Sitemap {
   return [
-    {
-      url: "https://vinext.dev",
-      changeFrequency: "weekly",
-      priority: 1,
-    },
-    {
-      url: "https://vinext.dev/compatibility",
-      changeFrequency: "daily",
-      priority: 0.8,
-    },
-    {
-      url: "https://vinext.dev/benchmarks",
-      changeFrequency: "daily",
-      priority: 0.8,
-    },
+    { url: SITE_URL, lastModified: BUILD_TIME },
+    { url: `${SITE_URL}/readme`, lastModified: BUILD_TIME },
+    { url: `${SITE_URL}/compatibility`, lastModified: compatAt },
+    { url: `${SITE_URL}/benchmarks`, lastModified: performanceAt },
   ];
 }
diff --git a/apps/web/vite-plugins/markdown.ts b/apps/web/vite-plugins/markdown.ts
new file mode 100644
index 0000000000..d172d80d49
--- /dev/null
+++ b/apps/web/vite-plugins/markdown.ts
@@ -0,0 +1,322 @@
+/**
+ * A small GitHub-Flavored Markdown renderer, scoped to what the vinext README
+ * actually uses.
+ *
+ * This exists instead of the usual unified/remark/rehype stack because those
+ * packages are not declared dependencies of `apps/web`, and adding them would
+ * require unfreezing the lockfile. It runs at build time only — see
+ * ./readme-html.ts — so none of it is shipped to the Worker.
+ *
+ * Supported: ATX headings (with slug ids), fenced code, GFM tables, ordered and
+ * unordered lists with nesting, blockquotes, thematic breaks, paragraphs,
+ * `<details>`/`<summary>` passthrough, and inline code/strong/emphasis/links.
+ * Anything outside that set is emitted as escaped text rather than guessed at.
+ */
+
+export type Heading = { depth: number; text: string; slug: string };
+
+export type RenderOptions = {
+  /** Build-time syntax highlighter. Returns full `<pre>` markup, or null to fall back. */
+  highlight?: (code: string, lang: string | null) => string | null;
+  /** Rewrites every link href. Used to absolutise the README's repo-relative links. */
+  rewriteLink?: (href: string) => string;
+  /**
+   * Shifts every heading down by this many levels, so an embedded document can
+   * sit under the host page's own <h1> without introducing a second one.
+   */
+  headingOffset?: number;
+};
+
+export type RenderResult = { html: string; headings: Heading[] };
+
+const RAW_PASSTHROUGH = /^<\/?(?:details|summary)(?:\s[^>]*)?>/;
+const FENCE = /^(?:```|~~~)\s*([A-Za-z0-9_+-]*)\s*$/;
+const HEADING = /^(#{1,6})\s+(.*?)\s*#*\s*$/;
+const THEMATIC_BREAK = /^(?:-{3,}|\*{3,}|_{3,})$/;
+const UNORDERED_ITEM = /^(\s*)[-*+]\s+(.*)$/;
+const ORDERED_ITEM = /^(\s*)(\d+)[.)]\s+(.*)$/;
+const TABLE_DELIMITER = /^\|?\s*:?-+:?\s*(\|\s*:?-+:?\s*)*\|?$/;
+
+/** Placeholder for extracted code spans. NUL cannot occur in the markdown source. */
+const CODE_MARKER = "\u0000";
+
+function escapeHtml(value: string): string {
+  return value
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+/** GitHub's heading slug rules, so in-README anchor links keep working. */
+function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^\p{L}\p{N}\s-]/gu, "")
+    .trim()
+    .replace(/\s+/g, "-");
+}
+
+function uniqueSlug(base: string, seen: Map<string, number>): string {
+  const count = seen.get(base) ?? 0;
+  seen.set(base, count + 1);
+  return count === 0 ? base : `${base}-${count}`;
+}
+
+/**
+ * Inline pass. Code spans are extracted first and re-inserted last, so their
+ * contents are never treated as markup.
+ */
+function renderInline(src: string, options: RenderOptions): string {
+  const codeSpans: string[] = [];
+  let text = src.replace(/(`+)([\s\S]*?)\1/g, (_match, _ticks: string, code: string) => {
+    const position = codeSpans.push(`<code>${escapeHtml(code.trim())}</code>`) - 1;
+    return `${CODE_MARKER}${position}${CODE_MARKER}`;
+  });
+
+  text = escapeHtml(text);
+
+  // Images before links: the two syntaxes differ only by the leading "!".
+  text = text.replace(
+    /!\[([^\]]*)\]\(([^)\s]+)(?:\s+&quot;[^&]*&quot;)?\)/g,
+    (_m, alt: string, src2: string) => {
+      const href = options.rewriteLink ? options.rewriteLink(src2) : src2;
+      return `<img src="${href}" alt="${alt}" loading="lazy" />`;
+    },
+  );
+
+  text = text.replace(
+    /\[([^\]]+)\]\(([^)\s]+)(?:\s+&quot;[^&]*&quot;)?\)/g,
+    (_m, label: string, url: string) => {
+      const href = options.rewriteLink ? options.rewriteLink(url) : url;
+
+      let external = false;
+      if (/^https?:\/\//i.test(href)) {
+        try {
+          const parsed = new URL(href);
+          external = !(parsed.protocol === "https:" && parsed.hostname === "vinext.dev");
+        } catch {
+          external = true;
+        }
+      }
+
+      const attrs = external ? ' target="_blank" rel="noopener noreferrer"' : "";
+      return `<a href="${href}"${attrs}>${label}</a>`;
+    },
+  );
+
+  text = text.replace(
+    /&lt;(https?:\/\/[^&\s]+)&gt;/g,
+    (_m, url: string) => `<a href="${url}" target="_blank" rel="noopener noreferrer">${url}</a>`,
+  );
+
+  text = text.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+  text = text.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, "$1<em>$2</em>");
+  text = text.replace(/~~([^~]+)~~/g, "<del>$1</del>");
+
+  return text.replace(
+    new RegExp(`${CODE_MARKER}(\\d+)${CODE_MARKER}`, "g"),
+    (_m, position: string) => codeSpans[Number(position)],
+  );
+}
+
+function splitTableRow(line: string): string[] {
+  return line
+    .replace(/^\s*\|/, "")
+    .replace(/\|\s*$/, "")
+    .split("|")
+    .map((cell) => cell.trim());
+}
+
+function alignmentsOf(delimiter: string): (string | null)[] {
+  return splitTableRow(delimiter).map((cell) => {
+    const left = cell.startsWith(":");
+    const right = cell.endsWith(":");
+    if (left && right) return "center";
+    if (right) return "right";
+    if (left) return "left";
+    return null;
+  });
+}
+
+export function renderMarkdown(source: string, options: RenderOptions = {}): RenderResult {
+  const lines = source.replace(/\r\n/g, "\n").split("\n");
+  const headings: Heading[] = [];
+  const slugs = new Map<string, number>();
+  const out: string[] = [];
+  let index = 0;
+
+  const inline = (value: string) => renderInline(value, options);
+
+  /** Renders a run of lines that belong to one container, so nesting works. */
+  const renderNested = (block: string[]): string => {
+    if (block.length === 0) return "";
+    const nested = renderMarkdown(block.join("\n"), options);
+    headings.push(...nested.headings);
+    return nested.html;
+  };
+
+  while (index < lines.length) {
+    const line = lines[index];
+
+    if (line.trim() === "") {
+      index += 1;
+      continue;
+    }
+
+    // Fenced code
+    const fence = FENCE.exec(line);
+    if (fence) {
+      const lang = fence[1] || null;
+      const body: string[] = [];
+      index += 1;
+      while (index < lines.length && !FENCE.test(lines[index])) {
+        body.push(lines[index]);
+        index += 1;
+      }
+      index += 1; // closing fence
+      const code = body.join("\n");
+      const highlighted = options.highlight?.(code, lang) ?? null;
+      out.push(
+        highlighted ??
+          `<pre><code${lang ? ` class="language-${lang}"` : ""}>${escapeHtml(code)}</code></pre>`,
+      );
+      continue;
+    }
+
+    // Raw <details>/<summary> passthrough. Content between the tags is parsed as
+    // ordinary markdown, matching GitHub's behaviour.
+    if (RAW_PASSTHROUGH.test(line.trim())) {
+      const trimmed = line.trim();
+      const summary = /^<summary(?:\s[^>]*)?>([\s\S]*?)<\/summary>$/.exec(trimmed);
+      out.push(summary ? `<summary>${inline(summary[1])}</summary>` : trimmed);
+      index += 1;
+      continue;
+    }
+
+    // Heading
+    const heading = HEADING.exec(line);
+    if (heading) {
+      const depth = Math.min(6, heading[1].length + (options.headingOffset ?? 0));
+      const text = heading[2];
+      const slug = uniqueSlug(slugify(text), slugs);
+      headings.push({ depth, text, slug });
+      out.push(`<h${depth} id="${slug}">${inline(text)}</h${depth}>`);
+      index += 1;
+      continue;
+    }
+
+    if (THEMATIC_BREAK.test(line.trim())) {
+      out.push("<hr />");
+      index += 1;
+      continue;
+    }
+
+    // Blockquote
+    if (line.startsWith(">")) {
+      const body: string[] = [];
+      while (index < lines.length && lines[index].startsWith(">")) {
+        body.push(lines[index].replace(/^>\s?/, ""));
+        index += 1;
+      }
+      out.push(`<blockquote>${renderNested(body)}</blockquote>`);
+      continue;
+    }
+
+    // GFM table: a header row followed by a delimiter row
+    if (line.includes("|") && index + 1 < lines.length && TABLE_DELIMITER.test(lines[index + 1])) {
+      const header = splitTableRow(line);
+      const aligns = alignmentsOf(lines[index + 1]);
+      index += 2;
+      const rows: string[][] = [];
+      while (index < lines.length && lines[index].includes("|") && lines[index].trim() !== "") {
+        rows.push(splitTableRow(lines[index]));
+        index += 1;
+      }
+      const align = (position: number) =>
+        aligns[position] ? ` style="text-align:${aligns[position]}"` : "";
+      const head = header
+        .map((cell, position) => `<th${align(position)}>${inline(cell)}</th>`)
+        .join("");
+      const body = rows
+        .map(
+          (row) =>
+            `<tr>${row
+              .map((cell, position) => `<td${align(position)}>${inline(cell)}</td>`)
+              .join("")}</tr>`,
+        )
+        .join("");
+      out.push(
+        `<div class="vinext-table-scroll"><table><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table></div>`,
+      );
+      continue;
+    }
+
+    // Lists
+    const unordered = UNORDERED_ITEM.exec(line);
+    const ordered = ORDERED_ITEM.exec(line);
+    if (unordered || ordered) {
+      const isOrdered = ordered !== null;
+      const baseIndent = (isOrdered ? ordered[1] : unordered![1]).length;
+      const items: string[] = [];
+
+      while (index < lines.length) {
+        const current = lines[index];
+        const itemMatch = isOrdered ? ORDERED_ITEM.exec(current) : UNORDERED_ITEM.exec(current);
+        if (itemMatch === null || itemMatch[1].length !== baseIndent) break;
+
+        const first = isOrdered ? itemMatch[3] : itemMatch[2];
+        const continuation: string[] = [];
+        index += 1;
+
+        // Absorb continuation lines and any deeper-indented nested blocks.
+        while (index < lines.length) {
+          const next = lines[index];
+          if (next.trim() === "") {
+            const after = lines[index + 1] ?? "";
+            const deeper = after.trim() !== "" && after.search(/\S/) > baseIndent;
+            if (!deeper) break;
+            continuation.push("");
+            index += 1;
+            continue;
+          }
+          if (next.search(/\S/) <= baseIndent) break;
+          continuation.push(next.slice(baseIndent + 2));
+          index += 1;
+        }
+
+        const nested = continuation.some((entry) => entry.trim() !== "")
+          ? renderNested(continuation)
+          : "";
+        items.push(`<li>${inline(first)}${nested}</li>`);
+      }
+
+      const tag = isOrdered ? "ol" : "ul";
+      out.push(`<${tag}>${items.join("")}</${tag}>`);
+      continue;
+    }
+
+    // Paragraph: consume until a blank line or the start of another block.
+    const paragraph: string[] = [];
+    while (index < lines.length) {
+      const current = lines[index];
+      if (
+        current.trim() === "" ||
+        FENCE.test(current) ||
+        HEADING.test(current) ||
+        THEMATIC_BREAK.test(current.trim()) ||
+        RAW_PASSTHROUGH.test(current.trim()) ||
+        current.startsWith(">") ||
+        UNORDERED_ITEM.test(current) ||
+        ORDERED_ITEM.test(current)
+      ) {
+        break;
+      }
+      paragraph.push(current.trim());
+      index += 1;
+    }
+    if (paragraph.length > 0) out.push(`<p>${inline(paragraph.join(" "))}</p>`);
+  }
+
+  return { html: out.join("\n"), headings };
+}
diff --git a/apps/web/vite-plugins/readme-html.ts b/apps/web/vite-plugins/readme-html.ts
new file mode 100644
index 0000000000..49c02297ba
--- /dev/null
+++ b/apps/web/vite-plugins/readme-html.ts
@@ -0,0 +1,112 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import type { Plugin } from "vite";
+import { renderMarkdown, type Heading } from "./markdown";
+
+/**
+ * Renders the repo README to HTML at build time and exposes it as a virtual
+ * module, so /readme ships as plain markup with no markdown parser in the
+ * Worker bundle.
+ *
+ * Build time rather than request time is deliberate: the README only changes
+ * between deploys, and a runtime pipeline would cost roughly 120 KB of gzipped
+ * Worker bundle plus shiki grammar compilation on every cold render.
+ */
+
+const VIRTUAL_ID = "virtual:vinext-readme";
+const RESOLVED_ID = `\0${VIRTUAL_ID}`;
+
+const REPO_URL = "https://github.com/cloudflare/vinext";
+const README_PATH = path.resolve(fileURLToPath(import.meta.url), "../../../../README.md");
+
+/** shiki language ids, keyed by the fence labels the README actually uses. */
+const LANGUAGE_ALIASES: Record<string, string> = {
+  bash: "bash",
+  sh: "bash",
+  shell: "bash",
+  shellscript: "bash",
+  zsh: "bash",
+  json: "json",
+  jsonc: "jsonc",
+  ts: "typescript",
+  mts: "typescript",
+  cts: "typescript",
+  typescript: "typescript",
+  tsx: "tsx",
+};
+
+/**
+ * The README lives at the repo root, so its relative links point at paths that
+ * do not exist under vinext.dev. Anchors stay on-page because the renderer
+ * emits GitHub-compatible heading ids; everything else resolves to GitHub.
+ */
+function rewriteLink(href: string): string {
+  if (href.startsWith("#") || /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//")) {
+    return href;
+  }
+  const clean = href.replace(/^\.\//, "");
+  const kind = /\.[a-z]+$/i.test(clean) ? "blob" : "tree";
+  return `${REPO_URL}/${kind}/main/${clean}`;
+}
+
+async function createHighlight(): Promise<(code: string, lang: string | null) => string | null> {
+  const [{ createHighlighterCore }, { createJavaScriptRegexEngine }, ...langs] = await Promise.all([
+    import("shiki/core"),
+    import("shiki/engine/javascript"),
+    import("shiki/langs/typescript.mjs"),
+    import("shiki/langs/tsx.mjs"),
+    import("shiki/langs/bash.mjs"),
+    import("shiki/langs/json.mjs"),
+    import("shiki/langs/jsonc.mjs"),
+  ]);
+  const theme = await import("shiki/themes/github-dark-default.mjs");
+
+  const highlighter = await createHighlighterCore({
+    langs,
+    themes: [theme],
+    engine: createJavaScriptRegexEngine(),
+  });
+
+  return (code, lang) => {
+    const resolved = lang ? LANGUAGE_ALIASES[lang.toLowerCase()] : undefined;
+    if (!resolved) return null;
+    return highlighter.codeToHtml(code, { lang: resolved, theme: "github-dark-default" });
+  };
+}
+
+type ReadmeModule = { html: string; headings: Heading[]; sourceUrl: string };
+
+export function readmeHtmlPlugin(): Plugin {
+  let highlight: Awaited<ReturnType<typeof createHighlight>> | undefined;
+
+  return {
+    name: "vinext-web:readme-html",
+    resolveId(id) {
+      return id === VIRTUAL_ID ? RESOLVED_ID : null;
+    },
+    async load(id) {
+      if (id !== RESOLVED_ID) return null;
+
+      // `this.addWatchFile` keeps dev in sync when the README is edited.
+      this.addWatchFile(README_PATH);
+
+      highlight ??= await createHighlight();
+      const source = await readFile(README_PATH, "utf8");
+      // Offset by one: the page supplies its own <h1>, so the README's h1
+      // becomes an h2 and the document keeps a single top-level heading.
+      const { html, headings } = renderMarkdown(source, {
+        highlight,
+        rewriteLink,
+        headingOffset: 1,
+      });
+
+      const module: ReadmeModule = {
+        html,
+        headings,
+        sourceUrl: `${REPO_URL}/blob/main/README.md`,
+      };
+      return `export default ${JSON.stringify(module)};`;
+    },
+  };
+}
diff --git a/apps/web/vite-plugins/virtual.d.ts b/apps/web/vite-plugins/virtual.d.ts
new file mode 100644
index 0000000000..ce304d7b6a
--- /dev/null
+++ b/apps/web/vite-plugins/virtual.d.ts
@@ -0,0 +1,9 @@
+declare module "virtual:vinext-readme" {
+  /** Built by ./readme-html.ts at build time from the repo-root README.md. */
+  const readme: {
+    html: string;
+    headings: { depth: number; text: string; slug: string }[];
+    sourceUrl: string;
+  };
+  export default readme;
+}
diff --git a/apps/web/vite.config.ts b/apps/web/vite.config.ts
index a28e1538c9..659de41643 100644
--- a/apps/web/vite.config.ts
+++ b/apps/web/vite.config.ts
@@ -4,9 +4,11 @@ import { cdnAdapter } from "@vinext/cloudflare/cache/cdn-adapter";
 import { kvDataAdapter } from "@vinext/cloudflare/cache/kv-data-adapter";
 import { imagesOptimizer } from "@vinext/cloudflare/images/images-optimizer";
 import { cloudflare } from "@cloudflare/vite-plugin";
+import { readmeHtmlPlugin } from "./vite-plugins/readme-html";
 
 export default defineConfig({
   plugins: [
+    readmeHtmlPlugin(),
     vinext({
       cache: {
         cdn: cdnAdapter(),
diff --git a/apps/web/worker/index.ts b/apps/web/worker/index.ts
index 834046a57a..07a81c4ddc 100644
--- a/apps/web/worker/index.ts
+++ b/apps/web/worker/index.ts
@@ -1,6 +1,6 @@
 /** Cloudflare Worker entry point for web-specific APIs and scheduled maintenance. */
 import handler from "vinext/server/fetch-handler";
-import { addPreviewRobotsHeader, getCanonicalRedirect } from "./seo";
+import { addNonCanonicalRobotsHeader, getCanonicalRedirect } from "./seo";
 
 type Env = {
   ASSETS: Fetcher;
@@ -166,7 +166,7 @@ export default {
     // ctx.waitUntil() is available to background cache writes and
     // other deferred work via getRequestExecutionContext().
     const response = await handler.fetch(request, env, ctx);
-    return addPreviewRobotsHeader(request, response);
+    return addNonCanonicalRobotsHeader(request, response);
   },
   async scheduled(_controller: ScheduledController, env: Env, ctx: ExecutionContext) {
     ctx.waitUntil(sweepPerformanceProfiles(env));
diff --git a/apps/web/worker/seo.ts b/apps/web/worker/seo.ts
index a9e3ab33f7..cf900f157b 100644
--- a/apps/web/worker/seo.ts
+++ b/apps/web/worker/seo.ts
@@ -1,7 +1,7 @@
 const CANONICAL_HOSTNAME = "vinext.dev";
 const WWW_HOSTNAME = "www.vinext.dev";
 const PRODUCTION_WORKERS_HOSTNAME = "vinext-web.vinext.workers.dev";
-const PREVIEW_HOST_SUFFIX = `-${PRODUCTION_WORKERS_HOSTNAME}`;
+const WORKERS_HOST_SUFFIX = ".vinext.workers.dev";
 
 function isPublicDocumentRequest(request: Request, url: URL): boolean {
   return (
@@ -31,10 +31,18 @@ export function getCanonicalRedirect(request: Request): Response | null {
   });
 }
 
-/** Prevent public preview aliases from competing with the production domain. */
-export function addPreviewRobotsHeader(request: Request, response: Response): Response {
+/**
+ * Keep every non-canonical host this Worker answers on out of the index.
+ *
+ * Covers preview aliases and the production workers.dev origin alike. Public
+ * documents on the workers.dev origin already 308 to vinext.dev, but the /api/
+ * carve-out above does not, so without this header those JSON endpoints stay
+ * indexable on a host that competes with the canonical domain for the brand
+ * term. Only vinext.dev itself is left untouched.
+ */
+export function addNonCanonicalRobotsHeader(request: Request, response: Response): Response {
   const { hostname } = new URL(request.url);
-  if (!hostname.endsWith(PREVIEW_HOST_SUFFIX)) return response;
+  if (!hostname.endsWith(WORKERS_HOST_SUFFIX)) return response;
 
   const headers = new Headers(response.headers);
   headers.set("x-robots-tag", "noindex");
diff --git a/examples/app-router-cloudflare/app/layout.tsx b/examples/app-router-cloudflare/app/layout.tsx
index ff26c6fd07..37435a8387 100644
--- a/examples/app-router-cloudflare/app/layout.tsx
+++ b/examples/app-router-cloudflare/app/layout.tsx
@@ -4,6 +4,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
       <head>
         <meta charSet="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <meta name="robots" content="noindex, nofollow" />
         <title>vinext on Cloudflare Workers</title>
       </head>
       <body>{children}</body>
diff --git a/examples/app-router-playground/app/layout.tsx b/examples/app-router-playground/app/layout.tsx
index c1da3e0e6e..f2f52db886 100644
--- a/examples/app-router-playground/app/layout.tsx
+++ b/examples/app-router-playground/app/layout.tsx
@@ -25,6 +25,9 @@ export const metadata: Metadata = {
     images: [`/api/og?title=Next.js Playground`],
   },
   twitter: { card: 'summary_large_image' },
+  // Demo deploy on a *.vinext.workers.dev host: keep it out of the index so it
+  // does not compete with vinext.dev for the project's own brand term.
+  robots: { index: false, follow: false },
 };
 
 export default function RootLayout({
diff --git a/examples/benchmarks/app/layout.tsx b/examples/benchmarks/app/layout.tsx
index b241748c25..43d5fb43b0 100644
--- a/examples/benchmarks/app/layout.tsx
+++ b/examples/benchmarks/app/layout.tsx
@@ -6,7 +6,8 @@ export default function RootLayout({ children }: { children: React.ReactNode })
       <head>
         <meta charSet="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>vinext Benchmarks</title>
+        <meta name="robots" content="noindex, nofollow" />
+        <title>Benchmarks example app</title>
         <meta
           name="description"
           content="Performance benchmarks for vinext vs Next.js, tracked over time."
diff --git a/examples/hackernews/app/layout.tsx b/examples/hackernews/app/layout.tsx
index 7b83db031b..a928b04c74 100644
--- a/examples/hackernews/app/layout.tsx
+++ b/examples/hackernews/app/layout.tsx
@@ -6,9 +6,11 @@ import Footer from 'components/footer'
 export const metadata = {
   title: 'Hacker News — vinext + Cloudflare Workers',
   description: 'Hacker News clone built with React Server Components, running on vinext + Cloudflare Workers.',
+  // Demo deploy on a *.vinext.workers.dev host: keep it out of the index so it
+  // does not compete with vinext.dev for the project's own brand term.
   robots: {
-    index: true,
-    follow: true
+    index: false,
+    follow: false
   }
 }
 
diff --git a/examples/nextra-docs-template/app/layout.tsx b/examples/nextra-docs-template/app/layout.tsx
index 29bf3eaa68..6c4536c644 100644
--- a/examples/nextra-docs-template/app/layout.tsx
+++ b/examples/nextra-docs-template/app/layout.tsx
@@ -78,6 +78,7 @@ export default function RootLayout({
       <head>
         <meta charSet="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <meta name="robots" content="noindex, nofollow" />
         <title>Nextra Docs Template</title>
       </head>
       <body>
diff --git a/examples/pages-router-cloudflare/public/robots.txt b/examples/pages-router-cloudflare/public/robots.txt
new file mode 100644
index 0000000000..8617eb4f97
--- /dev/null
+++ b/examples/pages-router-cloudflare/public/robots.txt
@@ -0,0 +1,6 @@
+# Demo deploy on a *.vinext.workers.dev host. Kept out of search so it does not
+# compete with vinext.dev for the project's own brand term. These are Pages
+# Router examples with no _document, so a static robots.txt is used instead of a
+# meta robots tag to avoid changing the rendered HTML these examples demonstrate.
+User-agent: *
+Disallow: /
diff --git a/examples/realworld-api-rest/public/robots.txt b/examples/realworld-api-rest/public/robots.txt
new file mode 100644
index 0000000000..8617eb4f97
--- /dev/null
+++ b/examples/realworld-api-rest/public/robots.txt
@@ -0,0 +1,6 @@
+# Demo deploy on a *.vinext.workers.dev host. Kept out of search so it does not
+# compete with vinext.dev for the project's own brand term. These are Pages
+# Router examples with no _document, so a static robots.txt is used instead of a
+# meta robots tag to avoid changing the rendered HTML these examples demonstrate.
+User-agent: *
+Disallow: /
diff --git a/examples/workers-cache/app/layout.tsx b/examples/workers-cache/app/layout.tsx
index 35158cc56a..7d27b9d98d 100644
--- a/examples/workers-cache/app/layout.tsx
+++ b/examples/workers-cache/app/layout.tsx
@@ -6,6 +6,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
       <head>
         <meta charSet="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <meta name="robots" content="noindex, nofollow" />
         <title>Workers Cache demo — vinext</title>
       </head>
       <body>{children}</body>
diff --git a/tests/web-seo.test.ts b/tests/web-seo.test.ts
index 881c0a396c..60d971353d 100644
--- a/tests/web-seo.test.ts
+++ b/tests/web-seo.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 import { createBenchmarkMetadata } from "../apps/web/app/benchmarks/metadata";
 import robots from "../apps/web/app/robots";
 import sitemap from "../apps/web/app/sitemap";
-import { addPreviewRobotsHeader, getCanonicalRedirect } from "../apps/web/worker/seo";
+import { addNonCanonicalRobotsHeader, getCanonicalRedirect } from "../apps/web/worker/seo";
 
 describe("vinext.dev SEO metadata", () => {
   it("builds canonical and social metadata for benchmark detail pages", () => {
@@ -14,6 +14,9 @@ describe("vinext.dev SEO metadata", () => {
 
     const canonical = metadata.alternates?.canonical;
     expect(canonical).toBe("/benchmarks/commit/abc1234");
+    // The document title stays bare so the root layout's `%s — vinext` template
+    // applies it once; openGraph is not templated, so it carries the brand.
+    expect(metadata.title).toBe("Commit abc1234 performance benchmarks");
     expect(metadata.openGraph).toMatchObject({
       title: "Commit abc1234 performance benchmarks — vinext",
       url: "/benchmarks/commit/abc1234",
@@ -32,13 +35,28 @@ describe("vinext.dev SEO metadata", () => {
     });
   });
 
-  it("lists only stable, indexable pages in the sitemap", () => {
-    expect(sitemap().map(({ url }) => url)).toEqual([
+  it("lists only stable, indexable pages in the sitemap", async () => {
+    expect((await sitemap()).map(({ url }) => url)).toEqual([
       "https://vinext.dev",
+      "https://vinext.dev/readme",
       "https://vinext.dev/compatibility",
       "https://vinext.dev/benchmarks",
     ]);
   });
+
+  it("stamps every sitemap entry with a lastmod date", async () => {
+    for (const entry of await sitemap()) {
+      expect(entry.lastModified).toBeInstanceOf(Date);
+      expect(Number.isNaN((entry.lastModified as Date).getTime())).toBe(false);
+    }
+  });
+
+  it("omits changefreq and priority, which Google ignores", async () => {
+    for (const entry of await sitemap()) {
+      expect(entry.changeFrequency).toBeUndefined();
+      expect(entry.priority).toBeUndefined();
+    }
+  });
 });
 
 describe("vinext.dev canonical host handling", () => {
@@ -68,7 +86,7 @@ describe("vinext.dev canonical host handling", () => {
   });
 
   it("marks preview aliases as non-indexable without buffering the response body", async () => {
-    const response = addPreviewRobotsHeader(
+    const response = addNonCanonicalRobotsHeader(
       new Request("https://pr-123-vinext-web.vinext.workers.dev/"),
       new Response("preview", { headers: { "content-type": "text/plain" } }),
     );
@@ -78,10 +96,22 @@ describe("vinext.dev canonical host handling", () => {
     await expect(response.text()).resolves.toBe("preview");
   });
 
-  it("does not add preview directives to canonical production hosts", () => {
-    for (const hostname of ["vinext.dev", "vinext-web.vinext.workers.dev"]) {
-      const original = new Response("production");
-      expect(addPreviewRobotsHeader(new Request(`https://${hostname}/`), original)).toBe(original);
-    }
+  it("marks the production workers.dev origin non-indexable too", () => {
+    // Public documents there already 308 to vinext.dev, but the /api/ carve-out
+    // does not, so without this the JSON endpoints stay indexable on a host that
+    // competes with the canonical domain for the brand term.
+    const response = addNonCanonicalRobotsHeader(
+      new Request("https://vinext-web.vinext.workers.dev/api/compatibility"),
+      Response.json({ ok: true }),
+    );
+
+    expect(response.headers.get("x-robots-tag")).toBe("noindex");
+  });
+
+  it("does not add robots directives to the canonical host", () => {
+    const original = new Response("production");
+    expect(addNonCanonicalRobotsHeader(new Request("https://vinext.dev/"), original)).toBe(
+      original,
+    );
   });
 });