From 8c4e3d2c4eddb83a614accb4b8ff08a826de3efd Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Wed, 21 Oct 2026 10:38:02 -0700
Subject: [PATCH 1/5] improvement(docs): reduce build work and instrument
 performance

---
 .github/workflows/docs-negotiation.yml        |  17 ++
 apps/docs/app/layout.tsx                      |   2 +
 apps/docs/components/performance-insights.tsx |  21 ++
 apps/docs/next.config.ts                      |   1 -
 apps/docs/package.json                        |  10 +-
 apps/docs/scripts/generate-llms-full.ts       |  60 ++++-
 apps/docs/scripts/measure-performance.ts      | 211 ++++++++++++++++++
 apps/docs/scripts/test-llms-full-e2e.ts       |  79 +++++++
 bun.lock                                      |   6 +
 9 files changed, 392 insertions(+), 15 deletions(-)
 create mode 100644 apps/docs/components/performance-insights.tsx
 create mode 100644 apps/docs/scripts/measure-performance.ts
 create mode 100644 apps/docs/scripts/test-llms-full-e2e.ts

diff --git a/.github/workflows/docs-negotiation.yml b/.github/workflows/docs-negotiation.yml
index 87f82e99180..77373ce925e 100644
--- a/.github/workflows/docs-negotiation.yml
+++ b/.github/workflows/docs-negotiation.yml
@@ -17,6 +17,11 @@ on:
       - 'bun.lock'
       - '.github/workflows/docs-negotiation.yml'
   workflow_dispatch:
+    inputs:
+      benchmark_live:
+        description: Also measure the public docs as a comparison
+        type: boolean
+        default: false
 
 permissions:
   contents: read
@@ -35,6 +40,8 @@ jobs:
       DOCS_E2E_BASE_URL: http://127.0.0.1:3001
       DOCS_NEGOTIATION_REPORT_PATH: ${{ github.workspace }}/test-results/docs-negotiation.json
       DOCS_HEADER_REPORT_PATH: ${{ github.workspace }}/test-results/docs-headers.json
+      DOCS_LLMS_REPORT_PATH: ${{ github.workspace }}/test-results/docs-llms.json
+      DOCS_PERFORMANCE_REPORT_PATH: ${{ github.workspace }}/test-results/performance/docs.json
     steps:
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v6
@@ -46,6 +53,14 @@ jobs:
         run: bun run --cwd apps/docs build
       - name: Verify native header edge cases
         run: bun run --cwd apps/docs test:headers:e2e
+      - name: Install browser for performance measurements
+        run: bunx --no-install playwright install --with-deps chromium
+      - name: Measure public docs baseline
+        if: inputs.benchmark_live == true
+        env:
+          DOCS_PERFORMANCE_BASE_URL: https://docs.sim.ai
+          DOCS_PERFORMANCE_REPORT_PATH: ${{ github.workspace }}/test-results/baseline/docs.json
+        run: bun run --cwd apps/docs measure:performance
       - name: Verify HTTP content negotiation
         run: |
           mkdir -p test-results
@@ -53,6 +68,8 @@ jobs:
           DOCS_SERVER_PID=$!
           trap 'kill "$DOCS_SERVER_PID" 2>/dev/null || true' EXIT
           bun run --cwd apps/docs test:negotiation:e2e
+          bun run --cwd apps/docs test:llms:e2e
+          bun run --cwd apps/docs measure:performance
       - name: Upload HTTP regression report
         if: always()
         uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
diff --git a/apps/docs/app/layout.tsx b/apps/docs/app/layout.tsx
index 3fbe2958a6e..2babab05d9c 100644
--- a/apps/docs/app/layout.tsx
+++ b/apps/docs/app/layout.tsx
@@ -9,6 +9,7 @@ import { ThemeProvider } from 'next-themes'
 import { DocsSidebar } from '@/components/docs-layout/docs-sidebar'
 import { Footer } from '@/components/footer/footer'
 import { Navbar } from '@/components/navbar/navbar'
+import { PerformanceInsights } from '@/components/performance-insights'
 import { SimWordmark } from '@/components/ui/sim-logo'
 import { serializeJsonLd } from '@/lib/json-ld'
 import { source } from '@/lib/source'
