@vercel/geistdocs 1.3.0-canary.5af98bc → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/dist/assets/icons/icon-arrow-up-right-small.d.ts +8 -0
  2. package/dist/assets/icons/icon-arrow-up-right-small.d.ts.map +1 -0
  3. package/dist/assets/icons/icon-arrow-up-right-small.js +4 -0
  4. package/dist/assets/icons/icon-arrow-up-right.d.ts +5 -0
  5. package/dist/assets/icons/icon-arrow-up-right.d.ts.map +1 -0
  6. package/dist/assets/icons/icon-arrow-up-right.js +4 -0
  7. package/dist/assets/icons/icon-check.d.ts +5 -0
  8. package/dist/assets/icons/icon-check.d.ts.map +1 -0
  9. package/dist/assets/icons/icon-check.js +4 -0
  10. package/dist/assets/icons/icon-chevron-down-small.d.ts +8 -0
  11. package/dist/assets/icons/icon-chevron-down-small.d.ts.map +1 -0
  12. package/dist/assets/icons/icon-chevron-down-small.js +7 -0
  13. package/dist/assets/icons/icon-chevron-right.d.ts +5 -0
  14. package/dist/assets/icons/icon-chevron-right.d.ts.map +1 -0
  15. package/dist/assets/icons/icon-chevron-right.js +4 -0
  16. package/dist/assets/icons/icon-copy.d.ts +5 -0
  17. package/dist/assets/icons/icon-copy.d.ts.map +1 -0
  18. package/dist/assets/icons/icon-copy.js +4 -0
  19. package/dist/assets/icons/icon-file-text.d.ts +5 -0
  20. package/dist/assets/icons/icon-file-text.d.ts.map +1 -0
  21. package/dist/assets/icons/icon-file-text.js +4 -0
  22. package/dist/assets/icons/icon-menu-alt.d.ts +5 -0
  23. package/dist/assets/icons/icon-menu-alt.d.ts.map +1 -0
  24. package/dist/assets/icons/icon-menu-alt.js +4 -0
  25. package/dist/assets/icons/icon-slash-forward.d.ts +8 -0
  26. package/dist/assets/icons/icon-slash-forward.d.ts.map +1 -0
  27. package/dist/assets/icons/icon-slash-forward.js +4 -0
  28. package/dist/assets/icons/index.d.ts +10 -0
  29. package/dist/assets/icons/index.d.ts.map +1 -0
  30. package/{template/components/geistcn-fallbacks/geistcn-assets/icons/index.tsx → dist/assets/icons/index.js} +0 -1
  31. package/dist/assets/logos/index.d.ts +15 -0
  32. package/dist/assets/logos/index.d.ts.map +1 -0
  33. package/{template/components/geistcn-fallbacks/geistcn-assets/logos/index.tsx → dist/assets/logos/index.js} +2 -1
  34. package/dist/assets/logos/logo-ai-elements.d.ts +8 -0
  35. package/dist/assets/logos/logo-ai-elements.d.ts.map +1 -0
  36. package/dist/assets/logos/logo-ai-elements.js +8 -0
  37. package/dist/assets/logos/logo-ai-sdk.d.ts +8 -0
  38. package/dist/assets/logos/logo-ai-sdk.d.ts.map +1 -0
  39. package/dist/assets/logos/logo-ai-sdk.js +8 -0
  40. package/dist/assets/logos/logo-chat-sdk.d.ts +8 -0
  41. package/dist/assets/logos/logo-chat-sdk.d.ts.map +1 -0
  42. package/dist/assets/logos/logo-chat-sdk.js +8 -0
  43. package/dist/assets/logos/logo-flags-sdk.d.ts +8 -0
  44. package/dist/assets/logos/logo-flags-sdk.d.ts.map +1 -0
  45. package/dist/assets/logos/logo-flags-sdk.js +8 -0
  46. package/dist/assets/logos/logo-icon-vercel.d.ts +9 -0
  47. package/dist/assets/logos/logo-icon-vercel.d.ts.map +1 -0
  48. package/dist/assets/logos/logo-icon-vercel.js +8 -0
  49. package/dist/assets/logos/logo-nextjs.d.ts +8 -0
  50. package/dist/assets/logos/logo-nextjs.d.ts.map +1 -0
  51. package/dist/assets/logos/logo-nextjs.js +7 -0
  52. package/dist/assets/logos/logo-streamdown.d.ts +8 -0
  53. package/dist/assets/logos/logo-streamdown.d.ts.map +1 -0
  54. package/dist/assets/logos/logo-streamdown.js +8 -0
  55. package/dist/assets/logos/logo-svelte-kit.d.ts +8 -0
  56. package/dist/assets/logos/logo-svelte-kit.d.ts.map +1 -0
  57. package/dist/assets/logos/logo-svelte-kit.js +7 -0
  58. package/dist/assets/logos/logo-vercel-oss.d.ts +8 -0
  59. package/dist/assets/logos/logo-vercel-oss.d.ts.map +1 -0
  60. package/dist/assets/logos/logo-vercel-oss.js +7 -0
  61. package/dist/assets/logos/logo-workflow-sdk.d.ts +8 -0
  62. package/dist/assets/logos/logo-workflow-sdk.d.ts.map +1 -0
  63. package/dist/assets/logos/logo-workflow-sdk.js +8 -0
  64. package/dist/cli/index.js +1 -1
  65. package/dist/components/button-group.d.ts +2 -0
  66. package/dist/components/button-group.d.ts.map +1 -0
  67. package/dist/components/button-group.js +2 -0
  68. package/dist/components/button.d.ts +2 -0
  69. package/dist/components/button.d.ts.map +1 -0
  70. package/dist/components/button.js +2 -0
  71. package/dist/components/card.d.ts +2 -0
  72. package/dist/components/card.d.ts.map +1 -0
  73. package/dist/components/card.js +2 -0
  74. package/dist/components/code-block-tabs.js +3 -3
  75. package/dist/components/code-block.js +3 -3
  76. package/dist/components/collapsible.d.ts +2 -0
  77. package/dist/components/collapsible.d.ts.map +1 -0
  78. package/dist/components/collapsible.js +3 -0
  79. package/dist/components/copy-prompt.js +3 -3
  80. package/dist/components/dialog.d.ts +13 -0
  81. package/dist/components/dialog.d.ts.map +1 -0
  82. package/dist/components/dialog.js +35 -0
  83. package/dist/components/drawer.d.ts +2 -0
  84. package/dist/components/drawer.d.ts.map +1 -0
  85. package/dist/components/drawer.js +3 -0
  86. package/dist/components/dropdown-menu.d.ts +2 -0
  87. package/dist/components/dropdown-menu.d.ts.map +1 -0
  88. package/dist/components/dropdown-menu.js +3 -0
  89. package/dist/components/input-group.d.ts +2 -0
  90. package/dist/components/input-group.d.ts.map +1 -0
  91. package/dist/components/input-group.js +3 -0
  92. package/dist/components/input.d.ts +2 -0
  93. package/dist/components/input.d.ts.map +1 -0
  94. package/dist/components/input.js +2 -0
  95. package/dist/components/kbd.d.ts +2 -0
  96. package/dist/components/kbd.d.ts.map +1 -0
  97. package/dist/components/kbd.js +2 -0
  98. package/dist/components/navigation-menu.d.ts +2 -0
  99. package/dist/components/navigation-menu.d.ts.map +1 -0
  100. package/dist/components/navigation-menu.js +3 -0
  101. package/dist/components/popover.d.ts +2 -0
  102. package/dist/components/popover.d.ts.map +1 -0
  103. package/dist/components/popover.js +3 -0
  104. package/dist/components/scroll-area.d.ts +2 -0
  105. package/dist/components/scroll-area.d.ts.map +1 -0
  106. package/dist/components/scroll-area.js +3 -0
  107. package/dist/components/separator.d.ts +2 -0
  108. package/dist/components/separator.d.ts.map +1 -0
  109. package/dist/components/separator.js +3 -0
  110. package/dist/components/sheet.d.ts +2 -0
  111. package/dist/components/sheet.d.ts.map +1 -0
  112. package/dist/components/sheet.js +3 -0
  113. package/dist/components/sonner.d.ts +2 -0
  114. package/dist/components/sonner.d.ts.map +1 -0
  115. package/dist/components/sonner.js +3 -0
  116. package/dist/components/spinner.d.ts +2 -0
  117. package/dist/components/spinner.d.ts.map +1 -0
  118. package/dist/components/spinner.js +2 -0
  119. package/dist/components/textarea.d.ts +2 -0
  120. package/dist/components/textarea.d.ts.map +1 -0
  121. package/dist/components/textarea.js +2 -0
  122. package/dist/components/tooltip.d.ts +2 -0
  123. package/dist/components/tooltip.d.ts.map +1 -0
  124. package/dist/components/tooltip.js +3 -0
  125. package/dist/config.d.ts +66 -1
  126. package/dist/config.d.ts.map +1 -1
  127. package/dist/controls.js +4 -4
  128. package/dist/footer.d.ts +8 -0
  129. package/dist/footer.d.ts.map +1 -0
  130. package/dist/footer.js +6 -0
  131. package/dist/home-layout.d.ts +11 -0
  132. package/dist/home-layout.d.ts.map +1 -0
  133. package/dist/home-layout.js +31 -0
  134. package/dist/internal/chat/conversation.js +1 -1
  135. package/dist/internal/chat/message.js +1 -1
  136. package/dist/internal/chat/prompt-input.js +1 -1
  137. package/dist/internal/chat/shell.d.ts.map +1 -1
  138. package/dist/internal/chat/shell.js +6 -5
  139. package/dist/internal/chat/sources.js +1 -1
  140. package/dist/internal/config-context.d.ts +10 -0
  141. package/dist/internal/config-context.d.ts.map +1 -0
  142. package/dist/internal/config-context.js +15 -0
  143. package/dist/internal/footer/github-button.d.ts +7 -0
  144. package/dist/internal/footer/github-button.d.ts.map +1 -0
  145. package/dist/internal/footer/github-button.js +10 -0
  146. package/dist/internal/footer/rss-button.d.ts +2 -0
  147. package/dist/internal/footer/rss-button.d.ts.map +1 -0
  148. package/dist/internal/footer/rss-button.js +4 -0
  149. package/dist/internal/localized-link.d.ts +8 -0
  150. package/dist/internal/localized-link.d.ts.map +1 -0
  151. package/dist/internal/localized-link.js +13 -0
  152. package/dist/internal/navbar/desktop-menu.d.ts +10 -0
  153. package/dist/internal/navbar/desktop-menu.d.ts.map +1 -0
  154. package/dist/internal/navbar/desktop-menu.js +11 -0
  155. package/dist/internal/navbar/mobile-menu.d.ts +7 -0
  156. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -0
  157. package/dist/internal/navbar/mobile-menu.js +44 -0
  158. package/dist/internal/navbar/navbar-logo.d.ts +16 -0
  159. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -0
  160. package/dist/internal/navbar/navbar-logo.js +30 -0
  161. package/dist/internal/page-actions-client.d.ts.map +1 -1
  162. package/dist/internal/page-actions-client.js +17 -6
  163. package/dist/internal/page-visibility.d.ts +18 -0
  164. package/dist/internal/page-visibility.d.ts.map +1 -0
  165. package/dist/internal/page-visibility.js +24 -0
  166. package/dist/internal/provider-client.d.ts +1 -1
  167. package/dist/internal/provider-client.d.ts.map +1 -1
  168. package/dist/internal/provider-client.js +2 -1
  169. package/dist/internal/sidebar.d.ts +4 -1
  170. package/dist/internal/sidebar.d.ts.map +1 -1
  171. package/dist/internal/sidebar.js +4 -4
  172. package/dist/internal/ui/button-group.js +2 -2
  173. package/dist/internal/ui/button.d.ts +1 -1
  174. package/dist/internal/ui/button.d.ts.map +1 -1
  175. package/dist/internal/ui/button.js +7 -7
  176. package/dist/internal/ui/card.js +1 -1
  177. package/dist/internal/ui/drawer.js +1 -1
  178. package/dist/internal/ui/dropdown-menu.js +7 -7
  179. package/dist/internal/ui/input-group.js +2 -2
  180. package/dist/internal/ui/input.js +1 -1
  181. package/dist/internal/ui/kbd.js +1 -1
  182. package/dist/internal/ui/navigation-menu.d.ts +17 -0
  183. package/dist/internal/ui/navigation-menu.d.ts.map +1 -0
  184. package/dist/internal/ui/navigation-menu.js +38 -0
  185. package/dist/internal/ui/popover.js +1 -1
  186. package/dist/internal/ui/scroll-area.js +2 -2
  187. package/dist/internal/ui/separator.js +1 -1
  188. package/dist/internal/ui/sheet.js +4 -4
  189. package/dist/internal/ui/sonner.js +3 -3
  190. package/dist/internal/ui/textarea.js +1 -1
  191. package/dist/internal/ui/tooltip.js +1 -1
  192. package/dist/layout.d.ts +2 -1
  193. package/dist/layout.d.ts.map +1 -1
  194. package/dist/layout.js +2 -2
  195. package/dist/mdx.d.ts +55 -24
  196. package/dist/mdx.d.ts.map +1 -1
  197. package/dist/mdx.js +7 -46
  198. package/dist/mobile-docs-bar.d.ts +7 -0
  199. package/dist/mobile-docs-bar.d.ts.map +1 -0
  200. package/dist/mobile-docs-bar.js +13 -0
  201. package/dist/navbar.d.ts +7 -0
  202. package/dist/navbar.d.ts.map +1 -0
  203. package/dist/navbar.js +10 -0
  204. package/dist/pages/docs.d.ts +33 -5
  205. package/dist/pages/docs.d.ts.map +1 -1
  206. package/dist/pages/docs.js +46 -17
  207. package/dist/proxy.d.ts +24 -8
  208. package/dist/proxy.d.ts.map +1 -1
  209. package/dist/proxy.js +116 -36
  210. package/dist/routes/agents.d.ts +21 -0
  211. package/dist/routes/agents.d.ts.map +1 -0
  212. package/dist/routes/agents.js +201 -0
  213. package/dist/routes/chat.d.ts +11 -5
  214. package/dist/routes/chat.d.ts.map +1 -1
  215. package/dist/routes/chat.js +386 -65
  216. package/dist/routes/llms.d.ts +29 -10
  217. package/dist/routes/llms.d.ts.map +1 -1
  218. package/dist/routes/llms.js +80 -9
  219. package/dist/routes/search.d.ts +8 -5
  220. package/dist/routes/search.d.ts.map +1 -1
  221. package/dist/routes/search.js +52 -4
  222. package/dist/routes/sitemap.d.ts +15 -3
  223. package/dist/routes/sitemap.d.ts.map +1 -1
  224. package/dist/routes/sitemap.js +32 -6
  225. package/dist/shiki-theme.d.ts +20 -0
  226. package/dist/shiki-theme.d.ts.map +1 -0
  227. package/dist/shiki-theme.js +110 -0
  228. package/dist/source-config.d.ts +68 -0
  229. package/dist/source-config.d.ts.map +1 -0
  230. package/dist/source-config.js +161 -0
  231. package/dist/source.d.ts +155 -4
  232. package/dist/source.d.ts.map +1 -1
  233. package/dist/source.js +73 -3
  234. package/dist/versions.d.ts +45 -0
  235. package/dist/versions.d.ts.map +1 -0
  236. package/dist/versions.js +79 -0
  237. package/package.json +134 -9
  238. package/source-config.js +174 -0
  239. package/styles.css +465 -102
  240. package/template/AGENTS.md +95 -0
  241. package/template/app/[lang]/(home)/components/centered-section.tsx +1 -3
  242. package/template/app/[lang]/(home)/components/hero.tsx +2 -2
  243. package/template/app/[lang]/(home)/components/one-two-section.tsx +1 -3
  244. package/template/app/[lang]/(home)/components/templates.tsx +3 -5
  245. package/template/app/[lang]/(home)/components/text-grid-section.tsx +1 -1
  246. package/template/app/[lang]/(home)/layout.tsx +4 -3
  247. package/template/app/[lang]/(home)/page.tsx +2 -2
  248. package/template/app/[lang]/agents.md/route.ts +6 -0
  249. package/template/app/[lang]/docs/[[...slug]]/page.tsx +4 -1
  250. package/template/app/[lang]/layout.tsx +6 -6
  251. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +1 -1
  252. package/template/app/[lang]/llms.txt/route.ts +1 -1
  253. package/template/app/[lang]/sitemap.md/route.ts +2 -2
  254. package/template/app/api/chat/route.ts +12 -1
  255. package/template/app/api/search/route.ts +2 -2
  256. package/template/app/styles/geistdocs.css +150 -109
  257. package/template/components/ui/badge.tsx +5 -5
  258. package/template/components/ui/button.tsx +7 -7
  259. package/template/components/ui/command-prompt.tsx +2 -2
  260. package/template/content/docs/agent-readiness.mdx +103 -0
  261. package/template/content/docs/ask-ai.mdx +57 -5
  262. package/template/content/docs/configuration.cn.mdx +47 -7
  263. package/template/content/docs/configuration.mdx +158 -1
  264. package/template/content/docs/deployment.mdx +11 -0
  265. package/template/content/docs/edit-on-github.mdx +2 -2
  266. package/template/content/docs/env.mdx +36 -5
  267. package/template/content/docs/feedback.mdx +2 -2
  268. package/template/content/docs/getting-started.cn.mdx +2 -2
  269. package/template/content/docs/getting-started.mdx +8 -1
  270. package/template/content/docs/index.cn.mdx +36 -33
  271. package/template/content/docs/index.mdx +12 -0
  272. package/template/content/docs/internationalization.mdx +1 -1
  273. package/template/content/docs/llms-txt.cn.mdx +24 -2
  274. package/template/content/docs/llms-txt.mdx +44 -12
  275. package/template/content/docs/md.cn.mdx +12 -15
  276. package/template/content/docs/md.mdx +26 -16
  277. package/template/content/docs/meta.json +4 -0
  278. package/template/content/docs/migration.mdx +364 -0
  279. package/template/content/docs/open-in-chat.mdx +8 -10
  280. package/template/content/docs/provider.cn.mdx +6 -5
  281. package/template/content/docs/provider.mdx +9 -8
  282. package/template/content/docs/proxy.cn.mdx +96 -0
  283. package/template/content/docs/proxy.mdx +178 -0
  284. package/template/content/docs/rss.mdx +2 -2
  285. package/template/content/docs/syntax.mdx +1 -1
  286. package/template/content/docs/theme-aware-image.mdx +1 -1
  287. package/template/content/docs/versioned-docs.cn.mdx +117 -0
  288. package/template/content/docs/versioned-docs.mdx +228 -0
  289. package/template/geistdocs.tsx +26 -0
  290. package/template/lib/geistdocs/config.tsx +3 -0
  291. package/template/package.json +5 -5
  292. package/template/proxy.ts +2 -1
  293. package/template/source.config.ts +8 -47
  294. package/template/app/actions/feedback/emotions.ts +0 -18
  295. package/template/app/actions/feedback/index.ts +0 -45
  296. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right-small.tsx +0 -35
  297. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right.tsx +0 -27
  298. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-check.tsx +0 -27
  299. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-down-small.tsx +0 -30
  300. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-right.tsx +0 -27
  301. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy.tsx +0 -27
  302. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-file-text.tsx +0 -25
  303. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-menu-alt.tsx +0 -27
  304. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-slash-forward.tsx +0 -36
  305. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-elements.tsx +0 -29
  306. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-sdk.tsx +0 -38
  307. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-chat-sdk.tsx +0 -42
  308. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-flags-sdk.tsx +0 -42
  309. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-icon-vercel.tsx +0 -31
  310. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-streamdown.tsx +0 -29
  311. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-vercel-oss.tsx +0 -24
  312. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-workflow-sdk.tsx +0 -73
  313. package/template/components/geistdocs/callout.tsx +0 -40
  314. package/template/components/geistdocs/chat.tsx +0 -24
  315. package/template/components/geistdocs/code-block-tabs.tsx +0 -61
  316. package/template/components/geistdocs/code-block.tsx +0 -134
  317. package/template/components/geistdocs/copy-page.tsx +0 -27
  318. package/template/components/geistdocs/desktop-menu.tsx +0 -52
  319. package/template/components/geistdocs/docs-page.tsx +0 -35
  320. package/template/components/geistdocs/edit-source.tsx +0 -30
  321. package/template/components/geistdocs/feedback.tsx +0 -139
  322. package/template/components/geistdocs/footer.tsx +0 -30
  323. package/template/components/geistdocs/github-button.tsx +0 -19
  324. package/template/components/geistdocs/home-layout.tsx +0 -46
  325. package/template/components/geistdocs/icons.tsx +0 -13
  326. package/template/components/geistdocs/installer.tsx +0 -58
  327. package/template/components/geistdocs/language-selector.tsx +0 -3
  328. package/template/components/geistdocs/mermaid.tsx +0 -68
  329. package/template/components/geistdocs/mobile-docs-bar.tsx +0 -77
  330. package/template/components/geistdocs/mobile-menu.tsx +0 -150
  331. package/template/components/geistdocs/navbar-logo.tsx +0 -124
  332. package/template/components/geistdocs/navbar.tsx +0 -22
  333. package/template/components/geistdocs/rss-button.tsx +0 -10
  334. package/template/components/geistdocs/scroll-top.tsx +0 -21
  335. package/template/components/geistdocs/search.tsx +0 -17
  336. package/template/components/geistdocs/sidebar.tsx +0 -128
  337. package/template/components/geistdocs/theme-aware-image.tsx +0 -22
  338. package/template/components/geistdocs/theme-toggle.tsx +0 -3
  339. package/template/components/geistdocs/video.tsx +0 -16
  340. package/template/components/ui/button-group.tsx +0 -83
  341. package/template/components/ui/card.tsx +0 -92
  342. package/template/components/ui/collapsible.tsx +0 -33
  343. package/template/components/ui/command.tsx +0 -184
  344. package/template/components/ui/dialog.tsx +0 -143
  345. package/template/components/ui/drawer.tsx +0 -135
  346. package/template/components/ui/dropdown-menu.tsx +0 -257
  347. package/template/components/ui/hover-card.tsx +0 -44
  348. package/template/components/ui/input-group.tsx +0 -170
  349. package/template/components/ui/input.tsx +0 -21
  350. package/template/components/ui/kbd.tsx +0 -28
  351. package/template/components/ui/navigation-menu.tsx +0 -192
  352. package/template/components/ui/popover.tsx +0 -48
  353. package/template/components/ui/scroll-area.tsx +0 -58
  354. package/template/components/ui/select.tsx +0 -187
  355. package/template/components/ui/separator.tsx +0 -28
  356. package/template/components/ui/sheet.tsx +0 -139
  357. package/template/components/ui/sonner.tsx +0 -40
  358. package/template/components/ui/spinner.tsx +0 -16
  359. package/template/components/ui/textarea.tsx +0 -18
  360. package/template/components/ui/tooltip.tsx +0 -61
  361. package/template/hooks/geistdocs/use-sidebar.ts +0 -13
  362. package/template/hooks/use-mobile.ts +0 -19
