Skip to content

Migrate docs to package-backed geistdocs#2222

Merged
molebox merged 14 commits into
mainfrom
migrate-docs
Jul 13, 2026
Merged

Migrate docs to package-backed geistdocs#2222
molebox merged 14 commits into
mainfrom
migrate-docs

Conversation

@molebox

@molebox molebox commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Previews

Summary

Migrates the docs app from the old copied geist/Fumadocs/custom runtime to the package-backed @vercel/geistdocs architecture.

Changes

  • Added @vercel/geistdocs and aligned supported Next/React versions.
  • Replaced local docs page, layout, MDX, search, chat, Markdown, sitemap, agents, and proxy runtime code with thin package-backed adapters.
  • Preserved public docs route families:
    • /docs
    • /cookbook
    • /v5/docs
    • /v5/cookbook
    • /worlds
    • /llms.txt
    • /sitemap.md
    • /agents.md
    • page-level .md routes
  • Kept project-specific content, homepage, worlds pages, OG routes, RSS, metadata, and styling overrides local.
  • Removed copied Geistdocs/AI chat/search/sidebar/page-action runtime code.

Verification

  • pnpm --filter docs build passes.
  • Manually checked local docs routes and machine-readable surfaces.
  • Verified code blocks include Shiki token styles and package stylesheet palette.
  • Verified no deep imports from @vercel/geistdocs/dist.
  • Verified no public/llms.txt masks the App Router route.

Notes

Full docs lint/typecheck still have pre-existing unrelated failures in generated .source, homepage visual lint, components/worlds/BenchmarkChart.tsx, and lib/github.ts.

@vercel

vercel Bot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Jul 13, 2026 11:58am
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jul 13, 2026 11:58am
example-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-astro-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-express-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-fastify-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-hono-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-nitro-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-nuxt-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-sveltekit-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workbench-vite-workflow Ready Ready Preview, Comment Jul 13, 2026 11:58am
workflow-docs Ready Ready Preview, Comment, Open in v0 Jul 13, 2026 11:58am
workflow-swc-playground Ready Ready Preview, Comment Jul 13, 2026 11:58am
workflow-tarballs Building Building Preview, Comment Jul 13, 2026 11:58am
workflow-web Ready Ready Preview, Comment Jul 13, 2026 11:58am

@changeset-bot

changeset-bot Bot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 3e0bc8f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions

github-actions Bot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

✅ All tests passed

Summary

Passed Failed Skipped Total
✅ ▲ Vercel Production 1453 0 230 1683
✅ 💻 Local Development 1617 0 219 1836
✅ 📦 Local Production 1617 0 219 1836
✅ 🐘 Local Postgres 1617 0 219 1836
✅ 🪟 Windows 153 0 0 153
✅ 📋 Other 894 0 177 1071
Total 7351 0 1064 8415

Details by Category

✅ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 126 0 27
✅ example 126 0 27
✅ express 126 0 27
✅ fastify 126 0 27
✅ hono 126 0 27
✅ nextjs-turbopack 150 0 3
✅ nextjs-webpack 150 0 3
✅ nitro 126 0 27
✅ nuxt 126 0 27
✅ sveltekit 145 0 8
✅ vite 126 0 27
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-canary 134 0 19
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-canary 134 0 19
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-canary 134 0 19
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 153 0 0
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 128 0 25
✅ e2e-local-dev-tanstack-start- 128 0 25
✅ e2e-local-postgres-nest-stable 128 0 25
✅ e2e-local-postgres-tanstack-start- 128 0 25
✅ e2e-local-prod-nest-stable 128 0 25
✅ e2e-local-prod-tanstack-start- 128 0 25
✅ e2e-vercel-prod-tanstack-start 126 0 27

📋 View full workflow run

@github-actions

github-actions Bot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit 3e0bc8f · Mon, 13 Jul 2026 12:56:24 GMT · run logs

Backend: vercel · app: nextjs-turbopack

