refactor(docs): migrate chat-sdk.dev to @vercel/geistdocs#686
Open
molebox wants to merge 1 commit into
Open
Conversation
Replace the locally-copied geistdocs runtime in apps/docs with the published @vercel/geistdocs package, keeping site-specific content, custom sections, and established public contracts local. Package-backed now: docs page + layouts (createDocsPage, GeistdocsDocsLayout/HomeLayout), navbar/footer/provider, search (createSearchRoute), Ask AI (createChatRoute, AI SDK v6), per-page markdown (createDocsMarkdownRoute), sitemap.md (createSitemapMarkdownRoute, now with an Adapters section), a new /agents.md surface (createAgentsRoute), proxy (createProxy with explicit markdownRoutes for /docs and /adapters), MDX defaults, design tokens/styles, and icon/logo assets. Kept local by design: the curated /llms.txt index and /llms-full.txt corpus (referenced by the published SKILL.md artifacts and tests), the adapters section (README fetching, OG images, JSON-LD, feature matrices, adapters.mdx markdown route), RSS, and the OG image route. Also: removes 13 now-unused dependencies (ai@5, @ai-sdk/react@2, dexie, jotai, cmdk, vaul, mermaid, etc.), slims the local CSS to overrides on top of @vercel/geistdocs/styles.css, and updates the docs-llms integration test to assert on the new proxy shape. Signed-off-by: molebox <rich@vercel.com>
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
christopherkindl
approved these changes
Jul 8, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Migrates
apps/docsfrom locally-copied geistdocs runtime code to the published@vercel/geistdocspackage (1.8.2), following the official migration guide. Net −8,400 lines.Package-backed now
createDocsPage,GeistdocsDocsLayout,GeistdocsHomeLayout(JSON-LD + sr-only markdown hints preserved viarenderTop)navbarOssProducts), footer, provider, search dialog, page actions (edit source, feedback, copy page, Ask AI, open-in-chat, scroll top)/api/search→createSearchRoute,/api/chat→createChatRoute(AI SDK v6; AI Gateway default, optionalGEISTDOCS_CHAT_PROXY_URL)llms.mdx→createDocsMarkdownRoute,sitemap.md→createSitemapMarkdownRoute(now includes an Adapters section)/agents.mdviacreateAgentsRoute, backed by a newagentreadiness configproxy.ts→createProxywith explicitmarkdownRoutesfor/docs→llms.mdxand/adapters→adapters.mdx(adds AI-agent UA rewrites)@vercel/geistdocs/styles.css+ slim local overrides (shadcn tokens for remainingcomponents/ui, body tint, prose inline code,#nd-*tweaks); code blocks now use the geist Shiki theme@vercel/geistdocs/assets/*; feedback via the package action (same geistdocs.com endpoint +siteId)Kept local by design
/llms.txtindex +/llms-full.txtcorpus — the publishedAGENTS.md/SKILL.md artifacts and integration tests reference this exact contractadapters.mdxmarkdown route) — now rendered inside the package docs layout/.well-known/mcp.json: no MCP servers configured, and the proxy matcher must keep excluding.well-knownfor the served agent-skills filesCleanup
components/geistdocs/*chrome,components/ai-elements/*, chat hooks/persistence, feedback server actions, unused shadcn primitives, geistcn logo/icon fallbacks covered by package assetsai@5,@ai-sdk/react@2,dexie,jotai,cmdk,vaul,mermaid,nanoid,react-player,use-stick-to-bottom,@orama/tokenizers,dexie-react-hooks,next-themes)docs-llms.test.tsproxy assertions to thecreateProxymarkdown-route shapeBehavior changes to be aware of
/sitemap.md,/llms.txt,/agents.md)Test plan
pnpm validategreen (knip + check + typecheck + test + build)next build && next start:/,/docs,/adapters,/agents.md,/llms.txt,/llms-full.txt,/sitemap.md, page-level.mdURLs for both docs and adapters,Accept: text/markdownnegotiation, search API, JSON-LD, sr-only markdown hints, edit-source URLs (apps/docs/content/docs/{path}), OSS navbar, page actionsrm -rf apps/docs/.nextfixes it)Checklist
git commit -s)pnpm validatepasses