@@ -9,46 +9,23 @@
9
9
  @custom-variant dark (&:is(.dark *));
10
10
 
11
11
  @theme inline {
12
- /* Geist border radii */
12
+ /* geist theme tokens */
13
+
13
14
  --radius-xs: 0.125rem; /* 2px */
14
15
  --radius-sm: 0.25rem; /* 4px */
15
16
  --radius-md: 0.375rem; /* 6px */
16
17
  --radius-lg: 0.5rem; /* 8px */
17
18
  --radius-xl: 0.75rem; /* 12px */
18
19
  --radius-2xl: 1rem; /* 16px */
19
- --color-background: var(--background);
20
- --color-foreground: var(--foreground);
21
- --color-card: var(--card);
22
- --color-card-foreground: var(--card-foreground);
23
- --color-popover: var(--popover);
24
- --color-popover-foreground: var(--popover-foreground);
25
- --color-primary: var(--ds-gray-1000);
26
- --color-primary-foreground: var(--ds-background-100);
27
- --color-secondary: var(--secondary);
28
- --color-secondary-foreground: var(--secondary-foreground);
29
- --color-muted: var(--muted);
30
- --color-muted-foreground: var(--muted-foreground);
31
- --color-accent: var(--accent);
32
- --color-accent-foreground: var(--accent-foreground);
33
- --color-destructive: var(--destructive);
34
- --color-border: var(--border);
35
- --color-input: var(--input);
36
- --color-ring: var(--ring);
37
- --color-chart-1: var(--chart-1);
38
- --color-chart-2: var(--chart-2);
39
- --color-chart-3: var(--chart-3);
40
- --color-chart-4: var(--chart-4);
41
- --color-chart-5: var(--chart-5);
42
- --color-sidebar: var(--sidebar);
43
- --color-sidebar-foreground: var(--sidebar-foreground);
44
- --color-sidebar-primary: var(--sidebar-primary);
45
- --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
46
- --color-sidebar-accent: var(--sidebar-accent);
47
- --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
48
- --color-sidebar-border: var(--sidebar-border);
49
- --color-sidebar-ring: var(--sidebar-ring);
50
-
51
- /* Geist colors */
20
+
21
+ --shadow-2xs: var(--ds-shadow-2xs);
22
+ --shadow-xs: var(--ds-shadow-xs);
23
+ --shadow-sm: var(--ds-shadow-small);
24
+ --shadow-md: var(--ds-shadow-medium);
25
+ --shadow-lg: var(--ds-shadow-large);
26
+ --shadow-xl: var(--ds-shadow-xl);
27
+ --shadow-2xl: var(--ds-shadow-2xl);
28
+
52
29
  --color-background-100: var(--ds-background-100);
53
30
  --color-background-200: var(--ds-background-200);
54
31
 
@@ -154,7 +131,6 @@
154
131
  }