Metric Scenario Avg (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS stream 1299 (-13%) 1731 🔴 1781 🔴 2206 🔴 30
TTFS hook + stream 1694 (+6.9%) 2000 🔴 2239 🔴 2860 🔴 30
STSO 1020 steps (1-20) 272 (-18%) 311 🔴 399 🔴 421 🔴 19
STSO 1020 steps (101-120) 483 (+11%) 533 🔴 709 🔴 747 🔴 19
STSO 1020 steps (1001-1020) 902 (+8.5%) 954 🔴 983 🔴 992 🔴 19
WO stream 1299 (-13%) 1731 1781 2206 30
WO hook + stream 1694 (+6.9%) 2000 2239 2860 30
SL stream 4194 (-19%) 5537 🔴 5833 🔴 6044 🔴 30
SL hook + stream 4878 (-1.7%) 5622 🔴 5753 🔴 5987 🔴 30
📜 Previous results (3)

dc75b65

Fri, 10 Jul 2026 11:18:50 GMT · run logs

vercel / nextjs-turbopack

Metric Scenario Avg (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS stream 1310 (+12%) 1673 🔴 1713 🔴 2696 🔴 30
TTFS hook + stream 1596 (+16%) 1933 🔴 1999 🔴 2123 🔴 30
STSO 1020 steps (1-20) 274 (+0.7%) 293 🔴 379 🔴 524 🔴 19
STSO 1020 steps (101-120) 435 (+4.3%) 449 🔴 631 🔴 922 🔴 19
STSO 1020 steps (1001-1020) 880 (-18%) 946 🔴 972 🔴 1012 🔴 19
WO stream 1310 (+12%) 1673 1713 2696 30
WO hook + stream 1596 (+16%) 1933 1999 2123 30
SL stream 4706 (-4.4%) 5595 🔴 5837 🔴 6162 🔴 30
SL hook + stream 4966 (-1.1%) 5618 🔴 5707 🔴 5786 🔴 30

8e0829a

Fri, 10 Jul 2026 10:21:25 GMT · run logs

vercel / nextjs-turbopack

Metric Scenario Avg (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS stream 1254 (+7.3%) 1683 🔴 1716 🔴 2022 🔴 30
TTFS hook + stream 1487 (+8.1%) 1888 🔴 2026 🔴 2132 🔴 30
STSO 1020 steps (1-20) 278 (+2.4%) 311 🔴 412 🔴 451 🔴 19
STSO 1020 steps (101-120) 399 (-4.3%) 412 🔴 577 🔴 648 🔴 19
STSO 1020 steps (1001-1020) 876 (-19%) 930 🔴 960 🔴 1001 🔴 19
WO stream 1254 (+7.3%) 1683 1716 2022 30
WO hook + stream 1487 (+8.1%) 1888 2026 2132 30
SL stream 4356 (-12%) 5088 🔴 5618 🔴 5770 🔴 30
SL hook + stream 5016 (±0%) 5559 🔴 5592 🔴 6653 🔴 30

3b0b5fc

Thu, 09 Jul 2026 19:04:54 GMT · run logs

vercel / nextjs-turbopack

Metric Scenario Avg (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS stream 1124 (+5.9%) 1606 🔴 1626 🔴 2762 🔴 30
TTFS hook + stream 1612 (+24%) 1901 🔴 1986 🔴 2153 🔴 30
STSO 1020 steps (1-20) 275 (+1.1%) 297 🔴 401 🔴 461 🔴 19
STSO 1020 steps (101-120) 404 (+0.7%) 415 🔴 629 🔴 700 🔴 19
STSO 1020 steps (1001-1020) 917 (+9.9%) 991 🔴 1095 🔴 1194 🔴 19
WO stream 1124 (+5.9%) 1606 1626 2762 30
WO hook + stream 1612 (+24%) 1901 1986 2153 30
SL stream 4633 (-2.7%) 5573 🔴 5720 🔴 5894 🔴 30
SL hook + stream 4853 (-1.4%) 5313 🔴 5535 🔴 5756 🔴 30

Avg deltas compare against the most recent benchmark run on main at the time of this run.

Metrics — TTFS: time to first step body execution · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (time outside step bodies, client start → last step body exit) · SL: stream latency (first chunk write → visible to the reader)

Scenarios — stream: one step that streams chunks back to the client; no hooks, so the run stays in turbo mode · hook + stream: registers a hook before the same streaming step, which exits turbo mode · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges

🟢/🔴 mark percentiles within/above target. Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

TTFS/WO compare client vs deployment clocks and SL compares the step runner’s clock vs the client’s (NTP-synced in CI). WO ends at the last step body exit, the closest observable proxy for the final step-completion request.

Copilot AI reviewed Jun 2, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Migrates the docs app from a locally-copied Geist/Fumadocs runtime to the package-backed @vercel/geistdocs architecture, keeping existing public route families while replacing most runtime/UI plumbing with thin adapters around the upstream package.

Changes:

  • Adopt @vercel/geistdocs for docs layout/MDX/rendering, plus package-provided search/chat/LLMs/sitemap/agents/mcp routes.
  • Remove large amounts of locally maintained UI/runtime code (chat/search/sidebar/layout/actions) in favor of upstream components and helpers.
  • Update docs tooling/config (source config + link lint + sitemap/RSS generation) to work with versioned Geistdocs sources.

Reviewed changes

Copilot reviewed 223 out of 224 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
packages/docs-typecheck/src/tests/sitemap-guard.test.ts Updates the sitemap guard to account for package-backed markdown routes.
docs/source.config.ts Switches to Geistdocs-provided Zod schemas and default source config.
docs/scripts/lint.ts Adapts link linting to pull raw MDX content from Geistdocs pages.
docs/package.json Adds @vercel/geistdocs, updates Next/React versions, removes unused local deps.
docs/next.config.ts Removes Accept-header rewrites now handled elsewhere in the new architecture.
docs/lib/tsdoc/tsdoc.tsx Adds error handling + switches Callout import to Geistdocs package component.
docs/lib/geistdocs/versions.ts Makes v4/v5 version selection explicit and updates versioned URL docstring.
docs/lib/geistdocs/version-source.ts Tightens typing for rewriteUrl and preserves URL rewriting behavior.
docs/lib/geistdocs/i18n.ts Removes local i18n wiring in favor of package-backed provider/layout.
docs/lib/geistdocs/db.ts Removes local Dexie chat persistence (chat now handled via package route/proxy).
docs/lib/geistdocs/config.tsx Introduces centralized Geistdocs config (nav/content/versions/ai).
docs/hooks/geistdocs/use-version.tsx Removes local version state provider/hook (replaced by package version select).
docs/hooks/geistdocs/use-sidebar.ts Removes local jotai-based sidebar state hook (package-owned UI).
docs/hooks/geistdocs/use-chat.ts Removes local jotai-based chat state hook (package-owned UI).
docs/geistdocs.tsx Extends site metadata (GitHub edit config + agent readiness config).
docs/content/docs/v5/migration-guides/migrating-from-trigger-dev.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/migration-guides/migrating-from-temporal.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/migration-guides/migrating-from-inngest.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/migration-guides/migrating-from-aws-step-functions.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/vite.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/tanstack-start.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/sveltekit.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/python.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/nuxt.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/nitro.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/next.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/nestjs.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/hono.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/fastify.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/express.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/getting-started/astro.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/webhook-response-not-sent.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/timeout-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/start-invalid-workflow-function.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/serialization-failed.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/node-js-module-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/hook-conflict.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/fetch-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/errors/abort-signal-timeout-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/integrations/sandbox.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/integrations/chat-sdk.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/integrations/ai-sdk.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/common-patterns/webhooks.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/common-patterns/scheduling.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/common-patterns/saga.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/common-patterns/rate-limiting.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/common-patterns/batching.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/agent-patterns/human-in-the-loop.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/agent-patterns/durable-agent.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/agent-patterns/agent-cancellation.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/advanced/upgrading-workflows.mdx Adds CopyPrompt helper content.
docs/content/docs/v5/cookbook/advanced/child-workflows.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/migration-guides/migrating-from-trigger-dev.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/migration-guides/migrating-from-temporal.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/migration-guides/migrating-from-inngest.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/migration-guides/migrating-from-aws-step-functions.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/vite.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/tanstack-start.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/sveltekit.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/python.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/nuxt.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/nitro.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/next.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/nestjs.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/hono.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/fastify.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/express.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/getting-started/astro.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/webhook-response-not-sent.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/timeout-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/start-invalid-workflow-function.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/serialization-failed.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/node-js-module-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/hook-conflict.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/errors/fetch-in-workflow.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/integrations/sandbox.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/integrations/chat-sdk.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/integrations/ai-sdk.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/common-patterns/webhooks.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/common-patterns/scheduling.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/common-patterns/saga.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/common-patterns/rate-limiting.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/common-patterns/batching.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/agent-patterns/human-in-the-loop.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/agent-patterns/durable-agent.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/agent-patterns/agent-cancellation.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/advanced/upgrading-workflows.mdx Adds CopyPrompt helper content.
docs/content/docs/v4/cookbook/advanced/child-workflows.mdx Adds CopyPrompt helper content.
docs/components/worlds/WorldTestingPerformance.tsx Switches Tooltip usage to Geistdocs package tooltip component.
docs/components/worlds/WorldInstructions.tsx Switches Button usage to Geistdocs package button component.
docs/components/worlds/WorldDetailHero.tsx Switches Button/Tooltip usage to Geistdocs package components.
docs/components/worlds/WorldCardSimple.tsx Switches Tooltip usage to Geistdocs package tooltip component.
docs/components/worlds/BenchmarkHistoryChart.tsx Switches Dialog usage to Geistdocs package dialog component.
docs/components/ui/tooltip.tsx Removes local tooltip implementation (now using package component).
docs/components/ui/toggle.tsx Removes local UI component implementation.
docs/components/ui/toggle-group.tsx Removes local UI component implementation.
docs/components/ui/textarea.tsx Removes local UI component implementation.
docs/components/ui/switch.tsx Removes local UI component implementation.
docs/components/ui/spinner.tsx Removes local UI component implementation.
docs/components/ui/sonner.tsx Removes local toaster implementation (feedback/chat UI removed).
docs/components/ui/slider.tsx Removes local UI component implementation.
docs/components/ui/sheet.tsx Removes local UI component implementation.
docs/components/ui/separator.tsx Removes local UI component implementation.
docs/components/ui/scroll-area.tsx Removes local UI component implementation.
docs/components/ui/resizable.tsx Removes local UI component implementation.
docs/components/ui/radio-group.tsx Removes local UI component implementation.
docs/components/ui/progress.tsx Removes local UI component implementation.
docs/components/ui/popover.tsx Removes local UI component implementation.
docs/components/ui/pagination.tsx Removes local UI component implementation.
docs/components/ui/label.tsx Removes local UI component implementation.
docs/components/ui/kbd.tsx Removes local UI component implementation.
docs/components/ui/input.tsx Removes local UI component implementation.
docs/components/ui/input-otp.tsx Removes local UI component implementation.
docs/components/ui/hover-card.tsx Removes local UI component implementation.
docs/components/ui/form.tsx Removes local UI component implementation.
docs/components/ui/empty.tsx Removes local UI component implementation.
docs/components/ui/dialog.tsx Removes local UI component implementation.
docs/components/ui/collapsible.tsx Removes local UI component implementation.
docs/components/ui/checkbox.tsx Removes local UI component implementation.
docs/components/ui/button.tsx Removes local UI component implementation (use Geistdocs package button).
docs/components/ui/button-group.tsx Removes local UI component implementation.
docs/components/ui/aspect-ratio.tsx Removes local UI component implementation.
docs/components/ui/alert.tsx Removes local UI component implementation.
docs/components/ui/alert-dialog.tsx Removes local UI component implementation.
docs/components/preview-install.tsx Switches Button usage to Geistdocs package button component.
docs/components/geistdocs/x-button.tsx Removes local social button implementation (package navbar/footer).
docs/components/geistdocs/video.tsx Removes local video component (package MDX/components).
docs/components/geistdocs/version-switcher.tsx Removes local version switcher UI (package versions UI).
docs/components/geistdocs/theme-toggle.tsx Removes local theme toggle (package navbar/footer).
docs/components/geistdocs/search.tsx Removes local search dialog/button (package search).
docs/components/geistdocs/scroll-top.tsx Removes local scroll-to-top UI (package UI).
docs/components/geistdocs/rss-button.tsx Removes local RSS button UI (package footer).
docs/components/geistdocs/provider.tsx Replaces local RootProvider wiring with Geistdocs package provider.
docs/components/geistdocs/open-in-chat.tsx Removes local “open in chat” widget (package AI/chat).
docs/components/geistdocs/navbar.tsx Removes local navbar (package navbar).
docs/components/geistdocs/navbar-logo.tsx Removes local navbar logo component (package navbar).
docs/components/geistdocs/mobile-docs-bar.tsx Removes local mobile docs bar (package docs layout).
docs/components/geistdocs/message-metadata.tsx Removes local chat message metadata UI.
docs/components/geistdocs/mermaid.tsx Removes local mermaid renderer (package MDX pipeline).
docs/components/geistdocs/mdx-components.tsx Switches to createMdxComponents and wires custom components into package MDX system.
docs/components/geistdocs/language-selector.tsx Removes local language selector (package navbar/footer).
docs/components/geistdocs/installer.tsx Removes local installer widget (package UI).
docs/components/geistdocs/icons.tsx Removes local icon helper.
docs/components/geistdocs/home-layout.tsx Replaces local Fumadocs layout wrapper with Geistdocs home layout.
docs/components/geistdocs/github-button.tsx Removes local GitHub button (package footer).
docs/components/geistdocs/footer.tsx Removes local footer (package footer).
docs/components/geistdocs/feedback.tsx Removes local feedback UI flow.
docs/components/geistdocs/edit-source.tsx Removes local “Edit this page” link (package handles via github config).
docs/components/geistdocs/docs-page.tsx Removes local docs page wrapper (package docs layout).
docs/components/geistdocs/docs-layout.tsx Switches to Geistdocs docs layout and adds version select + sidebar badges.
docs/components/geistdocs/desktop-menu.tsx Removes local desktop menu (package navbar).
docs/components/geistdocs/copy-page.tsx Removes local copy-page action UI.
docs/components/geistdocs/copy-chat.tsx Removes local chat copy UI.
docs/components/geistdocs/code-block-tabs.tsx Removes local code block tabs wrapper (package MDX/code).
docs/components/geistdocs/callout.tsx Removes local callout wrappers (use package callout).
docs/components/geistdocs/ask-ai.tsx Removes local ask-ai widget (package chat).
docs/components/custom/fluid-compute-callout.tsx Switches Callout usage to Geistdocs package component.
docs/components/ai-elements/suggestion.tsx Removes local AI UI elements.
docs/components/ai-elements/sources.tsx Removes local AI UI elements.
docs/components/ai-elements/shimmer.tsx Removes local AI UI elements.
docs/components/ai-elements/conversation.tsx Removes local AI UI elements.
docs/app/styles/geistdocs.css Switches styling baseline to Geistdocs package stylesheet.
docs/app/sitemap.ts Updates sitemap generation to iterate over versioned sources.
docs/app/sitemap.md/route.ts Replaces custom sitemap.md route with package-backed route.
docs/app/robots.ts Makes robots sitemap host configurable with a local fallback.
docs/app/og/[...slug]/route.tsx Makes OG generation tolerant of missing title/description fields.
docs/app/global.css Routes global styling through the new geistdocs stylesheet.
docs/app/api/search/route.ts Replaces custom search indexing route with package-backed search route.
docs/app/api/chat/utils.ts Removes custom chat system prompt construction (package-backed chat).
docs/app/api/chat/types.ts Removes custom chat message typing (package-backed chat).
docs/app/api/chat/route.ts Replaces custom chat handler with package-backed chat route + optional proxy.
docs/app/actions/feedback/index.ts Removes server action for feedback submission.
docs/app/actions/feedback/emotions.ts Removes feedback emotion list used by deleted UI.
docs/app/[lang]/worlds/page.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/worlds/compare/page.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/worlds/[id]/page.tsx Tightens types for MDX body/toc extraction.
docs/app/[lang]/v5/docs/layout.tsx Passes explicit currentVersion into docs layout.
docs/app/[lang]/v5/cookbook/layout.tsx Passes explicit currentVersion into docs layout.
docs/app/[lang]/sitemap.md/route.ts Replaces custom localized sitemap.md route with package-backed route.
docs/app/[lang]/rss.xml/route.ts Updates RSS generation to include pages from current sources with safer fallbacks.
docs/app/[lang]/llms.txt/route.ts Replaces custom llms.txt generator with package-backed route.
docs/app/[lang]/llms.mdx/[[...slug]]/route.ts Replaces custom page-level markdown route with package-backed route.
docs/app/[lang]/layout.tsx Switches to package Navbar/Footer and uses package-backed config/provider.
docs/app/[lang]/docs/layout.tsx Passes explicit currentVersion into docs layout.
docs/app/[lang]/cookbook/layout.tsx Passes explicit currentVersion into docs layout.
docs/app/[lang]/agents.md/route.ts Adds package-backed agents markdown route.
docs/app/[lang]/.well-known/mcp.json/route.ts Adds package-backed MCP manifest route.
docs/app/[lang]/(home)/components/vercel-com-visuals/vercel-section.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/(home)/components/vercel-com-visuals/feature-grid.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/(home)/components/vercel-com-visuals/downtime-visual.tsx Switches Spinner usage to Geistdocs package spinner component.
docs/app/[lang]/(home)/components/templates/index.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/(home)/components/run-anywhere.tsx Switches Button usage to Geistdocs package button component.
docs/app/[lang]/(home)/components/preview-badge.tsx Switches Button/Dialog usage to Geistdocs package components.
docs/app/[lang]/(home)/components/hero.tsx Updates agent install command string.
docs/app/[lang]/(home)/components/cta.tsx Switches Button usage to Geistdocs package button component.
Files not reviewed (1)
  • pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/components/geistdocs/mdx-components.tsx Outdated
Comment thread packages/docs-typecheck/src/__tests__/sitemap-guard.test.ts Outdated
karthikscale3
karthikscale3 requested changes Jun 2, 2026
View reviewed changes

@karthikscale3 karthikscale3 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these logos dont look right

Image

karthikscale3
karthikscale3 reviewed Jun 2, 2026
View reviewed changes

@karthikscale3 karthikscale3 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

prompt doesn't appear consistently in all the pages. Ex: https://workflow-docs-git-migrate-docs.vercel.sh/cookbook/common-patterns/sequential-and-parallel

karthikscale3
karthikscale3 reviewed Jun 2, 2026
View reviewed changes

@karthikscale3 karthikscale3 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

should workflow show up in the dropdown again? also should we put the "sdk" badge beside it for the sake of consistency

@pranaygp

pranaygp commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

also should we put the "sdk" badge beside it for the sake of consistency

nope. that's not a valid lockup @karthikscale3 so we're not doing that

pranaygp
pranaygp reviewed Jun 2, 2026
View reviewed changes

@pranaygp pranaygp left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found two user-facing regressions in the package-backed docs migration.

Comment thread docs/lib/geistdocs/source.ts Outdated
Comment thread docs/app/[lang]/llms.txt/route.ts Outdated
@karthikscale3

karthikscale3 commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Please let us know when this is ready for a re-review

@molebox

molebox commented Jul 8, 2026

Copy link
Copy Markdown
Contributor Author

This PR is un-staled and ready for re-review @karthikscale3 @pranaygp.

What changed

Merged main back in (was 221 commits behind, conflicting). Notable ports into the package-backed architecture:

Bumped @vercel/geistdocs 1.4.0 → 1.8.2. This picks up the OSS navbar dropdown fix (1.8.0: real logo lockups, eve added, Streamdown dropped, AI Elements moved to the end — the package default now matches what main shipped in #2586/#2543, and Workflow appears with a proper lockup, no "SDK" badge), plus active-nav highlight, Ask AI markdown style fixes, search breadcrumbs, and code-block polish.

Review feedback addressed:

  • Version dropdown logos — version items now use the Workflow glyph (IconWorkflow from the package assets) instead of the default lucide box/archive icons.
  • CopyPrompt consistency — added prompts to the remaining 13 cookbook recipe pages (sequential-and-parallel, timeouts, idempotency, workflow-composition, serializable-steps, publishing-libraries, distributed-abort-controller — v4 and v5, with version-appropriate wording for the v4/v5 start() and cancellation differences).
  • Edit links — now version-scoped (docs/content/docs/v4/{path} vs .../v5/{path}) via per-page-family github.editPath overrides; previously they dropped the version segment.
  • Copilot's two open threads (WorldTestingPerformance stub, brittle sitemap-guard path) were already fixed in cb573b5 — replied inline.

Still holding from the earlier round: /llms.txt, /api/search, /api/chat read currentSources (v4 only); page-level .md routes read allSources; the v5 markdown URL rewrite stays scoped to local link targets (external vercel.com/docs/... links verified untouched).

Verification

  • pnpm --filter docs build ✅, tsc --noEmit (only the 3 pre-existing failures: BenchmarkChart, lib/github.ts ×2) ✅, biome (same pre-existing error count as main) ✅
  • docs link lint ✅, docs-typecheck suite (1014 code samples) ✅, sitemap-guard ✅, docs smoke checks ✅
  • next start spot checks: .md negotiation, sitemap/llms/agents surfaces, AutoCards markdown expansion, v4/v5 edit links, redirects ✅

@molebox

molebox commented Jul 9, 2026

Copy link
Copy Markdown
Contributor Author

Follow-ups from Slack feedback (Chris):

  • Workflow removed from the OSS products dropdown — the geistdocs 1.8.2 default list includes the site's own product, so the docs config now overrides navbarOssProducts with eve, AI SDK, Flags SDK, Chat SDK, and AI Elements (matching what main shipped in [docs] use actual eve logo in OSS nav dropdown #2586). 99a52c2
  • Chat panel vs command menu z-order — fixed upstream as requested: vercel/geistdocs#138 lowers the Ask AI panel to z-45 (above the navbar, below all modal surfaces incl. the search command menu). It'll reach this site with the next geistdocs patch bump; no local workaround added.

@molebox

molebox commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

Bumped @vercel/geistdocs 1.8.2 → 1.11.0 (dc75b65). What lands here:

  • 1.9.0 — the chat z-order fix from vercel/geistdocs#138 (Ask AI panel now z-45, below the search command menu). Closes out the last piece of Chris's Slack feedback with no local workaround.
  • 1.9.0 — Turborepo joined the default OSS products dropdown; added it to our navbarOssProducts override too (which still drops Workflow itself).
  • 1.11.0 — navbar now renders a GitHub icon link when github is configured, restoring parity with the pre-migration navbar's GitHub button (verified it renders, incl. the mobile menu entry).
  • 1.10.0 — createChatRoute gained an optional model option; we keep the default (openai/gpt-4.1-mini), no change needed.

Verified: docs build ✅, sitemap-guard ✅, next start spot checks (.md URL + Accept negotiation, /llms.txt, AutoCards markdown expansion, versioned edit links, navbar GitHub link) ✅

@socket-security

socket-security Bot commented Jul 10, 2026 •
edited
Loading

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security		 Vulnerability Quality Maintenance License
Addednpm/​next@​16.2.651100919970
Addednpm/​@​vercel/​geistdocs@​1.11.0771007499100
Addednpm/​hono@​4.12.28991009796100

View full report

@molebox

molebox commented Jul 13, 2026

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Done. Merged main (12 commits ahead) into migrate-docs in e16a58c. The only conflict was a single line in pnpm-lock.yaml (a vite version string: 7.3.2 vs 7.3.6) — resolved by taking the newer version from main in the follow-up commit.

karthikscale3
karthikscale3 approved these changes Jul 13, 2026
View reviewed changes

@karthikscale3 karthikscale3 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thank you!

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

No backport to stable for aa93cc5 (AI decision).

This commit is a wholesale re-architecture of the docs/ app (outside docs/content/) onto the new @vercel/geistdocs package — that portion of the docs app is not maintained on stable. The pieces touching maintained paths are tightly coupled to this migration and cannot stand alone: the docs/content/*.mdx changes only add <CopyPrompt> components that rely on the new geistdocs MDX runtime introduced here, and the packages/docs-typecheck/sitemap-guard.test.ts rewrite specifically asserts the geistdocs-based createDocsMarkdownRoute structure that doesn't exist on stable, so it would fail there.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

aa93cc5e690649de17b3f28c9ca1c88be0eb23d8

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@vercel vercel[bot] vercel[bot] left review comments
Copilot code review Copilot Copilot left review comments
@VaguelySerious VaguelySerious VaguelySerious approved these changes
@christopherkindl christopherkindl christopherkindl approved these changes
@karthikscale3 karthikscale3 karthikscale3 approved these changes
@ijjk ijjk Awaiting requested review from ijjk ijjk is a code owner
@pranaygp pranaygp Awaiting requested review from pranaygp

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

7 participants

@molebox @pranaygp @karthikscale3 @VaguelySerious @christopherkindl