@@ -138,6 +139,7 @@ export default function RootLayout({ children }: { children: ReactNode }) {
               {children}
             </DocsLayout>
             <Footer />
+            {process.env.VERCEL_ENV === 'production' && <PerformanceInsights />}
           </RootProvider>
         </ThemeProvider>
       </body>
diff --git a/apps/docs/components/performance-insights.tsx b/apps/docs/components/performance-insights.tsx
new file mode 100644
index 00000000000..6bf978c8bab
--- /dev/null
+++ b/apps/docs/components/performance-insights.tsx
@@ -0,0 +1,21 @@
+'use client'
+
+import type { ComponentProps } from 'react'
+import { SpeedInsights } from '@vercel/speed-insights/next'
+
+const redactUrl: ComponentProps<typeof SpeedInsights>['beforeSend'] = (event) => {
+  try {
+    const url = new URL(event.url)
+    if (url.hostname !== 'docs.sim.ai') return null
+    url.search = ''
+    url.hash = ''
+    return { ...event, url: url.toString() }
+  } catch {
+    return null
+  }
+}
+
+/** Sample public production pages without collecting search terms or API playground parameters. */
+export function PerformanceInsights() {
+  return <SpeedInsights sampleRate={0.05} beforeSend={redactUrl} debug={false} />
+}
diff --git a/apps/docs/next.config.ts b/apps/docs/next.config.ts
index fd57395c691..8c62df1caee 100644
--- a/apps/docs/next.config.ts
+++ b/apps/docs/next.config.ts
@@ -6,7 +6,6 @@ const withMDX = createMDX()
 
 const config: NextConfig = {
   reactStrictMode: true,
-  productionBrowserSourceMaps: true,
   transpilePackages: ['@sim/emcn', '@sim/workflow-renderer'],
   images: {
     unoptimized: true,
diff --git a/apps/docs/package.json b/apps/docs/package.json
index 32dc1dee5fc..f3358e91b29 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -13,12 +13,14 @@
     "test": "vitest run",
     "test:negotiation:e2e": "bun scripts/test-negotiation-e2e.ts",
     "test:headers:e2e": "bun scripts/test-header-merge-e2e.ts",
+    "test:llms:e2e": "bun scripts/test-llms-full-e2e.ts",
+    "measure:performance": "bun scripts/measure-performance.ts",
     "type-check": "fumadocs-mdx && tsc --noEmit",
     "lint": "biome check --write --unsafe .",
     "lint:check": "biome check .",
     "format": "biome format --write .",
     "format:check": "biome format .",
-    "llms-full:generate": "fumadocs-mdx && bun scripts/generate-llms-full.ts"
+    "llms-full:generate": "bun scripts/generate-llms-full.ts"
   },
   "dependencies": {
     "@sim/db": "workspace:*",
@@ -27,6 +29,7 @@
     "@sim/logger": "workspace:*",
     "@sim/utils": "workspace:*",
     "@sim/workflow-renderer": "workspace:*",
+    "@vercel/speed-insights": "2.0.0",
     "@xyflow/react": "12.12.0",
     "class-variance-authority": "^0.7.1",
     "drizzle-orm": "^0.45.4",
@@ -46,6 +49,8 @@
     "zod": "4.3.6"
   },
   "devDependencies": {
+    "@mdx-js/mdx": "3.1.1",
+    "@playwright/test": "1.61.1",
     "@sim/tsconfig": "workspace:*",
     "@tailwindcss/postcss": "^4.3.3",
     "@types/node": "24.19.2",
@@ -55,6 +60,7 @@
     "postcss": "^8.5.30",
     "tailwindcss": "^4.3.3",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.4"
+    "vitest": "^5.0.4",
+    "vfile": "6.0.3"
   }
 }
diff --git a/apps/docs/scripts/generate-llms-full.ts b/apps/docs/scripts/generate-llms-full.ts
index b6bfa4d88a6..a320dda6344 100644
--- a/apps/docs/scripts/generate-llms-full.ts
+++ b/apps/docs/scripts/generate-llms-full.ts
@@ -1,20 +1,42 @@
 import { createWriteStream } from 'node:fs'
-import { mkdtemp, rename, rm } from 'node:fs/promises'
+import { mkdtemp, readdir, readFile, rename, rm } from 'node:fs/promises'
 import path from 'node:path'
 import { Readable } from 'node:stream'
 import { pipeline } from 'node:stream/promises'
+import { createProcessor } from '@mdx-js/mdx'
 import { createLogger } from '@sim/logger'
 import { compareStrings } from '@sim/utils/string'
-import { plugin } from 'bun'
-import { createMdxPlugin } from 'fumadocs-mdx/bun'
+import { frontmatter } from 'fumadocs-core/content/md/frontmatter'
+import { remarkLLMs } from 'fumadocs-core/mdx-plugins/remark-llms'
+import { loader, type VirtualFile } from 'fumadocs-core/source'
+import { applyMdxPreset, frontmatterSchema, remarkInclude } from 'fumadocs-mdx/config'
+import { VFile } from 'vfile'
+import config, { docs } from '@/source.config'
 
 const MAX_LLM_TEXT_BYTES = 64 * 1024 * 1024
-const logger = createLogger('DocsLlmsFullAsset')
+const logger = createLogger('DocsLlmsFullAsset', { logLevel: 'INFO' })
 
-await plugin(createMdxPlugin({ disableMetaFile: true }))
-
-const { source } = await import('@/lib/source')
-const { getLLMText, isApiOperationPage } = await import('@/lib/llms')
+const started = performance.now()
+const options = await applyMdxPreset(
+  typeof config.mdxOptions === 'function' ? await config.mdxOptions() : config.mdxOptions
+)('bundler')
+// Keep MDX's built-in remark transforms without loading Shiki or the rendered component graph.
+const mdxProcessor = createProcessor({
+  format: 'mdx',
+  remarkPlugins: [remarkInclude, ...(options.remarkPlugins ?? []), [remarkLLMs, { _data: true }]],
+})
+const markdownProcessor = createProcessor({
+  format: 'md',
+  remarkPlugins: [remarkInclude, ...(options.remarkPlugins ?? []), [remarkLLMs, { _data: true }]],
+})
+const files = await readdir(docs.dir, { recursive: true })
+const pages: VirtualFile[] = []
+for (const file of files) {
+  if (!/\.mdx?$/.test(file)) continue
+  const { data } = frontmatter(await readFile(path.join(docs.dir, file), 'utf8'))
+  pages.push({ type: 'page', path: file, data: frontmatterSchema.parse(data) })
+}
+const source = loader({ files: pages }, { baseUrl: '/' })
 const publicDirectory = path.resolve('public')
 const temporaryDirectory = await mkdtemp(path.join(publicDirectory, '.llms-full-'))
 const temporaryFile = path.join(temporaryDirectory, 'llms-full.txt')
@@ -24,9 +46,19 @@ async function* generateText(): AsyncGenerator<string> {
   let bytes = 0
   const pages = [...source.getPages()].sort((left, right) => compareStrings(left.url, right.url))
   for (const page of pages) {
-    if (!page?.data || !page.url || isApiOperationPage(page)) continue
-    const text = await getLLMText(page)
-    if (!text) continue
+    const filePath = path.resolve(docs.dir, page.path)
+    const parsed = frontmatter(await readFile(filePath, 'utf8'))
+    const file = new VFile({
+      path: filePath,
+      value: parsed.content,
+      data: { frontmatter: parsed.data },
+    })
+    const processor = filePath.endsWith('.mdx') ? mdxProcessor : markdownProcessor
+    await processor.run(processor.parse(file), file)
+    if (typeof file.data.markdown !== 'string') {
+      throw new Error(`No processed Markdown was generated for ${page.path}`)
+    }
+    const text = `# ${page.data.title} (${page.url})\n\n${file.data.markdown}`
     const chunk = `${hasContent ? '\n\n---\n\n' : ''}${text}`
     bytes += Buffer.byteLength(chunk)
     if (bytes > MAX_LLM_TEXT_BYTES) {
@@ -41,7 +73,11 @@ async function* generateText(): AsyncGenerator<string> {
 try {
   await pipeline(Readable.from(generateText()), createWriteStream(temporaryFile))
   await rename(temporaryFile, path.join(publicDirectory, 'llms-full.txt'))
-  logger.info('Generated full documentation static asset')
+  logger.info('Generated full documentation static asset', {
+    pages: source.getPages().length,
+    durationMs: Math.round(performance.now() - started),
+    peakMemoryMiB: Math.round(process.resourceUsage().maxRSS / 1024),
+  })
 } finally {
   await rm(temporaryDirectory, { recursive: true, force: true })
 }
diff --git a/apps/docs/scripts/measure-performance.ts b/apps/docs/scripts/measure-performance.ts
new file mode 100644
index 00000000000..15dc8cbfc23
--- /dev/null
+++ b/apps/docs/scripts/measure-performance.ts
@@ -0,0 +1,211 @@
+import { mkdir, writeFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { type Browser, chromium, expect } from '@playwright/test'
+import { createLogger } from '@sim/logger'
+import { getErrorMessage } from '@sim/utils/errors'
+
+const logger = createLogger('DocsPerformance', { logLevel: 'INFO' })
+const origin = process.env.DOCS_PERFORMANCE_BASE_URL ?? process.env.DOCS_E2E_BASE_URL
+const reportPath = process.env.DOCS_PERFORMANCE_REPORT_PATH
+if (!origin || !reportPath) {
+  throw new Error('A docs base URL and DOCS_PERFORMANCE_REPORT_PATH are required')
+}
+const target = new URL(origin)
+if (
+  target.protocol !== 'https:' &&
+  !['localhost', '127.0.0.1', '[::1]'].includes(target.hostname)
+) {
+  throw new Error('Remote measurements require HTTPS')
+}
+
+interface BrowserMetrics {
+  lcpMs: number | null
+  layoutShiftSum: number
+  longTasks: number
+  blockingMs: number
+  tabPaintMs: number[]
+}
+
+declare global {
+  interface Window {
+    docsPerformance: BrowserMetrics
+  }
+}
+
+const pages = [
+  '/introduction',
+  '/getting-started',
+  '/files',
+  '/integrations/apollo',
+  '/api-reference/workflows/listWorkflows',
+] as const
+const viewports = [
+  { name: 'desktop', width: 1440, height: 1000 },
+  { name: 'mobile', width: 390, height: 844 },
+] as const
+const results: Record<string, unknown>[] = []
+let failed = false
+await mkdir(dirname(reportPath), { recursive: true })
+let browser: Browser | undefined
+try {
+  browser = await chromium.launch()
+  for (const viewport of viewports) {
+    for (const path of pages) {
+      const started = performance.now()
+      const context = await browser.newContext({ viewport, reducedMotion: 'reduce' })
+      const page = await context.newPage()
+      const errors: string[] = []
+      page.on('pageerror', (error) => errors.push(error.message))
+      await page.addInitScript(() => {
+        const metrics: BrowserMetrics = {
+          lcpMs: null,
+          layoutShiftSum: 0,
+          longTasks: 0,
+          blockingMs: 0,
+          tabPaintMs: [],
+        }
+        window.docsPerformance = metrics
+        for (const type of ['largest-contentful-paint', 'layout-shift', 'longtask']) {
+          if (!PerformanceObserver.supportedEntryTypes.includes(type)) continue
+          new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+              if (entry.entryType === 'largest-contentful-paint') metrics.lcpMs = entry.startTime
+              if (entry.entryType === 'layout-shift' && 'value' in entry) {
+                if ('hadRecentInput' in entry && entry.hadRecentInput) continue
+                metrics.layoutShiftSum += Number(entry.value)
+              }
+              if (entry.entryType === 'longtask') {
+                metrics.longTasks += 1
+                metrics.blockingMs += Math.max(0, entry.duration - 50)
+              }
+            }
+          }).observe({ type, buffered: true })
+        }
+        document.addEventListener(
+          'pointerdown',
+          (event) => {
+            if (!(event.target instanceof Element)) return
+            const tab = event.target.closest('[role="tab"]')
+            if (!tab || !tab.closest('[aria-label="Request language"]')) return
+            const started = performance.now()
+            const measurePaint = () => {
+              const panelId = tab.getAttribute('aria-controls')
+              const panel = panelId ? document.getElementById(panelId) : null
+              if (
+                tab.getAttribute('aria-selected') === 'true' &&
+                panel &&
+                panel.getBoundingClientRect().height > 0 &&
+                panel.querySelector('code')?.textContent?.trim()
+              ) {
+                requestAnimationFrame(() => {
+                  if (metrics.tabPaintMs.length < 20)
+                    metrics.tabPaintMs.push(performance.now() - started)
+                })
+              } else if (performance.now() - started < 10000) {
+                requestAnimationFrame(measurePaint)
+              }
+            }
+            requestAnimationFrame(measurePaint)
+          },
+          true
+        )
+      })
+      try {
+        const response = await page.goto(new URL(path, origin).toString(), {
+          waitUntil: 'networkidle',
+        })
+        if (!response?.ok()) throw new Error(`Page returned ${response?.status() ?? 'no response'}`)
+        await page.getByRole('heading', { level: 1 }).waitFor()
+        await page.evaluate(async () => {
+          await document.fonts.ready
+        })
+        const initial = await page.evaluate(() => {
+          const navigation = performance.getEntriesByType('navigation')[0] as
+            | PerformanceNavigationTiming
+            | undefined
+          const resources = performance.getEntriesByType('resource') as PerformanceResourceTiming[]
+          return {
+            ...window.docsPerformance,
+            fcpMs: performance.getEntriesByName('first-contentful-paint')[0]?.startTime ?? null,
+            ttfbMs: navigation?.responseStart ?? null,
+            loadMs: navigation?.loadEventEnd ?? null,
+            htmlBytes: navigation?.decodedBodySize ?? null,
+            scriptBytes: resources
+              .filter((entry) => entry.initiatorType === 'script')
+              .reduce((total, entry) => total + entry.encodedBodySize, 0),
+            requests: resources.length,
+            domElements: document.querySelectorAll('*').length,
+          }
+        })
+        if (path.startsWith('/api-reference/')) {
+          const tabs = page.getByRole('tablist', { name: 'Request language' }).getByRole('tab')
+          const count = await tabs.count()
+          if (count < 2) throw new Error('API request-language controls are missing')
+          for (let index = 0; index < count; index += 1) {
+            const tab = tabs.nth(index)
+            await tab.click()
+            await expect(tab).toHaveAttribute('aria-selected', 'true')
+            await page.waitForFunction(() => {
+              const selected = document.querySelector(
+                '[aria-label="Request language"] [aria-selected="true"]'
+              )
+              const panelId = selected?.getAttribute('aria-controls')
+              const panel = panelId ? document.getElementById(panelId) : null
+              return Boolean(
+                panel &&
+                  panel.getBoundingClientRect().height > 0 &&
+                  panel.querySelector('code')?.textContent?.trim()
+              )
+            })
+            await page.evaluate(
+              () =>
+                new Promise<void>((resolve) =>
+                  requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
+                )
+            )
+          }
+          const recorded = await page.evaluate(() => window.docsPerformance.tabPaintMs.length)
+          if (recorded !== count)
+            throw new Error(`Expected ${count} tab measurements; recorded ${recorded}`)
+        }
+        const tabPaintMs = await page.evaluate(() => window.docsPerformance.tabPaintMs)
+        await page.screenshot({
+          path: join(dirname(reportPath), `${viewport.name}${path.replaceAll('/', '-')}.png`),
+        })
+        results.push({
+          path,
+          viewport: viewport.name,
+          status: errors.length ? 'failed' : 'passed',
+          durationMs: Math.round(performance.now() - started),
+          ...initial,
+          tabPaintMs,
+          errors,
+        })
+        if (errors.length) failed = true
+      } catch (error) {
+        failed = true
+        results.push({
+          path,
+          viewport: viewport.name,
+          status: 'failed',
+          durationMs: Math.round(performance.now() - started),
+          error: getErrorMessage(error),
+          errors,
+        })
+      } finally {
+        await context.close()
+      }
+    }
+  }
+} catch (error) {
+  failed = true
+  results.push({ path: 'browser', status: 'failed', error: getErrorMessage(error) })
+} finally {
+  await browser?.close()
+  await writeFile(
+    reportPath,
+    `${JSON.stringify({ measuredAt: new Date().toISOString(), origin: target.origin, results }, null, 2)}\n`
+  )
+}
+logger.info('Recorded documentation performance', { pages: results.length, reportPath })
+if (failed) process.exitCode = 1
diff --git a/apps/docs/scripts/test-llms-full-e2e.ts b/apps/docs/scripts/test-llms-full-e2e.ts
new file mode 100644
index 00000000000..6512c11183a
--- /dev/null
+++ b/apps/docs/scripts/test-llms-full-e2e.ts
@@ -0,0 +1,79 @@
+import { mkdir, readdir, writeFile } from 'node:fs/promises'
+import { dirname } from 'node:path'
+import { createLogger } from '@sim/logger'
+import { getErrorMessage } from '@sim/utils/errors'
+
+const logger = createLogger('DocsLlmsFullE2E')
+const origin = process.env.DOCS_E2E_BASE_URL
+const reportPath = process.env.DOCS_LLMS_REPORT_PATH
+if (!origin || !reportPath) {
+  throw new Error('DOCS_E2E_BASE_URL and DOCS_LLMS_REPORT_PATH are required')
+}
+if (!['localhost', '127.0.0.1', '[::1]'].includes(new URL(origin).hostname)) {
+  throw new Error('The documentation server must use a loopback origin')
+}
+
+interface CheckResult {
+  path: string
+  status: 'passed' | 'failed'
+  durationMs: number
+  error?: string
+}
+
+const checks: CheckResult[] = []
+try {
+  const response = await fetch(new URL('/llms-full.txt', origin), {
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!response.ok) throw new Error(`Full documentation returned ${response.status}`)
+  const text = await response.text()
+  const starts = [...text.matchAll(/^# .+ \((\/[^\n]*)\)\n\n/gm)]
+  const files = await readdir('content/docs', { recursive: true })
+  const pageCount = files.filter((file) => /\.mdx?$/.test(file)).length
+  if (starts.length !== pageCount) {
+    throw new Error(`Expected ${pageCount} authored pages; found ${starts.length}`)
+  }
+  const seen = new Set<string>()
+  for (let index = 0; index < starts.length; index += 1) {
+    const match = starts[index]
+    if (!match) continue
+    const pagePath = match[1]
+    if (!pagePath || seen.has(pagePath)) throw new Error(`Duplicate or missing path: ${pagePath}`)
+    seen.add(pagePath)
+    const started = performance.now()
+    const check: CheckResult = { path: pagePath, status: 'failed', durationMs: 0 }
+    try {
+      const pageResponse = await fetch(new URL(`/llms.mdx${pagePath}`, origin), {
+        signal: AbortSignal.timeout(10000),
+      })
+      if (!pageResponse.ok) throw new Error(`Markdown page returned ${pageResponse.status}`)
+      const actual = await pageResponse.text()
+      const end = starts[index + 1]?.index
+      const expected = text.slice(match.index, end).replace(/\n\n---\n\n$/, '')
+      if (actual !== expected)
+        throw new Error('Bundled text differs from the rendered Markdown page')
+      check.status = 'passed'
+    } catch (error) {
+      check.error = getErrorMessage(error)
+    }
+    check.durationMs = Math.round(performance.now() - started)
+    checks.push(check)
+  }
+} catch (error) {
+  checks.push({
+    path: '/llms-full.txt',
+    status: 'failed',
+    durationMs: 0,
+    error: getErrorMessage(error),
+  })
+}
+
+await mkdir(dirname(reportPath), { recursive: true })
+await writeFile(reportPath, `${JSON.stringify({ checks }, null, 2)}\n`)
+const failures = checks.filter((check) => check.status === 'failed')
+if (failures.length) {
+  logger.error('Full documentation parity failed', { failures })
+  process.exitCode = 1
+} else {
+  logger.info('Full documentation matches every authored Markdown page', { pages: checks.length })
+}
diff --git a/bun.lock b/bun.lock
index 1811b6fa345..2ffa40b1b10 100644
--- a/bun.lock
+++ b/bun.lock
@@ -94,6 +94,7 @@
         "@sim/logger": "workspace:*",
         "@sim/utils": "workspace:*",
         "@sim/workflow-renderer": "workspace:*",
+        "@vercel/speed-insights": "2.0.0",
         "@xyflow/react": "12.12.0",
         "class-variance-authority": "^0.7.1",
         "drizzle-orm": "^0.45.4",
@@ -113,6 +114,8 @@
         "zod": "4.3.6",
       },
       "devDependencies": {
+        "@mdx-js/mdx": "3.1.1",
+        "@playwright/test": "1.61.1",
         "@sim/tsconfig": "workspace:*",
         "@tailwindcss/postcss": "^4.3.3",
         "@types/node": "24.19.2",
@@ -122,6 +125,7 @@
         "postcss": "^8.5.30",
         "tailwindcss": "^4.3.3",
         "typescript": "^7.0.2",
+        "vfile": "6.0.3",
         "vitest": "^5.0.4",
       },
     },
@@ -2465,6 +2469,8 @@
 
     "@vercel/oidc": ["@vercel/oidc@3.1.0", "", {}, "sha512-Fw28YZpRnA3cAHHDlkt7xQHiJ0fcL+NRcIqsocZQUSmbzeIKRpwttJjik5ZGanXP+vlA4SbTg+AbA3bP363l+w=="],
 
+    "@vercel/speed-insights": ["@vercel/speed-insights@2.0.0", "", { "peerDependencies": { "@sveltejs/kit": "^1 || ^2", "next": ">= 13", "nuxt": ">= 3", "react": "^18 || ^19 || ^19.0.0-rc", "svelte": ">= 4", "vue": "^3", "vue-router": "^4" }, "optionalPeers": ["@sveltejs/kit", "next", "nuxt", "react", "svelte", "vue", "vue-router"] }, "sha512-jwkNcrTeafWxjmWq4AHBaptSqZiJkYU5adLC9QBSqeim0GcqDMgN5Ievh8OG1rJ6W3A4l1oiP7qr9CWxGuzu3w=="],
+
     "@vitejs/plugin-react": ["@vitejs/plugin-react@6.1.2", "", { "dependencies": { "@rolldown/pluginutils": "^1.0.1" }, "peerDependencies": { "@rolldown/plugin-babel": "^0.1.7 || ^0.2.0", "babel-plugin-react-compiler": "^1.0.0", "oxc-transform-react": "^0.152.0", "vite": "^8.0.0" }, "optionalPeers": ["@rolldown/plugin-babel", "babel-plugin-react-compiler", "oxc-transform-react"] }, "sha512-fhJNGUdscQa4HkI0xFxwonWyhnVReCPDbXI7FH7jmzpnVCrFQI7PRrhWecO263610vOrs9tr2Y4xcf8uAdFxbw=="],
 
     "@vitest/coverage-v8": ["@vitest/coverage-v8@5.0.4", "", { "dependencies": { "@bcoe/v8-coverage": "^1.0.2", "@vitest/istanbul-lib-coverage": "^1.0.2", "@vitest/istanbul-lib-report": "^1.0.2", "ast-v8-to-istanbul": "^1.0.7", "magicast": "^0.5.5", "obug": "^3.0.0", "std-env": "^4.3.0", "tinyrainbow": "^3.2.0" }, "peerDependencies": { "@vitest/browser": "5.0.4", "vitest": "5.0.4" }, "optionalPeers": ["@vitest/browser"] }, "sha512-P5YcQY8Y6RmoE9xRXI38rT8pssbcubEzqtYTM2XQoxOXMDn04nRaTI1SM8qCl9/NfW3ag9GlzdSXu7IwO5Ft8A=="],

From 5d66e906af726195df40f9ef9f10c2c6c380ae08 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Wed, 21 Oct 2026 10:50:32 -0700
Subject: [PATCH 2/5] improvement(docs): defer collapsed navigation and refine
 performance checks

---
 .../docs-layout/sidebar-components.tsx        |  2 +-
 apps/docs/lib/llms.ts                         |  8 ----
 apps/docs/scripts/generate-llms-full.ts       | 39 ++++++++++++++++--
 apps/docs/scripts/measure-performance.ts      | 40 ++++++++++++++++++-
 4 files changed, 75 insertions(+), 14 deletions(-)

diff --git a/apps/docs/components/docs-layout/sidebar-components.tsx b/apps/docs/components/docs-layout/sidebar-components.tsx
index 4ea13bc7417..a632e2cd87c 100644
--- a/apps/docs/components/docs-layout/sidebar-components.tsx
+++ b/apps/docs/components/docs-layout/sidebar-components.tsx
@@ -112,7 +112,7 @@ export function SidebarFolder({ item, children }: SidebarFolderProps) {
       )}
       {hasChildren && (
         <div id={contentId} hidden={!open}>
-          <div className='mt-px ml-4 flex flex-col gap-px'>{children}</div>
+          {open && <div className='mt-px ml-4 flex flex-col gap-px'>{children}</div>}
         </div>
       )}
     </div>
diff --git a/apps/docs/lib/llms.ts b/apps/docs/lib/llms.ts
index c52c1be065e..86cc0e41c3c 100644
--- a/apps/docs/lib/llms.ts
+++ b/apps/docs/lib/llms.ts
@@ -5,14 +5,6 @@ import type { PageData, source } from '@/lib/source'
 
 type LLMPageData = PageData & { getAPIPageProps?: () => ApiPageProps }
 
-/**
- * OpenAPI operation pages are virtual: no MDX body, and a fully resolved request/response schema
- * (~40 KB each, mostly shared components) that is useful per page but would double `llms-full.txt`.
- */
-export function isApiOperationPage(page: InferPageType<typeof source>): boolean {
-  return typeof (page.data as unknown as LLMPageData).getAPIPageProps === 'function'
-}
-
 export async function getLLMText(page: InferPageType<typeof source>) {
   const data = page.data as unknown as LLMPageData
   const heading = `# ${data.title} (${page.url})`
diff --git a/apps/docs/scripts/generate-llms-full.ts b/apps/docs/scripts/generate-llms-full.ts
index a320dda6344..1e1cd1e09bb 100644
--- a/apps/docs/scripts/generate-llms-full.ts
+++ b/apps/docs/scripts/generate-llms-full.ts
@@ -17,17 +17,35 @@ const MAX_LLM_TEXT_BYTES = 64 * 1024 * 1024
 const logger = createLogger('DocsLlmsFullAsset', { logLevel: 'INFO' })
 
 const started = performance.now()
+const slowestPages: { path: string; parseMs: number; durationMs: number }[] = []
+let parseMs = 0
+let transformMs = 0
+function measureParsing() {
+  return (_tree: unknown, file: VFile) => {
+    file.data.parsedAt = performance.now()
+  }
+}
 const options = await applyMdxPreset(
   typeof config.mdxOptions === 'function' ? await config.mdxOptions() : config.mdxOptions
 )('bundler')
 // Keep MDX's built-in remark transforms without loading Shiki or the rendered component graph.
 const mdxProcessor = createProcessor({
   format: 'mdx',
-  remarkPlugins: [remarkInclude, ...(options.remarkPlugins ?? []), [remarkLLMs, { _data: true }]],
+  remarkPlugins: [
+    measureParsing,
+    remarkInclude,
+    ...(options.remarkPlugins ?? []),
+    [remarkLLMs, { _data: true }],
+  ],
 })
 const markdownProcessor = createProcessor({
   format: 'md',
-  remarkPlugins: [remarkInclude, ...(options.remarkPlugins ?? []), [remarkLLMs, { _data: true }]],
+  remarkPlugins: [
+    measureParsing,
+    remarkInclude,
+    ...(options.remarkPlugins ?? []),
+    [remarkLLMs, { _data: true }],
+  ],
 })
 const files = await readdir(docs.dir, { recursive: true })
 const pages: VirtualFile[] = []
@@ -54,7 +72,19 @@ async function* generateText(): AsyncGenerator<string> {
       data: { frontmatter: parsed.data },
     })
     const processor = filePath.endsWith('.mdx') ? mdxProcessor : markdownProcessor
-    await processor.run(processor.parse(file), file)
+    const pageStarted = performance.now()
+    await processor.process(file)
+    const pageEnded = performance.now()
+    const parsedAt = typeof file.data.parsedAt === 'number' ? file.data.parsedAt : pageStarted
+    parseMs += parsedAt - pageStarted
+    transformMs += pageEnded - parsedAt
+    slowestPages.push({
+      path: page.path,
+      parseMs: Math.round(parsedAt - pageStarted),
+      durationMs: Math.round(pageEnded - pageStarted),
+    })
+    slowestPages.sort((left, right) => right.durationMs - left.durationMs)
+    slowestPages.length = Math.min(slowestPages.length, 5)
     if (typeof file.data.markdown !== 'string') {
       throw new Error(`No processed Markdown was generated for ${page.path}`)
     }
@@ -76,6 +106,9 @@ try {
   logger.info('Generated full documentation static asset', {
     pages: source.getPages().length,
     durationMs: Math.round(performance.now() - started),
+    parseMs: Math.round(parseMs),
+    transformMs: Math.round(transformMs),
+    slowestPages,
     peakMemoryMiB: Math.round(process.resourceUsage().maxRSS / 1024),
   })
 } finally {
diff --git a/apps/docs/scripts/measure-performance.ts b/apps/docs/scripts/measure-performance.ts
index 15dc8cbfc23..9425c9691ef 100644
--- a/apps/docs/scripts/measure-performance.ts
+++ b/apps/docs/scripts/measure-performance.ts
@@ -141,8 +141,12 @@ try {
           const tabs = page.getByRole('tablist', { name: 'Request language' }).getByRole('tab')
           const count = await tabs.count()
           if (count < 2) throw new Error('API request-language controls are missing')
-          for (let index = 0; index < count; index += 1) {
-            const tab = tabs.nth(index)
+          const selectedIndex = await tabs.evaluateAll((elements) =>
+            elements.findIndex((element) => element.getAttribute('aria-selected') === 'true')
+          )
+          if (selectedIndex < 0) throw new Error('API request language has no selected tab')
+          for (let offset = 1; offset <= count; offset += 1) {
+            const tab = tabs.nth((selectedIndex + offset) % count)
             await tab.click()
             await expect(tab).toHaveAttribute('aria-selected', 'true')
             await page.waitForFunction(() => {
@@ -172,6 +176,38 @@ try {
         await page.screenshot({
           path: join(dirname(reportPath), `${viewport.name}${path.replaceAll('/', '-')}.png`),
         })
+        if (path === '/introduction') {
+          const mobile = viewport.name === 'mobile'
+          if (mobile) await page.getByRole('button', { name: 'Open Sidebar', exact: true }).click()
+          const navigation = page.getByRole(mobile ? 'dialog' : 'complementary', {
+            name: 'Documentation navigation',
+          })
+          const platform = navigation.getByRole('button', { name: 'Platform', exact: true })
+          const costs = navigation.getByRole('link', {
+            name: 'Credits, billing and limits',
+            exact: true,
+          })
+          await platform.click()
+          await expect(costs).toBeVisible()
+          await platform.press('Enter')
+          await expect(costs).toBeHidden()
+          await platform.press('Enter')
+          await costs.click()
+          await expect(page).toHaveURL(new URL('/platform/costs', origin).toString())
+          await expect(
+            page.getByRole('heading', {
+              level: 1,
+              name: 'Credits, billing and limits',
+              exact: true,
+            })
+          ).toBeVisible()
+          if (mobile) {
+            await expect(navigation).not.toBeVisible()
+            await page.getByRole('button', { name: 'Open Sidebar', exact: true }).click()
+          }
+          await expect(costs).toHaveAttribute('aria-current', 'page')
+          await expect(platform).toHaveAttribute('aria-expanded', 'true')
+        }
         results.push({
           path,
           viewport: viewport.name,

From 81cd1cca29e62322887358f0c02f17babae86026 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Wed, 21 Oct 2026 11:08:31 -0700
Subject: [PATCH 3/5] improvement(docs): streamline navigation without visitor
 telemetry

---
 .github/workflows/docs-negotiation.yml        |  19 +--
 apps/docs/README.md                           |   2 +
 apps/docs/app/[[...slug]]/page.tsx            |  22 +--
 apps/docs/app/layout.tsx                      |   2 -
 apps/docs/components/page-actions.tsx         |  58 +++++--
 apps/docs/components/performance-insights.tsx |  21 ---
 apps/docs/lib/llms.ts                         |   8 +
 apps/docs/lib/source.ts                       |   1 +
 apps/docs/package.json                        |  10 +-
 apps/docs/scripts/generate-llms-full.ts       |  93 ++---------
 apps/docs/scripts/test-llms-full-e2e.ts       |  79 ---------
 ...-performance.ts => test-navigation-e2e.ts} | 157 ++++++------------
 apps/docs/source.config.ts                    |   1 +
 bun.lock                                      |   5 -
 14 files changed, 138 insertions(+), 340 deletions(-)
 delete mode 100644 apps/docs/components/performance-insights.tsx
 delete mode 100644 apps/docs/scripts/test-llms-full-e2e.ts
 rename apps/docs/scripts/{measure-performance.ts => test-navigation-e2e.ts} (53%)

diff --git a/.github/workflows/docs-negotiation.yml b/.github/workflows/docs-negotiation.yml
index 77373ce925e..1db0d82bd5d 100644
--- a/.github/workflows/docs-negotiation.yml
+++ b/.github/workflows/docs-negotiation.yml
@@ -17,11 +17,6 @@ on:
       - 'bun.lock'
       - '.github/workflows/docs-negotiation.yml'
   workflow_dispatch:
-    inputs:
-      benchmark_live:
-        description: Also measure the public docs as a comparison
-        type: boolean
-        default: false
 
 permissions:
   contents: read
@@ -40,8 +35,7 @@ jobs:
       DOCS_E2E_BASE_URL: http://127.0.0.1:3001
       DOCS_NEGOTIATION_REPORT_PATH: ${{ github.workspace }}/test-results/docs-negotiation.json
       DOCS_HEADER_REPORT_PATH: ${{ github.workspace }}/test-results/docs-headers.json
-      DOCS_LLMS_REPORT_PATH: ${{ github.workspace }}/test-results/docs-llms.json
-      DOCS_PERFORMANCE_REPORT_PATH: ${{ github.workspace }}/test-results/performance/docs.json
+      DOCS_NAVIGATION_REPORT_PATH: ${{ github.workspace }}/test-results/navigation/docs.json
     steps:
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v6
@@ -53,14 +47,8 @@ jobs:
         run: bun run --cwd apps/docs build
       - name: Verify native header edge cases
         run: bun run --cwd apps/docs test:headers:e2e
-      - name: Install browser for performance measurements
+      - name: Install browser for navigation checks
         run: bunx --no-install playwright install --with-deps chromium
-      - name: Measure public docs baseline
-        if: inputs.benchmark_live == true
-        env:
-          DOCS_PERFORMANCE_BASE_URL: https://docs.sim.ai
-          DOCS_PERFORMANCE_REPORT_PATH: ${{ github.workspace }}/test-results/baseline/docs.json
-        run: bun run --cwd apps/docs measure:performance
       - name: Verify HTTP content negotiation
         run: |
           mkdir -p test-results
@@ -68,8 +56,7 @@ jobs:
           DOCS_SERVER_PID=$!
           trap 'kill "$DOCS_SERVER_PID" 2>/dev/null || true' EXIT
           bun run --cwd apps/docs test:negotiation:e2e
-          bun run --cwd apps/docs test:llms:e2e
-          bun run --cwd apps/docs measure:performance
+          bun run --cwd apps/docs test:navigation:e2e
       - name: Upload HTTP regression report
         if: always()
         uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
diff --git a/apps/docs/README.md b/apps/docs/README.md
index bc61e70317d..3b9b8434473 100644
--- a/apps/docs/README.md
+++ b/apps/docs/README.md
@@ -25,3 +25,5 @@ Use the owner and generation commands listed in the editorial guide. Do not hand
 ## Validate
 
 From the repository root, run the required lint, type, audit, and test gates in the development guidelines. From this directory, `bun run type-check` compiles MDX and checks the docs workspace, and `bun run build` validates the production site. Inspect affected page types on desktop and a narrow viewport, and check internal links and existing anchors after heading changes.
+
+The docs HTTP workflow also checks sidebar navigation, API language switching, and copying Markdown on desktop and mobile layouts. It uploads screenshots and a JSON report with the HTTP regression artifacts. These checks run against the built site in CI; no visitor telemetry is collected. Use Vercel's build logs and usage reports to compare deployment cost and duration.
diff --git a/apps/docs/app/[[...slug]]/page.tsx b/apps/docs/app/[[...slug]]/page.tsx
index 63059635612..105ed0b2146 100644
--- a/apps/docs/app/[[...slug]]/page.tsx
+++ b/apps/docs/app/[[...slug]]/page.tsx
@@ -26,7 +26,7 @@ import { CodeBlock } from '@/components/ui/code-block'
 import { Heading } from '@/components/ui/heading'
 import { IntegrationIcon } from '@/components/ui/integration-icon'
 import { ResponseSection } from '@/components/ui/response-section'
-import { getApiSpecContent, getAuthenticatedCodeSamples, openapi } from '@/lib/openapi'
+import { getAuthenticatedCodeSamples, openapi } from '@/lib/openapi'
 import { simShikiOptions } from '@/lib/shiki-theme'
 import { type PageData, source } from '@/lib/source'
 import { DOCS_BASE_URL } from '@/lib/urls'
@@ -266,11 +266,6 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
 
   if (isOpenAPI && data.getAPIPageProps) {
     const apiProps = data.getAPIPageProps()
-    const apiPageContent = getApiSpecContent(
-      data.title,
-      data.description,
-      apiProps.operations ?? []
-    )
 
     return (
       <>
@@ -306,7 +301,10 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
         >
           <PageHeader title={data.title} className='api-page-header'>
             <div className='hidden sm:flex'>
-              <LLMCopyButton content={apiPageContent} />
+              <LLMCopyButton
+                key={page.url}
+                markdownUrl={`/llms.mdx${page.url === '/' ? '' : page.url}`}
+              />
             </div>
             <PageNavigationArrows previous={neighbours?.previous} next={neighbours?.next} />
           </PageHeader>
@@ -318,8 +316,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
     )
   }
 
-  const MDX = data.body
-  const markdownContent = await data.getText('processed')
+  const { body: MDX, toc } = await data.load()
 
   return (
     <>
@@ -334,7 +331,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
         className={DOCS_PAGE_CLASS_NAME}
         role='main'
         tabIndex={-1}
-        toc={data.toc.filter(
+        toc={toc.filter(
           (item) => isContentHeading(item) && (slug?.[0] !== 'integrations' || item.depth <= 3)
         )}
         full={data.full}
@@ -359,7 +356,10 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
           className='max-sm:[&>h1]:basis-0 max-sm:[&_a]:size-10'
         >
           <div className='hidden sm:flex'>
-            <LLMCopyButton content={markdownContent} />
+            <LLMCopyButton
+              key={page.url}
+              markdownUrl={`/llms.mdx${page.url === '/' ? '' : page.url}`}
+            />
           </div>
           <PageNavigationArrows previous={neighbours?.previous} next={neighbours?.next} />
         </PageHeader>
diff --git a/apps/docs/app/layout.tsx b/apps/docs/app/layout.tsx
index 2babab05d9c..3fbe2958a6e 100644
--- a/apps/docs/app/layout.tsx
+++ b/apps/docs/app/layout.tsx
@@ -9,7 +9,6 @@ import { ThemeProvider } from 'next-themes'
 import { DocsSidebar } from '@/components/docs-layout/docs-sidebar'
 import { Footer } from '@/components/footer/footer'
 import { Navbar } from '@/components/navbar/navbar'
-import { PerformanceInsights } from '@/components/performance-insights'
 import { SimWordmark } from '@/components/ui/sim-logo'
 import { serializeJsonLd } from '@/lib/json-ld'
 import { source } from '@/lib/source'
@@ -139,7 +138,6 @@ export default function RootLayout({ children }: { children: ReactNode }) {
               {children}
             </DocsLayout>
             <Footer />
-            {process.env.VERCEL_ENV === 'production' && <PerformanceInsights />}
           </RootProvider>
         </ThemeProvider>
       </body>
diff --git a/apps/docs/components/page-actions.tsx b/apps/docs/components/page-actions.tsx
index 53c92c8d087..44c97943b39 100644
--- a/apps/docs/components/page-actions.tsx
+++ b/apps/docs/components/page-actions.tsx
@@ -1,19 +1,55 @@
 'use client'
 
-import { Chip } from '@sim/emcn'
+import { useState } from 'react'
+import { Chip, useCopyToClipboard } from '@sim/emcn'
 import { Check, Duplicate } from '@sim/emcn/icons'
-import { useCopyButton } from 'fumadocs-ui/utils/use-copy-button'
 
-export function LLMCopyButton({ content }: { content: string }) {
-  const [checked, onClick] = useCopyButton(() => navigator.clipboard.writeText(content))
+interface LLMCopyButtonProps {
+  markdownUrl: string
+}
+
+export function LLMCopyButton({ markdownUrl }: LLMCopyButtonProps) {
+  const { copied, copy } = useCopyToClipboard()
+  const [pending, setPending] = useState(false)
+  const [failed, setFailed] = useState(false)
+  const checked = copied && !pending && !failed
+
+  async function onClick() {
+    setPending(true)
+    setFailed(false)
+    const prepare = async () => {
+      const response = await fetch(markdownUrl, { signal: AbortSignal.timeout(10000) })
+      if (!response.ok) throw new Error('Could not load page Markdown')
+      return response.text()
+    }
+    try {
+      // Promise-backed writes preserve Safari's transient user activation during the fetch.
+      const success =
+        typeof ClipboardItem !== 'undefined' && typeof navigator.clipboard.write === 'function'
+          ? await copy({ prepare, fallback: '' })
+          : await copy(await prepare())
+      setFailed(!success)
+    } catch {
+      setFailed(true)
+    } finally {
+      setPending(false)
+    }
+  }
 
   return (
-    <Chip
-      onClick={onClick}
-      leftIcon={checked ? Check : Duplicate}
-      aria-label={checked ? 'Copied to clipboard' : 'Copy page content'}
-    >
-      {checked ? 'Copied' : 'Copy page'}
-    </Chip>
+    <div className='relative'>
+      <Chip
+        onClick={onClick}
+        disabled={pending}
+        aria-busy={pending}
+        leftIcon={checked ? Check : Duplicate}
+        aria-label={checked ? 'Copied to clipboard' : 'Copy page content'}
+      >
+        {checked ? 'Copied' : pending ? 'Copying…' : 'Copy page'}
+      </Chip>
+      <span role='status' className='absolute top-full right-0 whitespace-nowrap text-caption'>
+        {failed ? 'Could not copy. Try again.' : ''}
+      </span>
+    </div>
   )
 }
diff --git a/apps/docs/components/performance-insights.tsx b/apps/docs/components/performance-insights.tsx
deleted file mode 100644
index 6bf978c8bab..00000000000
--- a/apps/docs/components/performance-insights.tsx
+++ /dev/null
@@ -1,21 +0,0 @@
-'use client'
-
-import type { ComponentProps } from 'react'
-import { SpeedInsights } from '@vercel/speed-insights/next'
-
-const redactUrl: ComponentProps<typeof SpeedInsights>['beforeSend'] = (event) => {
-  try {
-    const url = new URL(event.url)
-    if (url.hostname !== 'docs.sim.ai') return null
-    url.search = ''
-    url.hash = ''
-    return { ...event, url: url.toString() }
-  } catch {
-    return null
-  }
-}
-
-/** Sample public production pages without collecting search terms or API playground parameters. */
-export function PerformanceInsights() {
-  return <SpeedInsights sampleRate={0.05} beforeSend={redactUrl} debug={false} />
-}
diff --git a/apps/docs/lib/llms.ts b/apps/docs/lib/llms.ts
index 86cc0e41c3c..c52c1be065e 100644
--- a/apps/docs/lib/llms.ts
+++ b/apps/docs/lib/llms.ts
@@ -5,6 +5,14 @@ import type { PageData, source } from '@/lib/source'
 
 type LLMPageData = PageData & { getAPIPageProps?: () => ApiPageProps }
 
+/**
+ * OpenAPI operation pages are virtual: no MDX body, and a fully resolved request/response schema
+ * (~40 KB each, mostly shared components) that is useful per page but would double `llms-full.txt`.
+ */
+export function isApiOperationPage(page: InferPageType<typeof source>): boolean {
+  return typeof (page.data as unknown as LLMPageData).getAPIPageProps === 'function'
+}
+
 export async function getLLMText(page: InferPageType<typeof source>) {
   const data = page.data as unknown as LLMPageData
   const heading = `# ${data.title} (${page.url})`
diff --git a/apps/docs/lib/source.ts b/apps/docs/lib/source.ts
index 4fee2a7debe..dd50ee0ea82 100644
--- a/apps/docs/lib/source.ts
+++ b/apps/docs/lib/source.ts
@@ -129,4 +129,5 @@ export type PageData = DocData &
     description?: string
     full?: boolean
     integration?: { type: string; color: string }
+    load: () => Promise<DocData>
   }
diff --git a/apps/docs/package.json b/apps/docs/package.json
index f3358e91b29..1191be6c832 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -13,14 +13,13 @@
     "test": "vitest run",
     "test:negotiation:e2e": "bun scripts/test-negotiation-e2e.ts",
     "test:headers:e2e": "bun scripts/test-header-merge-e2e.ts",
-    "test:llms:e2e": "bun scripts/test-llms-full-e2e.ts",
-    "measure:performance": "bun scripts/measure-performance.ts",
     "type-check": "fumadocs-mdx && tsc --noEmit",
     "lint": "biome check --write --unsafe .",
     "lint:check": "biome check .",
     "format": "biome format --write .",
     "format:check": "biome format .",
-    "llms-full:generate": "bun scripts/generate-llms-full.ts"
+    "llms-full:generate": "fumadocs-mdx && bun scripts/generate-llms-full.ts",
+    "test:navigation:e2e": "bun scripts/test-navigation-e2e.ts"
   },
   "dependencies": {
     "@sim/db": "workspace:*",
@@ -29,7 +28,6 @@
     "@sim/logger": "workspace:*",
     "@sim/utils": "workspace:*",
     "@sim/workflow-renderer": "workspace:*",
-    "@vercel/speed-insights": "2.0.0",
     "@xyflow/react": "12.12.0",
     "class-variance-authority": "^0.7.1",
     "drizzle-orm": "^0.45.4",
@@ -49,7 +47,6 @@
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@mdx-js/mdx": "3.1.1",
     "@playwright/test": "1.61.1",
     "@sim/tsconfig": "workspace:*",
     "@tailwindcss/postcss": "^4.3.3",
@@ -60,7 +57,6 @@
     "postcss": "^8.5.30",
     "tailwindcss": "^4.3.3",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.4",
-    "vfile": "6.0.3"
+    "vitest": "^5.0.4"
   }
 }
diff --git a/apps/docs/scripts/generate-llms-full.ts b/apps/docs/scripts/generate-llms-full.ts
index 1e1cd1e09bb..b6bfa4d88a6 100644
--- a/apps/docs/scripts/generate-llms-full.ts
+++ b/apps/docs/scripts/generate-llms-full.ts
@@ -1,60 +1,20 @@
 import { createWriteStream } from 'node:fs'
-import { mkdtemp, readdir, readFile, rename, rm } from 'node:fs/promises'
+import { mkdtemp, rename, rm } from 'node:fs/promises'
 import path from 'node:path'
 import { Readable } from 'node:stream'
 import { pipeline } from 'node:stream/promises'
-import { createProcessor } from '@mdx-js/mdx'
 import { createLogger } from '@sim/logger'
 import { compareStrings } from '@sim/utils/string'
-import { frontmatter } from 'fumadocs-core/content/md/frontmatter'
-import { remarkLLMs } from 'fumadocs-core/mdx-plugins/remark-llms'
-import { loader, type VirtualFile } from 'fumadocs-core/source'
-import { applyMdxPreset, frontmatterSchema, remarkInclude } from 'fumadocs-mdx/config'
-import { VFile } from 'vfile'
-import config, { docs } from '@/source.config'
+import { plugin } from 'bun'
+import { createMdxPlugin } from 'fumadocs-mdx/bun'
 
 const MAX_LLM_TEXT_BYTES = 64 * 1024 * 1024
-const logger = createLogger('DocsLlmsFullAsset', { logLevel: 'INFO' })
+const logger = createLogger('DocsLlmsFullAsset')
 
-const started = performance.now()
-const slowestPages: { path: string; parseMs: number; durationMs: number }[] = []
-let parseMs = 0
-let transformMs = 0
-function measureParsing() {
-  return (_tree: unknown, file: VFile) => {
-    file.data.parsedAt = performance.now()
-  }
-}
-const options = await applyMdxPreset(
-  typeof config.mdxOptions === 'function' ? await config.mdxOptions() : config.mdxOptions
-)('bundler')
-// Keep MDX's built-in remark transforms without loading Shiki or the rendered component graph.
-const mdxProcessor = createProcessor({
-  format: 'mdx',
-  remarkPlugins: [
-    measureParsing,
-    remarkInclude,
-    ...(options.remarkPlugins ?? []),
-    [remarkLLMs, { _data: true }],
-  ],
-})
-const markdownProcessor = createProcessor({
-  format: 'md',
-  remarkPlugins: [
-    measureParsing,
-    remarkInclude,
-    ...(options.remarkPlugins ?? []),
-    [remarkLLMs, { _data: true }],
-  ],
-})
-const files = await readdir(docs.dir, { recursive: true })
-const pages: VirtualFile[] = []
-for (const file of files) {
-  if (!/\.mdx?$/.test(file)) continue
-  const { data } = frontmatter(await readFile(path.join(docs.dir, file), 'utf8'))
-  pages.push({ type: 'page', path: file, data: frontmatterSchema.parse(data) })
-}
-const source = loader({ files: pages }, { baseUrl: '/' })
+await plugin(createMdxPlugin({ disableMetaFile: true }))
+
+const { source } = await import('@/lib/source')
+const { getLLMText, isApiOperationPage } = await import('@/lib/llms')
 const publicDirectory = path.resolve('public')
 const temporaryDirectory = await mkdtemp(path.join(publicDirectory, '.llms-full-'))
 const temporaryFile = path.join(temporaryDirectory, 'llms-full.txt')
@@ -64,31 +24,9 @@ async function* generateText(): AsyncGenerator<string> {
   let bytes = 0
   const pages = [...source.getPages()].sort((left, right) => compareStrings(left.url, right.url))
   for (const page of pages) {
-    const filePath = path.resolve(docs.dir, page.path)
-    const parsed = frontmatter(await readFile(filePath, 'utf8'))
-    const file = new VFile({
-      path: filePath,
-      value: parsed.content,
-      data: { frontmatter: parsed.data },
-    })
-    const processor = filePath.endsWith('.mdx') ? mdxProcessor : markdownProcessor
-    const pageStarted = performance.now()
-    await processor.process(file)
-    const pageEnded = performance.now()
-    const parsedAt = typeof file.data.parsedAt === 'number' ? file.data.parsedAt : pageStarted
-    parseMs += parsedAt - pageStarted
-    transformMs += pageEnded - parsedAt
-    slowestPages.push({
-      path: page.path,
-      parseMs: Math.round(parsedAt - pageStarted),
-      durationMs: Math.round(pageEnded - pageStarted),
-    })
-    slowestPages.sort((left, right) => right.durationMs - left.durationMs)
-    slowestPages.length = Math.min(slowestPages.length, 5)
-    if (typeof file.data.markdown !== 'string') {
-      throw new Error(`No processed Markdown was generated for ${page.path}`)
-    }
-    const text = `# ${page.data.title} (${page.url})\n\n${file.data.markdown}`
+    if (!page?.data || !page.url || isApiOperationPage(page)) continue
+    const text = await getLLMText(page)
+    if (!text) continue
     const chunk = `${hasContent ? '\n\n---\n\n' : ''}${text}`
     bytes += Buffer.byteLength(chunk)
     if (bytes > MAX_LLM_TEXT_BYTES) {
@@ -103,14 +41,7 @@ async function* generateText(): AsyncGenerator<string> {
 try {
   await pipeline(Readable.from(generateText()), createWriteStream(temporaryFile))
   await rename(temporaryFile, path.join(publicDirectory, 'llms-full.txt'))
-  logger.info('Generated full documentation static asset', {
-    pages: source.getPages().length,
-    durationMs: Math.round(performance.now() - started),
-    parseMs: Math.round(parseMs),
-    transformMs: Math.round(transformMs),
-    slowestPages,
-    peakMemoryMiB: Math.round(process.resourceUsage().maxRSS / 1024),
-  })
+  logger.info('Generated full documentation static asset')
 } finally {
   await rm(temporaryDirectory, { recursive: true, force: true })
 }
diff --git a/apps/docs/scripts/test-llms-full-e2e.ts b/apps/docs/scripts/test-llms-full-e2e.ts
deleted file mode 100644
index 6512c11183a..00000000000
--- a/apps/docs/scripts/test-llms-full-e2e.ts
+++ /dev/null
@@ -1,79 +0,0 @@
-import { mkdir, readdir, writeFile } from 'node:fs/promises'
-import { dirname } from 'node:path'
-import { createLogger } from '@sim/logger'
-import { getErrorMessage } from '@sim/utils/errors'
-
-const logger = createLogger('DocsLlmsFullE2E')
-const origin = process.env.DOCS_E2E_BASE_URL
-const reportPath = process.env.DOCS_LLMS_REPORT_PATH
-if (!origin || !reportPath) {
-  throw new Error('DOCS_E2E_BASE_URL and DOCS_LLMS_REPORT_PATH are required')
-}
-if (!['localhost', '127.0.0.1', '[::1]'].includes(new URL(origin).hostname)) {
-  throw new Error('The documentation server must use a loopback origin')
-}
-
-interface CheckResult {
-  path: string
-  status: 'passed' | 'failed'
-  durationMs: number
-  error?: string
-}
-
-const checks: CheckResult[] = []
-try {
-  const response = await fetch(new URL('/llms-full.txt', origin), {
-    signal: AbortSignal.timeout(10000),
-  })
-  if (!response.ok) throw new Error(`Full documentation returned ${response.status}`)
-  const text = await response.text()
-  const starts = [...text.matchAll(/^# .+ \((\/[^\n]*)\)\n\n/gm)]
-  const files = await readdir('content/docs', { recursive: true })
-  const pageCount = files.filter((file) => /\.mdx?$/.test(file)).length
-  if (starts.length !== pageCount) {
-    throw new Error(`Expected ${pageCount} authored pages; found ${starts.length}`)
-  }
-  const seen = new Set<string>()
-  for (let index = 0; index < starts.length; index += 1) {
-    const match = starts[index]
-    if (!match) continue
-    const pagePath = match[1]
-    if (!pagePath || seen.has(pagePath)) throw new Error(`Duplicate or missing path: ${pagePath}`)
-    seen.add(pagePath)
-    const started = performance.now()
-    const check: CheckResult = { path: pagePath, status: 'failed', durationMs: 0 }
-    try {
-      const pageResponse = await fetch(new URL(`/llms.mdx${pagePath}`, origin), {
-        signal: AbortSignal.timeout(10000),
-      })
-      if (!pageResponse.ok) throw new Error(`Markdown page returned ${pageResponse.status}`)
-      const actual = await pageResponse.text()
-      const end = starts[index + 1]?.index
-      const expected = text.slice(match.index, end).replace(/\n\n---\n\n$/, '')
-      if (actual !== expected)
-        throw new Error('Bundled text differs from the rendered Markdown page')
-      check.status = 'passed'
-    } catch (error) {
-      check.error = getErrorMessage(error)
-    }
-    check.durationMs = Math.round(performance.now() - started)
-    checks.push(check)
-  }
-} catch (error) {
-  checks.push({
-    path: '/llms-full.txt',
-    status: 'failed',
-    durationMs: 0,
-    error: getErrorMessage(error),
-  })
-}
-
-await mkdir(dirname(reportPath), { recursive: true })
-await writeFile(reportPath, `${JSON.stringify({ checks }, null, 2)}\n`)
-const failures = checks.filter((check) => check.status === 'failed')
-if (failures.length) {
-  logger.error('Full documentation parity failed', { failures })
-  process.exitCode = 1
-} else {
-  logger.info('Full documentation matches every authored Markdown page', { pages: checks.length })
-}
diff --git a/apps/docs/scripts/measure-performance.ts b/apps/docs/scripts/test-navigation-e2e.ts
similarity index 53%
rename from apps/docs/scripts/measure-performance.ts
rename to apps/docs/scripts/test-navigation-e2e.ts
index 9425c9691ef..dd9f4bfe93b 100644
--- a/apps/docs/scripts/measure-performance.ts
+++ b/apps/docs/scripts/test-navigation-e2e.ts
@@ -4,32 +4,15 @@ import { type Browser, chromium, expect } from '@playwright/test'
 import { createLogger } from '@sim/logger'
 import { getErrorMessage } from '@sim/utils/errors'
 
-const logger = createLogger('DocsPerformance', { logLevel: 'INFO' })
-const origin = process.env.DOCS_PERFORMANCE_BASE_URL ?? process.env.DOCS_E2E_BASE_URL
-const reportPath = process.env.DOCS_PERFORMANCE_REPORT_PATH
+const logger = createLogger('DocsNavigationE2E', { logLevel: 'INFO' })
+const origin = process.env.DOCS_E2E_BASE_URL
+const reportPath = process.env.DOCS_NAVIGATION_REPORT_PATH
 if (!origin || !reportPath) {
-  throw new Error('A docs base URL and DOCS_PERFORMANCE_REPORT_PATH are required')
+  throw new Error('A docs base URL and DOCS_NAVIGATION_REPORT_PATH are required')
 }
 const target = new URL(origin)
-if (
-  target.protocol !== 'https:' &&
-  !['localhost', '127.0.0.1', '[::1]'].includes(target.hostname)
-) {
-  throw new Error('Remote measurements require HTTPS')
-}
-
-interface BrowserMetrics {
-  lcpMs: number | null
-  layoutShiftSum: number
-  longTasks: number
-  blockingMs: number
-  tabPaintMs: number[]
-}
-
-declare global {
-  interface Window {
-    docsPerformance: BrowserMetrics
-  }
+if (!['localhost', '127.0.0.1', '[::1]'].includes(target.hostname)) {
+  throw new Error('The documentation server must use a loopback origin')
 }
 
 const pages = [
@@ -55,60 +38,12 @@ try {
       const context = await browser.newContext({ viewport, reducedMotion: 'reduce' })
       const page = await context.newPage()
       const errors: string[] = []
+      const markdownRequests: string[] = []
       page.on('pageerror', (error) => errors.push(error.message))
-      await page.addInitScript(() => {
-        const metrics: BrowserMetrics = {
-          lcpMs: null,
-          layoutShiftSum: 0,
-          longTasks: 0,
-          blockingMs: 0,
-          tabPaintMs: [],
-        }
-        window.docsPerformance = metrics
-        for (const type of ['largest-contentful-paint', 'layout-shift', 'longtask']) {
-          if (!PerformanceObserver.supportedEntryTypes.includes(type)) continue
-          new PerformanceObserver((list) => {
-            for (const entry of list.getEntries()) {
-              if (entry.entryType === 'largest-contentful-paint') metrics.lcpMs = entry.startTime
-              if (entry.entryType === 'layout-shift' && 'value' in entry) {
-                if ('hadRecentInput' in entry && entry.hadRecentInput) continue
-                metrics.layoutShiftSum += Number(entry.value)
-              }
-              if (entry.entryType === 'longtask') {
-                metrics.longTasks += 1
-                metrics.blockingMs += Math.max(0, entry.duration - 50)
-              }
-            }
-          }).observe({ type, buffered: true })
+      page.on('request', (request) => {
+        if (new URL(request.url()).pathname.startsWith('/llms.mdx')) {
+          markdownRequests.push(request.url())
         }
-        document.addEventListener(
-          'pointerdown',
-          (event) => {
-            if (!(event.target instanceof Element)) return
-            const tab = event.target.closest('[role="tab"]')
-            if (!tab || !tab.closest('[aria-label="Request language"]')) return
-            const started = performance.now()
-            const measurePaint = () => {
-              const panelId = tab.getAttribute('aria-controls')
-              const panel = panelId ? document.getElementById(panelId) : null
-              if (
-                tab.getAttribute('aria-selected') === 'true' &&
-                panel &&
-                panel.getBoundingClientRect().height > 0 &&
-                panel.querySelector('code')?.textContent?.trim()
-              ) {
-                requestAnimationFrame(() => {
-                  if (metrics.tabPaintMs.length < 20)
-                    metrics.tabPaintMs.push(performance.now() - started)
-                })
-              } else if (performance.now() - started < 10000) {
-                requestAnimationFrame(measurePaint)
-              }
-            }
-            requestAnimationFrame(measurePaint)
-          },
-          true
-        )
       })
       try {
         const response = await page.goto(new URL(path, origin).toString(), {
@@ -119,24 +54,6 @@ try {
         await page.evaluate(async () => {
           await document.fonts.ready
         })
-        const initial = await page.evaluate(() => {
-          const navigation = performance.getEntriesByType('navigation')[0] as
-            | PerformanceNavigationTiming
-            | undefined
-          const resources = performance.getEntriesByType('resource') as PerformanceResourceTiming[]
-          return {
-            ...window.docsPerformance,
-            fcpMs: performance.getEntriesByName('first-contentful-paint')[0]?.startTime ?? null,
-            ttfbMs: navigation?.responseStart ?? null,
-            loadMs: navigation?.loadEventEnd ?? null,
-            htmlBytes: navigation?.decodedBodySize ?? null,
-            scriptBytes: resources
-              .filter((entry) => entry.initiatorType === 'script')
-              .reduce((total, entry) => total + entry.encodedBodySize, 0),
-            requests: resources.length,
-            domElements: document.querySelectorAll('*').length,
-          }
-        })
         if (path.startsWith('/api-reference/')) {
           const tabs = page.getByRole('tablist', { name: 'Request language' }).getByRole('tab')
           const count = await tabs.count()
@@ -161,18 +78,35 @@ try {
                   panel.querySelector('code')?.textContent?.trim()
               )
             })
-            await page.evaluate(
-              () =>
-                new Promise<void>((resolve) =>
-                  requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
-                )
-            )
           }
-          const recorded = await page.evaluate(() => window.docsPerformance.tabPaintMs.length)
-          if (recorded !== count)
-            throw new Error(`Expected ${count} tab measurements; recorded ${recorded}`)
         }
-        const tabPaintMs = await page.evaluate(() => window.docsPerformance.tabPaintMs)
+        if (viewport.name === 'desktop') {
+          const markdownUrl = new URL(`/llms.mdx${path}`, origin).toString()
+          const markdown = await page.request.get(markdownUrl)
+          expect(markdown.ok()).toBe(true)
+          const expected = await markdown.text()
+          const copy = page.getByRole('button', { name: 'Copy page content', exact: true })
+          await context.grantPermissions(['clipboard-read', 'clipboard-write'])
+          expect(markdownRequests).toEqual([])
+          await copy.click()
+          await expect(page.getByRole('button', { name: 'Copied to clipboard' })).toBeVisible()
+          expect(markdownRequests).toEqual([markdownUrl])
+          await expect
+            .poll(() => page.evaluate(() => navigator.clipboard.readText()))
+            .toBe(expected)
+          await page.route(markdownUrl, (route) =>
+            route.fulfill({ status: 503, body: 'Unavailable' })
+          )
+          await page.getByRole('button', { name: 'Copied to clipboard' }).click()
+          await expect(page.getByRole('status')).toHaveText('Could not copy. Try again.')
+          await expect(page.getByRole('button', { name: 'Copied to clipboard' })).toHaveCount(0)
+          await expect
+            .poll(() => page.evaluate(() => navigator.clipboard.readText()))
+            .toBe(expected)
+          await page.unroute(markdownUrl)
+          await copy.click()
+          await expect(page.getByRole('button', { name: 'Copied to clipboard' })).toBeVisible()
+        }
         await page.screenshot({
           path: join(dirname(reportPath), `${viewport.name}${path.replaceAll('/', '-')}.png`),
         })
@@ -207,14 +141,23 @@ try {
           }
           await expect(costs).toHaveAttribute('aria-current', 'page')
           await expect(platform).toHaveAttribute('aria-expanded', 'true')
+          if (!mobile) {
+            const markdown = await page.request.get(
+              new URL('/llms.mdx/platform/costs', origin).toString()
+            )
+            expect(markdown.ok()).toBe(true)
+            await page.getByRole('button', { name: 'Copy page content', exact: true }).click()
+            await expect(page.getByRole('button', { name: 'Copied to clipboard' })).toBeVisible()
+            await expect
+              .poll(() => page.evaluate(() => navigator.clipboard.readText()))
+              .toBe(await markdown.text())
+          }
         }
         results.push({
           path,
           viewport: viewport.name,
           status: errors.length ? 'failed' : 'passed',
           durationMs: Math.round(performance.now() - started),
-          ...initial,
-          tabPaintMs,
           errors,
         })
         if (errors.length) failed = true
@@ -240,8 +183,8 @@ try {
   await browser?.close()
   await writeFile(
     reportPath,
-    `${JSON.stringify({ measuredAt: new Date().toISOString(), origin: target.origin, results }, null, 2)}\n`
+    `${JSON.stringify({ checkedAt: new Date().toISOString(), origin: target.origin, results }, null, 2)}\n`
   )
 }
-logger.info('Recorded documentation performance', { pages: results.length, reportPath })
+logger.info('Verified documentation navigation', { pages: results.length, reportPath })
 if (failed) process.exitCode = 1
diff --git a/apps/docs/source.config.ts b/apps/docs/source.config.ts
index a1fcf8495a3..c69f7fb4e50 100644
--- a/apps/docs/source.config.ts
+++ b/apps/docs/source.config.ts
@@ -12,6 +12,7 @@ const DOCS_DIR = 'content/docs'
 export const docs = defineDocs({
   dir: DOCS_DIR,
   docs: {
+    async: true,
     schema: frontmatterSchema.extend({
       integration: z.object({ type: z.string(), color: z.string() }).optional(),
     }),
diff --git a/bun.lock b/bun.lock
index 2ffa40b1b10..cb5c338e428 100644
--- a/bun.lock
+++ b/bun.lock
@@ -94,7 +94,6 @@
         "@sim/logger": "workspace:*",
         "@sim/utils": "workspace:*",
         "@sim/workflow-renderer": "workspace:*",
-        "@vercel/speed-insights": "2.0.0",
         "@xyflow/react": "12.12.0",
         "class-variance-authority": "^0.7.1",
         "drizzle-orm": "^0.45.4",
@@ -114,7 +113,6 @@
         "zod": "4.3.6",
       },
       "devDependencies": {
-        "@mdx-js/mdx": "3.1.1",
         "@playwright/test": "1.61.1",
         "@sim/tsconfig": "workspace:*",
         "@tailwindcss/postcss": "^4.3.3",
@@ -125,7 +123,6 @@
         "postcss": "^8.5.30",
         "tailwindcss": "^4.3.3",
         "typescript": "^7.0.2",
-        "vfile": "6.0.3",
         "vitest": "^5.0.4",
       },
     },
@@ -2469,8 +2466,6 @@
 
     "@vercel/oidc": ["@vercel/oidc@3.1.0", "", {}, "sha512-Fw28YZpRnA3cAHHDlkt7xQHiJ0fcL+NRcIqsocZQUSmbzeIKRpwttJjik5ZGanXP+vlA4SbTg+AbA3bP363l+w=="],
 
-    "@vercel/speed-insights": ["@vercel/speed-insights@2.0.0", "", { "peerDependencies": { "@sveltejs/kit": "^1 || ^2", "next": ">= 13", "nuxt": ">= 3", "react": "^18 || ^19 || ^19.0.0-rc", "svelte": ">= 4", "vue": "^3", "vue-router": "^4" }, "optionalPeers": ["@sveltejs/kit", "next", "nuxt", "react", "svelte", "vue", "vue-router"] }, "sha512-jwkNcrTeafWxjmWq4AHBaptSqZiJkYU5adLC9QBSqeim0GcqDMgN5Ievh8OG1rJ6W3A4l1oiP7qr9CWxGuzu3w=="],
-
     "@vitejs/plugin-react": ["@vitejs/plugin-react@6.1.2", "", { "dependencies": { "@rolldown/pluginutils": "^1.0.1" }, "peerDependencies": { "@rolldown/plugin-babel": "^0.1.7 || ^0.2.0", "babel-plugin-react-compiler": "^1.0.0", "oxc-transform-react": "^0.152.0", "vite": "^8.0.0" }, "optionalPeers": ["@rolldown/plugin-babel", "babel-plugin-react-compiler", "oxc-transform-react"] }, "sha512-fhJNGUdscQa4HkI0xFxwonWyhnVReCPDbXI7FH7jmzpnVCrFQI7PRrhWecO263610vOrs9tr2Y4xcf8uAdFxbw=="],
 
     "@vitest/coverage-v8": ["@vitest/coverage-v8@5.0.4", "", { "dependencies": { "@bcoe/v8-coverage": "^1.0.2", "@vitest/istanbul-lib-coverage": "^1.0.2", "@vitest/istanbul-lib-report": "^1.0.2", "ast-v8-to-istanbul": "^1.0.7", "magicast": "^0.5.5", "obug": "^3.0.0", "std-env": "^4.3.0", "tinyrainbow": "^3.2.0" }, "peerDependencies": { "@vitest/browser": "5.0.4", "vitest": "5.0.4" }, "optionalPeers": ["@vitest/browser"] }, "sha512-P5YcQY8Y6RmoE9xRXI38rT8pssbcubEzqtYTM2XQoxOXMDn04nRaTI1SM8qCl9/NfW3ag9GlzdSXu7IwO5Ft8A=="],

From fc46b64527ec620fc535b1d0281cc96099a7e7f4 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Wed, 21 Oct 2026 11:10:03 -0700
Subject: [PATCH 4/5] fix(docs): preserve dates when loading page content

---
 apps/docs/app/[[...slug]]/page.tsx | 4 ++--
 apps/docs/lib/source.ts            | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/docs/app/[[...slug]]/page.tsx b/apps/docs/app/[[...slug]]/page.tsx
index 105ed0b2146..b878402a828 100644
--- a/apps/docs/app/[[...slug]]/page.tsx
+++ b/apps/docs/app/[[...slug]]/page.tsx
@@ -316,7 +316,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
     )
   }
 
-  const { body: MDX, toc } = await data.load()
+  const { body: MDX, toc, lastModified } = await data.load()
 
   return (
     <>
@@ -324,7 +324,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
         title={data.title}
         description={data.description || ''}
         url={`${BASE_URL}${page.url}`}
-        dateModified={data.lastModified?.toISOString()}
+        dateModified={lastModified?.toISOString()}
         breadcrumb={breadcrumbs}
       />
       <DocsPage
diff --git a/apps/docs/lib/source.ts b/apps/docs/lib/source.ts
index dd50ee0ea82..f26468d8908 100644
--- a/apps/docs/lib/source.ts
+++ b/apps/docs/lib/source.ts
@@ -129,5 +129,5 @@ export type PageData = DocData &
     description?: string
     full?: boolean
     integration?: { type: string; color: string }
-    load: () => Promise<DocData>
+    load: () => Promise<DocData & { lastModified?: Date }>
   }

From 2b576bda8e6a3e212195d8360326c1abfcf86c5b Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Wed, 21 Oct 2026 11:20:28 -0700
Subject: [PATCH 5/5] fix(docs): preserve sitemap dates with lazy content

---
 apps/docs/app/sitemap.ts              | 17 ++++++++++-------
 apps/docs/components/page-actions.tsx |  4 +++-
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/apps/docs/app/sitemap.ts b/apps/docs/app/sitemap.ts
index 17e36be5d4b..84f6a15fc6e 100644
--- a/apps/docs/app/sitemap.ts
+++ b/apps/docs/app/sitemap.ts
@@ -4,13 +4,16 @@ import { DOCS_BASE_URL } from '@/lib/urls'
 
 export const revalidate = 3600
 
-export default function sitemap(): MetadataRoute.Sitemap {
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
   // The docs root redirects to /introduction, which is listed on its own.
-  return source
-    .getPages()
-    .filter((page) => page.url !== '/')
-    .map((page) => ({
+  const entries: MetadataRoute.Sitemap = []
+  for (const page of source.getPages()) {
+    if (page.url === '/') continue
+    const data = page.data.type === 'docs' ? await page.data.load() : undefined
+    entries.push({
       url: `${DOCS_BASE_URL}${page.url}`,
-      lastModified: 'lastModified' in page.data ? page.data.lastModified : undefined,
-    }))
+      lastModified: data?.lastModified,
+    })
+  }
+  return entries
 }
diff --git a/apps/docs/components/page-actions.tsx b/apps/docs/components/page-actions.tsx
index 44c97943b39..7be1cd3ac9d 100644
--- a/apps/docs/components/page-actions.tsx
+++ b/apps/docs/components/page-actions.tsx
@@ -18,7 +18,9 @@ export function LLMCopyButton({ markdownUrl }: LLMCopyButtonProps) {
     setPending(true)
     setFailed(false)
     const prepare = async () => {
-      const response = await fetch(markdownUrl, { signal: AbortSignal.timeout(10000) })
+      const response = await fetch(markdownUrl, {
+        signal: typeof AbortSignal.timeout === 'function' ? AbortSignal.timeout(10000) : undefined,
+      })
       if (!response.ok) throw new Error('Could not load page Markdown')
       return response.text()
     }