155
132
 
156
133
  :root {
157
- /* Geist colors */
158
134
  --ds-black: oklch(0 0 0);
159
135
  --ds-white: oklch(1 0 0);
160
136
  --ds-background-100: oklch(1 0 0);
@@ -251,48 +227,59 @@
251
227
  --ds-pink-900: oklch(53.5% 0.2058 2.84);
252
228
  --ds-pink-1000: oklch(26% 0.0977 359);
253
229
  --ds-shadow-background-border: 0 0 0 1px var(--ds-background-200);
230
+
254
231
  --ds-shadow-border-base: 0 0 0 1px rgba(0, 0, 0, 0.08);
255
- --ds-shadow-menu:
256
- var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
257
- 0px 4px 8px -4px rgba(0, 0, 0, 0.04),
258
- 0px 16px 24px -8px rgba(0, 0, 0, 0.06), var(--ds-shadow-background-border);
232
+ --ds-shadow-border-inset: inset 0 0 0 1px rgba(0, 0, 0, 0.08);
233
+
234
+ --ds-shadow-border:
235
+ var(--ds-shadow-border-base), var(--ds-shadow-background-border);
236
+
237
+ --ds-shadow-2xs: 0px 1px 1px rgba(0, 0, 0, 0.02);
238
+ --ds-shadow-xs: 0px 1px 2px rgba(0, 0, 0, 0.04);
259
239
  --ds-shadow-small: 0px 2px 2px rgba(0, 0, 0, 0.04);
260
240
  --ds-shadow-border-small:
261
241
  var(--ds-shadow-border-base), var(--ds-shadow-small),
262
242
  var(--ds-shadow-background-border);
263
243
 
244
+ --ds-shadow-medium:
245
+ 0px 2px 2px rgba(0, 0, 0, 0.04), 0px 8px 8px -8px rgba(0, 0, 0, 0.04);
246
+ --ds-shadow-border-medium:
247
+ var(--ds-shadow-border-base), var(--ds-shadow-medium),
248
+ var(--ds-shadow-background-border);
249
+
250
+ --ds-shadow-large:
251
+ 0px 2px 2px rgba(0, 0, 0, 0.04), 0px 8px 16px -4px rgba(0, 0, 0, 0.04);
252
+ --ds-shadow-border-large:
253
+ var(--ds-shadow-border-base), var(--ds-shadow-large),
254
+ var(--ds-shadow-background-border);
255
+
256
+ --ds-shadow-tooltip:
257
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
258
+ 0px 4px 8px rgba(0, 0, 0, 0.04), var(--ds-shadow-background-border);
259
+
260
+ --ds-shadow-xl:
261
+ 0px 1px 1px rgba(0, 0, 0, 0.02), 0px 4px 8px -4px rgba(0, 0, 0, 0.04);
262
+
263
+ --ds-shadow-2xl:
264
+ 0px 1px 1px rgba(0, 0, 0, 0.02), 0px 4px 8px -4px rgba(0, 0, 0, 0.04),
265
+ 0px 16px 24px -8px rgba(0, 0, 0, 0.06);
266
+
267
+ --ds-shadow-menu:
268
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
269
+ 0px 4px 8px -4px rgba(0, 0, 0, 0.04),
270
+ 0px 16px 24px -8px rgba(0, 0, 0, 0.06), var(--ds-shadow-background-border);
271
+
272
+ --ds-shadow-modal:
273
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
274
+ 0px 8px 16px -4px rgba(0, 0, 0, 0.04),
275
+ 0px 24px 32px -8px rgba(0, 0, 0, 0.06), var(--ds-shadow-background-border);
276
+
277
+ --ds-shadow-fullscreen:
278
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
279
+ 0px 8px 16px -4px rgba(0, 0, 0, 0.04),
280
+ 0px 24px 32px -8px rgba(0, 0, 0, 0.06), var(--ds-shadow-background-border);
281
+
264
282
  --radius: 0.625rem;
265
- --background: oklch(1 0 0);
266
- --foreground: oklch(0.145 0 0);
267
- --card: oklch(1 0 0);
268
- --card-foreground: oklch(0.145 0 0);
269
- --popover: oklch(1 0 0);
270
- --popover-foreground: oklch(0.145 0 0);
271
- --primary: oklch(57.61% 0.2508 258.23);
272
- --primary-foreground: oklch(1 0 0);
273
- --secondary: oklch(0.97 0 0);
274
- --secondary-foreground: oklch(0.205 0 0);
275
- --muted: oklch(0.97 0 0);
276
- --muted-foreground: oklch(0.556 0 0);
277
- --accent: oklch(0.97 0 0);
278
- --accent-foreground: oklch(0.205 0 0);
279
- --destructive: oklch(0.577 0.245 27.325);
280
- --border: oklch(0.922 0 0);
281
- --input: oklch(0.922 0 0);
282
- --ring: oklch(0.708 0 0);
283
- --chart-1: oklch(0.646 0.222 41.116);
284
- --chart-2: oklch(0.6 0.118 184.704);
285
- --chart-3: oklch(0.398 0.07 227.392);
286
- --chart-4: oklch(0.828 0.189 84.429);
287
- --chart-5: oklch(0.769 0.188 70.08);
288
- --sidebar: oklch(0.985 0 0);
289
- --sidebar-foreground: oklch(0.145 0 0);
290
- --sidebar-primary: oklch(0.205 0 0);
291
- --sidebar-primary-foreground: oklch(0.985 0 0);
292
- --sidebar-accent: oklch(0.97 0 0);
293
- --sidebar-accent-foreground: oklch(0.205 0 0);
294
- --sidebar-border: oklch(0.922 0 0);
295
- --sidebar-ring: oklch(0.708 0 0);
296
283
  }
297
284
 
298
285
  .dark {
@@ -390,54 +377,66 @@
390
377
  --ds-pink-900: oklch(69.36% 0.2223 3.91);
391
378
  --ds-pink-1000: oklch(95.74% 0.0326 350.08);
392
379
 
393
- /* Geist shadow utilities */
394
- --ds-shadow-menu: 0 0 0 1px oklch(1 0 0 / 0.1), 0 8px 16px oklch(0 0 0 / 0.4);
395
380
  --ds-shadow-background-border: 0 0 0 1px var(--ds-background-200);
381
+
396
382
  --ds-shadow-border-base: 0 0 0 1px rgba(255, 255, 255, 0.145);
383
+ --ds-shadow-border-inset: inset 0 0 0 1px rgba(255, 255, 255, 0.145);
384
+
385
+ --ds-shadow-border:
386
+ var(--ds-shadow-border-base), var(--ds-shadow-background-border);
387
+
388
+ --ds-shadow-2xs: 0px 1px 1px rgba(0, 0, 0, 0.08);
389
+ --ds-shadow-xs: 0px 1px 2px rgba(0, 0, 0, 0.16);
397
390
  --ds-shadow-small: 0px 1px 2px rgba(0, 0, 0, 0.16);
398
391
  --ds-shadow-border-small:
399
392
  var(--ds-shadow-border-base), var(--ds-shadow-small),
400
393
  var(--ds-shadow-background-border);
401
394
 
402
- --background: oklch(0.145 0 0);
403
- --foreground: oklch(0.985 0 0);
404
- --card: oklch(0.205 0 0);
405
- --card-foreground: oklch(0.985 0 0);
406
- --popover: oklch(0.205 0 0);
407
- --popover-foreground: oklch(0.985 0 0);
408
- --primary: oklch(57.61% 0.2508 258.23);
409
- --primary-foreground: oklch(1 0 0);
410
- --secondary: oklch(0.269 0 0);
411
- --secondary-foreground: oklch(0.985 0 0);
412
- --muted: oklch(0.269 0 0);
413
- --muted-foreground: oklch(0.708 0 0);
414
- --accent: oklch(0.269 0 0);
415
- --accent-foreground: oklch(0.985 0 0);
416
- --destructive: oklch(0.704 0.191 22.216);
417
- --border: oklch(1 0 0 / 10%);
418
- --input: oklch(1 0 0 / 15%);
419
- --ring: oklch(0.556 0 0);
420
- --chart-1: oklch(0.488 0.243 264.376);
421
- --chart-2: oklch(0.696 0.17 162.48);
422
- --chart-3: oklch(0.769 0.188 70.08);
423
- --chart-4: oklch(0.627 0.265 303.9);
424
- --chart-5: oklch(0.645 0.246 16.439);
425
- --sidebar: oklch(0.205 0 0);
426
- --sidebar-foreground: oklch(0.985 0 0);
427
- --sidebar-primary: oklch(0.488 0.243 264.376);
428
- --sidebar-primary-foreground: oklch(0.985 0 0);
429
- --sidebar-accent: oklch(0.269 0 0);
430
- --sidebar-accent-foreground: oklch(0.985 0 0);
431
- --sidebar-border: oklch(1 0 0 / 10%);
432
- --sidebar-ring: oklch(0.556 0 0);
395
+ --ds-shadow-medium:
396
+ 0px 2px 2px rgba(0, 0, 0, 0.16), 0px 8px 8px -8px rgba(0, 0, 0, 0.16);
397
+ --ds-shadow-border-medium:
398
+ var(--ds-shadow-border-base), var(--ds-shadow-medium),
399
+ var(--ds-shadow-background-border);
400
+
401
+ --ds-shadow-large:
402
+ 0px 2px 2px rgba(0, 0, 0, 0.16), 0px 8px 16px -4px rgba(0, 0, 0, 0.16);
403
+ --ds-shadow-border-large:
404
+ var(--ds-shadow-border-base), var(--ds-shadow-large),
405
+ var(--ds-shadow-background-border);
406
+
407
+ --ds-shadow-tooltip:
408
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.08),
409
+ 0px 4px 8px rgba(0, 0, 0, 0.16), var(--ds-shadow-background-border);
410
+
411
+ --ds-shadow-xl:
412
+ 0px 1px 1px rgba(0, 0, 0, 0.08), 0px 4px 8px -4px rgba(0, 0, 0, 0.16);
413
+
414
+ --ds-shadow-2xl:
415
+ 0px 1px 1px rgba(0, 0, 0, 0.08), 0px 4px 8px -4px rgba(0, 0, 0, 0.16),
416
+ 0px 16px 24px -8px rgba(0, 0, 0, 0.24);
417
+
418
+ --ds-shadow-menu:
419
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.08),
420
+ 0px 4px 8px -4px rgba(0, 0, 0, 0.16),
421
+ 0px 16px 24px -8px rgba(0, 0, 0, 0.24), var(--ds-shadow-background-border);
422
+
423
+ --ds-shadow-modal:
424
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.08),
425
+ 0px 8px 16px -4px rgba(0, 0, 0, 0.16),
426
+ 0px 24px 32px -8px rgba(0, 0, 0, 0.24), var(--ds-shadow-background-border);
427
+
428
+ --ds-shadow-fullscreen:
429
+ var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.08),
430
+ 0px 8px 16px -4px rgba(0, 0, 0, 0.16),
431
+ 0px 24px 32px -8px rgba(0, 0, 0, 0.24), var(--ds-shadow-background-border);
433
432
  }
434
433
 
435
434
  @layer base {
436
435
  * {
437
- @apply border-border outline-ring/50;
436
+ @apply border-gray-alpha-400 outline-gray-600/50;
438
437
  }
439
438
  body {
440
- @apply bg-background-200 text-foreground;
439
+ @apply bg-background-200 text-gray-1000;
441
440
  }
442
441
  }
443
442
 
@@ -447,7 +446,7 @@
447
446
  ::before,
448
447
  ::backdrop,
449
448
  ::file-selector-button {
450
- @apply border-border;
449
+ @apply border-gray-alpha-400;
451
450
  }
452
451
  * {
453
452
  @apply min-w-0;
@@ -460,7 +459,7 @@
460
459
  }
461
460
  input::placeholder,
462
461
  textarea::placeholder {
463
- @apply text-muted-foreground;
462
+ @apply text-gray-800;
464
463
  }
465
464
  button:not(:disabled),
466
465
  [role="button"]:not(:disabled) {
@@ -506,7 +505,7 @@
506
505
  .line-numbers code .line::before {
507
506
  content: counter(step);
508
507
  counter-increment: step;
509
- @apply mr-6 inline-block w-6 text-right tabular-nums text-muted-foreground;
508
+ @apply mr-6 inline-block w-6 text-right tabular-nums text-gray-800;
510
509
  }
511
510
  }
512
511
 
@@ -548,7 +547,49 @@
548
547
  @apply text-gray-1000;
549
548
  }
550
549
 
551
- /* Override fumadocs primary color to match design system */
550
+ /* Shiki syntax highlighting palette - matches packages/geist code-block.module.css */
552
551
  :root {
552
+ --shiki-color-text: var(--ds-gray-1000);
553
+ --shiki-color-background: var(--ds-background-100);
554
+ --shiki-token-constant: var(--ds-blue-900);
555
+ --shiki-token-string: var(--ds-green-900);
556
+ --shiki-token-comment: var(--ds-gray-900);
557
+ --shiki-token-keyword: var(--ds-pink-900);
558
+ --shiki-token-parameter: var(--ds-amber-900);
559
+ --shiki-token-function: var(--ds-purple-900);
560
+ --shiki-token-string-expression: var(--ds-green-900);
561
+ --shiki-token-punctuation: var(--ds-gray-1000);
562
+ --shiki-token-link: var(--ds-green-900);
563
+ }
564
+
565
+ /* Override fumadocs tokens to point at the Geist scale */
566
+ :root {
567
+ --color-fd-background: var(--ds-background-100);
568
+ --color-fd-foreground: var(--ds-gray-1000);
569
+ --color-fd-muted: var(--ds-gray-100);
570
+ --color-fd-muted-foreground: var(--ds-gray-800);
571
+ --color-fd-popover: var(--ds-background-100);
572
+ --color-fd-popover-foreground: var(--ds-gray-1000);
573
+ --color-fd-card: var(--ds-background-100);
574
+ --color-fd-card-foreground: var(--ds-gray-1000);
575
+ --color-fd-border: var(--ds-gray-alpha-400);
553
576
  --color-fd-primary: var(--ds-gray-1000);
577
+ --color-fd-primary-foreground: var(--ds-background-100);
578
+ --color-fd-secondary: var(--ds-gray-100);
579
+ --color-fd-secondary-foreground: var(--ds-gray-1000);
580
+ --color-fd-accent: var(--ds-gray-100);
581
+ --color-fd-accent-foreground: var(--ds-gray-1000);
582
+ --color-fd-ring: var(--ds-gray-600);
583
+ --color-fd-error: var(--ds-red-800);
584
+ }
585
+
586
+ /* Match the fumadocs sidebar selector to the Geist scale */
587
+ #nd-sidebar {
588
+ --color-fd-accent: var(--ds-gray-100);
589
+ --color-fd-accent-foreground: var(--ds-gray-1000);
590
+ --color-fd-ring: var(--ds-gray-600);
591
+ --color-fd-primary-foreground: var(--ds-background-200);
592
+ color: var(--ds-gray-1000);
593
+ background-color: var(--ds-background-200);
594
+ border-color: var(--ds-gray-alpha-400);
554
595
  }
@@ -5,18 +5,18 @@ import { cva, type VariantProps } from "class-variance-authority"
5
5
  import { cn } from "@/lib/utils"
6
6
 
7
7
  const badgeVariants = cva(
8
- "inline-flex items-center justify-center rounded-full border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden",
8
+ "inline-flex items-center justify-center rounded-full border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-gray-600 focus-visible:ring-gray-600/50 focus-visible:ring-[3px] aria-invalid:ring-red-800/20 dark:aria-invalid:ring-red-800/40 aria-invalid:border-red-800 transition-[color,box-shadow] overflow-hidden",
9
9
  {
10
10
  variants: {
11
11
  variant: {
12
12
  default:
13
- "border-transparent bg-primary text-primary-foreground [a&]:hover:bg-primary/90",
13
+ "border-transparent bg-gray-1000 text-background-100 [a&]:hover:bg-gray-1000/90",
14
14
  secondary:
15
- "border-transparent bg-gray-300 text-gray-1000 [a&]:hover:bg-gray-300/90",
15
+ "border-transparent bg-gray-alpha-400 text-gray-1000 [a&]:hover:bg-gray-alpha-400/90",
16
16
  destructive:
17
- "border-transparent bg-destructive text-white [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
17
+ "border-transparent bg-red-800 text-white [a&]:hover:bg-red-800/90 focus-visible:ring-red-800/20 dark:focus-visible:ring-red-800/40 dark:bg-red-800/60",
18
18
  outline:
19
- "text-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground",
19
+ "text-gray-1000 [a&]:hover:bg-gray-100 [a&]:hover:text-gray-1000",
20
20
  },
21
21
  },
22
22
  defaultVariants: {
@@ -5,20 +5,20 @@ import { cva, type VariantProps } from "class-variance-authority"
5
5
  import { cn } from "@/lib/utils"
6
6
 
7
7
  const buttonVariants = cva(
8
- "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
8
+ "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-gray-600 focus-visible:ring-gray-600/50 focus-visible:ring-[3px] aria-invalid:ring-red-800/20 dark:aria-invalid:ring-red-800/40 aria-invalid:border-red-800",
9
9
  {
10
10
  variants: {
11
11
  variant: {
12
- default: "bg-primary text-primary-foreground hover:bg-primary/90",
12
+ default: "bg-gray-1000 text-background-100 hover:bg-gray-1000/90",
13
13
  destructive:
14
- "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
14
+ "bg-red-800 text-white hover:bg-red-800/90 focus-visible:ring-red-800/20 dark:focus-visible:ring-red-800/40 dark:bg-red-800/60",
15
15
  outline:
16
- "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
16
+ "border bg-background-100 shadow-xs hover:bg-gray-100 hover:text-gray-1000 dark:bg-gray-alpha-400/30 dark:border-gray-alpha-400 dark:hover:bg-gray-alpha-400/50",
17
17
  secondary:
18
- "bg-secondary text-secondary-foreground hover:bg-secondary/80",
18
+ "bg-gray-100 text-gray-1000 hover:bg-gray-100/80",
19
19
  ghost:
20
- "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
21
- link: "text-primary underline-offset-4 hover:underline",
20
+ "hover:bg-gray-100 hover:text-gray-1000 dark:hover:bg-gray-100/50",
21
+ link: "text-gray-1000 underline-offset-4 hover:underline",
22
22
  },
23
23
  size: {
24
24
  default: "h-9 px-4 py-2 has-[>svg]:px-3",
@@ -14,8 +14,8 @@ import {
14
14
  useRef,
15
15
  useState,
16
16
  } from "react";
17
- import { IconCheck } from "@/components/geistcn-fallbacks/geistcn-assets/icons/icon-check";
18
- import { IconCopy } from "@/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy";
17
+ import { IconCheck } from "@vercel/geistdocs/assets/icons/icon-check";
18
+ import { IconCopy } from "@vercel/geistdocs/assets/icons/icon-copy";
19
19
  import { cn } from "@/lib/utils";
20
20
 
21
21
  type CommandPromptContextValue = {
@@ -0,0 +1,103 @@
1
+ ---
2
+ title: Agent readiness
3
+ description: Expose a concise agents.md file that helps AI agents discover and use your docs site
4
+ type: guide
5
+ summary: Generate /agents.md from Geistdocs config so agents can find docs, Markdown surfaces, API specs, and MCP endpoints.
6
+ related:
7
+ - /docs/llms-txt
8
+ - /docs/md
9
+ - /docs/proxy
10
+ ---
11
+
12
+ Geistdocs can generate `/agents.md`, a concise Markdown file that tells AI agents what your product is, where your docs live, and which machine-readable integration surfaces are available.
13
+
14
+ <CopyPrompt text="Review this Geistdocs site's /agents.md file. Check whether it lists the product description, documentation links, llms.txt, sitemap.md, OpenAPI specs, and MCP servers accurately.">
15
+ Review this Geistdocs site's `/agents.md` file. Check whether it lists the product description, documentation links, `llms.txt`, `sitemap.md`, OpenAPI specs, and MCP servers accurately.
16
+ </CopyPrompt>
17
+
18
+ ## What it provides
19
+
20
+ The generated `/agents.md` file gives agents a stable starting point before they crawl the rest of your documentation.
21
+
22
+ It can include:
23
+
24
+ - Product name, description, category, audience, and use cases
25
+ - Human-readable docs entry points
26
+ - `/llms.txt` for full documentation context
27
+ - `/sitemap.md` for semantic navigation
28
+ - Page-level Markdown guidance for `.md` and `.mdx` URLs
29
+ - OpenAPI, authentication, scopes, rate limit, and error docs when configured
30
+ - MCP manifests and server URLs when configured
31
+ - Additional links and agent instructions
32
+
33
+ ## Add the route
34
+
35
+ Generated projects include a thin App Router adapter:
36
+
37
+ ```ts title="app/[lang]/agents.md/route.ts"
38
+ import { createAgentsRoute } from "@vercel/geistdocs/routes/agents";
39
+ import { config } from "@/lib/geistdocs/config";
40
+
41
+ export const { GET, generateStaticParams, revalidate } = createAgentsRoute({
42
+ config,
43
+ });
44
+ ```
45
+
46
+ Because the route is under `[lang]`, the Geistdocs proxy can serve `/agents.md` through the default language route.
47
+
48
+ ## Configure agent metadata
49
+
50
+ Add agent-readiness metadata in `geistdocs.tsx`, then pass it through `defineConfig` in `lib/geistdocs/config.tsx`.
51
+
52
+ ```tsx title="geistdocs.tsx"
53
+ import type { GeistdocsAgentReadinessConfig } from "@vercel/geistdocs/config";
54
+
55
+ export const agent = {
56
+ product: {
57
+ name: "My Product",
58
+ description: "My Product helps teams build and deploy applications.",
59
+ category: "Developer tools",
60
+ audience: ["Frontend developers", "Platform teams"],
61
+ useCases: ["Deploy applications", "Manage domains", "Inspect logs"],
62
+ },
63
+ api: {
64
+ openApiUrl: "https://api.example.com/openapi.json",
65
+ authDocsUrl: "/docs/authentication",
66
+ scopesDocsUrl: "/docs/scopes",
67
+ rateLimitsUrl: "/docs/rate-limits",
68
+ errorsUrl: "/docs/errors",
69
+ },
70
+ mcp: {
71
+ manifestUrl: "/.well-known/mcp.json",
72
+ servers: [
73
+ {
74
+ name: "My Product MCP",
75
+ url: "https://example.com/api/mcp",
76
+ description: "Use product tools through MCP.",
77
+ },
78
+ ],
79
+ },
80
+ links: [
81
+ {
82
+ label: "Support",
83
+ href: "https://example.com/support",
84
+ description: "Get help from the product team.",
85
+ },
86
+ ],
87
+ } satisfies GeistdocsAgentReadinessConfig;
88
+ ```
89
+
90
+ ```tsx title="lib/geistdocs/config.tsx"
91
+ import { agent } from "@/geistdocs";
92
+
93
+ export const config = defineConfig({
94
+ // ...
95
+ agent,
96
+ });
97
+ ```
98
+
99
+ ## Keep it honest
100
+
101
+ Only list OpenAPI specs, authentication flows, or MCP servers that actually exist. Geistdocs makes product capabilities discoverable, but it does not create APIs or MCP tools for you.
102
+
103
+ Use `/agents.md` with [llms.txt](/docs/llms-txt), [.md extension](/docs/md), and [Proxy and markdown routes](/docs/proxy) to give agents a complete discovery path.
@@ -17,7 +17,7 @@ The Ask AI feature provides an intelligent chat assistant built directly into yo
17
17
  Help me configure Ask AI for this Geistdocs site. Check my AI prompt, suggestions, environment variables, and search route, then recommend improvements for the assistant experience.
18
18
  </CopyPrompt>
19
19
 
20
- ## How It Works
20
+ ## How it works
21
21
 
22
22
  The AI chat assistant is available in two ways:
23
23
 
@@ -43,17 +43,69 @@ Once open, users can:
43
43
  - View AI-powered search results from your docs
44
44
  - Get step-by-step guidance on complex topics
45
45
 
46
+ ## AI SDK dependency ownership
47
+
48
+ Geistdocs Ask AI is built on AI SDK v6. Generated projects install `ai` v6 and `@ai-sdk/react` v3, and `@vercel/geistdocs` owns the chat client, transport, and `createChatRoute` server behavior.
49
+
50
+ When a consumer app already uses the AI SDK outside Geistdocs, treat that as app code. Upgrade the app code to the installed AI SDK version or let the package manager install separate versions if needed. Do not fork Geistdocs chat internals or downgrade Ask AI to match unrelated app usage.
51
+
52
+ Most projects should not customize the chat transport. If you do customize `DefaultChatTransport.prepareSendMessagesRequest`, preserve `messages` in the returned request body. The AI SDK passes `messages` separately from `body`, and returning a custom `body` replaces the default request body.
53
+
54
+ ```ts
55
+ prepareSendMessagesRequest: ({ body, messages }) => ({
56
+ body: {
57
+ ...body,
58
+ messages,
59
+ currentRoute: pathname,
60
+ },
61
+ });
62
+ ```
63
+
64
+ ## Choose an AI mode
65
+
66
+ Ask AI can run in the default AI Gateway mode or through a Vertex-backed proxy.
67
+
68
+ ### Default AI Gateway mode
69
+
70
+ Use the default mode when the Geistdocs site should call the Vercel AI Gateway directly.
71
+
72
+ 1. Leave `GEISTDOCS_CHAT_PROXY_URL` unset.
73
+ 2. Set `AI_GATEWAY_API_KEY` for local development. Vercel sets this automatically for deployments that have AI Gateway access.
74
+ 3. Keep `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` set to the site's production host, such as `docs.example.com` or `localhost:3000` for local development.
75
+
76
+ In this mode, Geistdocs uses the local `search_docs` tool during the AI SDK `streamText` loop.
77
+
78
+ ### Vertex-backed proxy mode
79
+
80
+ Use proxy mode when Ask AI should route model requests through a central Vertex-backed service instead of calling AI Gateway from each site.
81
+
82
+ 1. Deploy or use the central Geistdocs platform proxy that exposes `POST /vertex`.
83
+ 2. Configure the Vertex deployment to trust the Geistdocs platform Vercel project with Deployment Protection Trusted Sources.
84
+ 3. Set `GEISTDOCS_CHAT_PROXY_URL` on the Geistdocs site to the platform proxy URL, including `/vertex`:
85
+
86
+ ```txt
87
+ https://<geistdocs-platform-deployment>/vertex
88
+ ```
89
+
90
+ 4. Leave `GEISTDOCS_CHAT_PROXY_TOKEN` unset unless you are using a custom proxy that requires bearer authentication.
91
+
92
+ When `GEISTDOCS_CHAT_PROXY_URL` is set, Geistdocs searches local docs on the first user message, injects the current page and related docs into the final user message, forwards `{ messages, platform: "vercel" }` to the proxy, and streams the AI SDK UI stream response back to the browser.
93
+
94
+ The platform proxy forwards a Vercel OIDC token to Vertex in the `x-vercel-trusted-oidc-idp-token` header. The Vertex deployment should validate the caller through Trusted Sources; the Geistdocs site does not need a Vertex API key.
95
+
46
96
  ## Features
47
97
 
48
98
  ### Context-Aware Search
49
99
 
50
- The AI assistant includes a built-in `search_docs` tool that:
100
+ By default, the AI assistant includes a built-in `search_docs` tool that:
51
101
 
52
102
  1. Searches through your documentation content
53
103
  2. Finds relevant pages based on the user's question
54
104
  3. Shows source citations with links to the referenced pages
55
105
  4. Uses the content to provide accurate, contextual answers
56
106
 
107
+ When `GEISTDOCS_CHAT_PROXY_URL` is set, Geistdocs runs local documentation retrieval on the first user message before forwarding the request to the configured proxy. This gives proxy-backed services access to the current page and related local documentation without requiring them to read the site's source files directly.
108
+
57
109
  ### Persistent Chat History
58
110
 
59
111
  Conversations are automatically saved to the browser's IndexedDB, providing:
@@ -76,13 +128,13 @@ Conversations are automatically saved to the browser's IndexedDB, providing:
76
128
  The chat interface adapts to different screen sizes:
77
129
 
78
130
  - **Desktop**: Slides in from the right side as a sidebar panel
79
- - **Mobile**: Opens as a bottom drawer for easy access
131
+ - **Mobile**: Opens as a bottom drawer.
80
132
 
81
133
  ## Configuration
82
134
 
83
- The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set, which you can read more about in the [Environment Variables](/docs/env) section.
135
+ The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set for the default AI Gateway mode. Set `GEISTDOCS_CHAT_PROXY_URL` to route Ask AI through a Vertex-backed proxy instead. You can read more in the [Environment Variables](/docs/env) section.
84
136
 
85
- The model used is `openai/gpt-4.1-mini` via the Vercel AI Gateway.
137
+ In default AI Gateway mode, Geistdocs uses `openai/gpt-4.1-mini` via the Vercel AI Gateway. In Vertex-backed proxy mode, the configured proxy controls the upstream model.
86
138
 
87
139
  ## Suggested Prompts
88
140