@vercel/geistdocs 1.3.0-canary.88e35b7 → 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 (374) 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 +2 -5
  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.d.ts.map +1 -1
  76. package/dist/components/code-block.js +7 -3
  77. package/dist/components/collapsible.d.ts +2 -0
  78. package/dist/components/collapsible.d.ts.map +1 -0
  79. package/dist/components/collapsible.js +3 -0
  80. package/dist/components/copy-prompt.d.ts +11 -0
  81. package/dist/components/copy-prompt.d.ts.map +1 -0
  82. package/dist/components/copy-prompt.js +58 -0
  83. package/dist/components/dialog.d.ts +13 -0
  84. package/dist/components/dialog.d.ts.map +1 -0
  85. package/dist/components/dialog.js +35 -0
  86. package/dist/components/drawer.d.ts +2 -0
  87. package/dist/components/drawer.d.ts.map +1 -0
  88. package/dist/components/drawer.js +3 -0
  89. package/dist/components/dropdown-menu.d.ts +2 -0
  90. package/dist/components/dropdown-menu.d.ts.map +1 -0
  91. package/dist/components/dropdown-menu.js +3 -0
  92. package/dist/components/input-group.d.ts +2 -0
  93. package/dist/components/input-group.d.ts.map +1 -0
  94. package/dist/components/input-group.js +3 -0
  95. package/dist/components/input.d.ts +2 -0
  96. package/dist/components/input.d.ts.map +1 -0
  97. package/dist/components/input.js +2 -0
  98. package/dist/components/kbd.d.ts +2 -0
  99. package/dist/components/kbd.d.ts.map +1 -0
  100. package/dist/components/kbd.js +2 -0
  101. package/dist/components/navigation-menu.d.ts +2 -0
  102. package/dist/components/navigation-menu.d.ts.map +1 -0
  103. package/dist/components/navigation-menu.js +3 -0
  104. package/dist/components/popover.d.ts +2 -0
  105. package/dist/components/popover.d.ts.map +1 -0
  106. package/dist/components/popover.js +3 -0
  107. package/dist/components/scroll-area.d.ts +2 -0
  108. package/dist/components/scroll-area.d.ts.map +1 -0
  109. package/dist/components/scroll-area.js +3 -0
  110. package/dist/components/separator.d.ts +2 -0
  111. package/dist/components/separator.d.ts.map +1 -0
  112. package/dist/components/separator.js +3 -0
  113. package/dist/components/sheet.d.ts +2 -0
  114. package/dist/components/sheet.d.ts.map +1 -0
  115. package/dist/components/sheet.js +3 -0
  116. package/dist/components/sonner.d.ts +2 -0
  117. package/dist/components/sonner.d.ts.map +1 -0
  118. package/dist/components/sonner.js +3 -0
  119. package/dist/components/spinner.d.ts +2 -0
  120. package/dist/components/spinner.d.ts.map +1 -0
  121. package/dist/components/spinner.js +2 -0
  122. package/dist/components/textarea.d.ts +2 -0
  123. package/dist/components/textarea.d.ts.map +1 -0
  124. package/dist/components/textarea.js +2 -0
  125. package/dist/components/tooltip.d.ts +2 -0
  126. package/dist/components/tooltip.d.ts.map +1 -0
  127. package/dist/components/tooltip.js +3 -0
  128. package/dist/config.d.ts +66 -1
  129. package/dist/config.d.ts.map +1 -1
  130. package/dist/controls.js +4 -4
  131. package/dist/footer.d.ts +8 -0
  132. package/dist/footer.d.ts.map +1 -0
  133. package/dist/footer.js +6 -0
  134. package/dist/home-layout.d.ts +11 -0
  135. package/dist/home-layout.d.ts.map +1 -0
  136. package/dist/home-layout.js +31 -0
  137. package/dist/internal/chat/conversation.js +1 -1
  138. package/dist/internal/chat/message.js +1 -1
  139. package/dist/internal/chat/prompt-input.js +1 -1
  140. package/dist/internal/chat/shell.d.ts.map +1 -1
  141. package/dist/internal/chat/shell.js +6 -5
  142. package/dist/internal/chat/sources.js +1 -1
  143. package/dist/internal/config-context.d.ts +10 -0
  144. package/dist/internal/config-context.d.ts.map +1 -0
  145. package/dist/internal/config-context.js +15 -0
  146. package/dist/internal/footer/github-button.d.ts +7 -0
  147. package/dist/internal/footer/github-button.d.ts.map +1 -0
  148. package/dist/internal/footer/github-button.js +10 -0
  149. package/dist/internal/footer/rss-button.d.ts +2 -0
  150. package/dist/internal/footer/rss-button.d.ts.map +1 -0
  151. package/dist/internal/footer/rss-button.js +4 -0
  152. package/dist/internal/localized-link.d.ts +8 -0
  153. package/dist/internal/localized-link.d.ts.map +1 -0
  154. package/dist/internal/localized-link.js +13 -0
  155. package/dist/internal/navbar/desktop-menu.d.ts +10 -0
  156. package/dist/internal/navbar/desktop-menu.d.ts.map +1 -0
  157. package/dist/internal/navbar/desktop-menu.js +11 -0
  158. package/dist/internal/navbar/mobile-menu.d.ts +7 -0
  159. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -0
  160. package/dist/internal/navbar/mobile-menu.js +44 -0
  161. package/dist/internal/navbar/navbar-logo.d.ts +16 -0
  162. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -0
  163. package/dist/internal/navbar/navbar-logo.js +30 -0
  164. package/dist/internal/page-actions-client.d.ts +1 -2
  165. package/dist/internal/page-actions-client.d.ts.map +1 -1
  166. package/dist/internal/page-actions-client.js +28 -11
  167. package/dist/internal/page-visibility.d.ts +18 -0
  168. package/dist/internal/page-visibility.d.ts.map +1 -0
  169. package/dist/internal/page-visibility.js +24 -0
  170. package/dist/internal/provider-client.d.ts +9 -0
  171. package/dist/internal/provider-client.d.ts.map +1 -0
  172. package/dist/internal/provider-client.js +24 -0
  173. package/dist/internal/sidebar.d.ts +4 -1
  174. package/dist/internal/sidebar.d.ts.map +1 -1
  175. package/dist/internal/sidebar.js +8 -7
  176. package/dist/internal/table-of-contents.d.ts +9 -0
  177. package/dist/internal/table-of-contents.d.ts.map +1 -0
  178. package/dist/internal/table-of-contents.js +5 -0
  179. package/dist/internal/ui/button-group.js +2 -2
  180. package/dist/internal/ui/button.d.ts +1 -1
  181. package/dist/internal/ui/button.d.ts.map +1 -1
  182. package/dist/internal/ui/button.js +7 -7
  183. package/dist/internal/ui/card.js +1 -1
  184. package/dist/internal/ui/drawer.js +1 -1
  185. package/dist/internal/ui/dropdown-menu.js +7 -7
  186. package/dist/internal/ui/input-group.js +2 -2
  187. package/dist/internal/ui/input.js +1 -1
  188. package/dist/internal/ui/kbd.js +1 -1
  189. package/dist/internal/ui/navigation-menu.d.ts +17 -0
  190. package/dist/internal/ui/navigation-menu.d.ts.map +1 -0
  191. package/dist/internal/ui/navigation-menu.js +38 -0
  192. package/dist/internal/ui/popover.js +1 -1
  193. package/dist/internal/ui/scroll-area.js +2 -2
  194. package/dist/internal/ui/separator.js +1 -1
  195. package/dist/internal/ui/sheet.js +4 -4
  196. package/dist/internal/ui/sonner.js +3 -3
  197. package/dist/internal/ui/textarea.js +1 -1
  198. package/dist/internal/ui/tooltip.js +1 -1
  199. package/dist/layout.d.ts +4 -8
  200. package/dist/layout.d.ts.map +1 -1
  201. package/dist/layout.js +26 -44
  202. package/dist/mdx.d.ts +55 -24
  203. package/dist/mdx.d.ts.map +1 -1
  204. package/dist/mdx.js +9 -46
  205. package/dist/mobile-docs-bar.d.ts +7 -0
  206. package/dist/mobile-docs-bar.d.ts.map +1 -0
  207. package/dist/mobile-docs-bar.js +13 -0
  208. package/dist/navbar.d.ts +7 -0
  209. package/dist/navbar.d.ts.map +1 -0
  210. package/dist/navbar.js +10 -0
  211. package/dist/pages/docs.d.ts +33 -5
  212. package/dist/pages/docs.d.ts.map +1 -1
  213. package/dist/pages/docs.js +57 -22
  214. package/dist/proxy.d.ts +24 -8
  215. package/dist/proxy.d.ts.map +1 -1
  216. package/dist/proxy.js +116 -36
  217. package/dist/routes/agents.d.ts +21 -0
  218. package/dist/routes/agents.d.ts.map +1 -0
  219. package/dist/routes/agents.js +201 -0
  220. package/dist/routes/chat.d.ts +11 -5
  221. package/dist/routes/chat.d.ts.map +1 -1
  222. package/dist/routes/chat.js +386 -65
  223. package/dist/routes/llms.d.ts +29 -10
  224. package/dist/routes/llms.d.ts.map +1 -1
  225. package/dist/routes/llms.js +80 -9
  226. package/dist/routes/search.d.ts +8 -5
  227. package/dist/routes/search.d.ts.map +1 -1
  228. package/dist/routes/search.js +52 -4
  229. package/dist/routes/sitemap.d.ts +15 -3
  230. package/dist/routes/sitemap.d.ts.map +1 -1
  231. package/dist/routes/sitemap.js +32 -6
  232. package/dist/shiki-theme.d.ts +20 -0
  233. package/dist/shiki-theme.d.ts.map +1 -0
  234. package/dist/shiki-theme.js +110 -0
  235. package/dist/sidebar.d.ts +11 -0
  236. package/dist/sidebar.d.ts.map +1 -0
  237. package/dist/sidebar.js +16 -0
  238. package/dist/source-config.d.ts +68 -0
  239. package/dist/source-config.d.ts.map +1 -0
  240. package/dist/source-config.js +161 -0
  241. package/dist/source.d.ts +155 -4
  242. package/dist/source.d.ts.map +1 -1
  243. package/dist/source.js +73 -3
  244. package/dist/versions.d.ts +45 -0
  245. package/dist/versions.d.ts.map +1 -0
  246. package/dist/versions.js +79 -0
  247. package/package.json +142 -9
  248. package/source-config.js +174 -0
  249. package/styles.css +465 -102
  250. package/template/AGENTS.md +95 -0
  251. package/template/app/[lang]/(home)/components/centered-section.tsx +1 -3
  252. package/template/app/[lang]/(home)/components/hero.tsx +2 -2
  253. package/template/app/[lang]/(home)/components/one-two-section.tsx +1 -3
  254. package/template/app/[lang]/(home)/components/templates.tsx +3 -5
  255. package/template/app/[lang]/(home)/components/text-grid-section.tsx +1 -1
  256. package/template/app/[lang]/(home)/layout.tsx +4 -3
  257. package/template/app/[lang]/(home)/page.tsx +2 -2
  258. package/template/app/[lang]/agents.md/route.ts +6 -0
  259. package/template/app/[lang]/docs/[[...slug]]/page.tsx +4 -1
  260. package/template/app/[lang]/layout.tsx +6 -6
  261. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +1 -1
  262. package/template/app/[lang]/llms.txt/route.ts +1 -1
  263. package/template/app/[lang]/sitemap.md/route.ts +2 -2
  264. package/template/app/api/chat/route.ts +12 -1
  265. package/template/app/api/search/route.ts +2 -2
  266. package/template/app/styles/geistdocs.css +151 -109
  267. package/template/components/ui/badge.tsx +5 -5
  268. package/template/components/ui/button.tsx +7 -7
  269. package/template/components/ui/command-prompt.tsx +2 -2
  270. package/template/content/docs/agent-readiness.mdx +103 -0
  271. package/template/content/docs/ask-ai.mdx +61 -5
  272. package/template/content/docs/configuration.cn.mdx +47 -7
  273. package/template/content/docs/configuration.mdx +226 -66
  274. package/template/content/docs/deployment.mdx +17 -0
  275. package/template/content/docs/edit-on-github.mdx +6 -2
  276. package/template/content/docs/env.mdx +38 -3
  277. package/template/content/docs/feedback.mdx +6 -2
  278. package/template/content/docs/getting-started.cn.mdx +2 -2
  279. package/template/content/docs/getting-started.mdx +71 -43
  280. package/template/content/docs/index.cn.mdx +36 -33
  281. package/template/content/docs/index.mdx +69 -59
  282. package/template/content/docs/internationalization.cn.mdx +7 -9
  283. package/template/content/docs/internationalization.mdx +10 -5
  284. package/template/content/docs/llms-txt.cn.mdx +24 -2
  285. package/template/content/docs/llms-txt.mdx +48 -12
  286. package/template/content/docs/md.cn.mdx +12 -15
  287. package/template/content/docs/md.mdx +30 -16
  288. package/template/content/docs/meta.json +6 -2
  289. package/template/content/docs/migration.mdx +364 -0
  290. package/template/content/docs/open-in-chat.mdx +12 -10
  291. package/template/content/docs/provider.cn.mdx +6 -5
  292. package/template/content/docs/provider.mdx +13 -8
  293. package/template/content/docs/proxy.cn.mdx +96 -0
  294. package/template/content/docs/proxy.mdx +178 -0
  295. package/template/content/docs/rss.mdx +6 -2
  296. package/template/content/docs/syntax.cn.mdx +2 -2
  297. package/template/content/docs/syntax.mdx +6 -2
  298. package/template/content/docs/theme-aware-image.mdx +5 -1
  299. package/template/content/docs/versioned-docs.cn.mdx +117 -0
  300. package/template/content/docs/versioned-docs.mdx +228 -0
  301. package/template/geistdocs.tsx +26 -0
  302. package/template/lib/geistdocs/config.tsx +3 -0
  303. package/template/package.json +5 -5
  304. package/template/proxy.ts +2 -1
  305. package/template/source.config.ts +8 -47
  306. package/template/app/actions/feedback/emotions.ts +0 -18
  307. package/template/app/actions/feedback/index.ts +0 -45
  308. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right-small.tsx +0 -35
  309. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right.tsx +0 -27
  310. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-check.tsx +0 -27
  311. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-down-small.tsx +0 -30
  312. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-right.tsx +0 -27
  313. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy.tsx +0 -27
  314. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-file-text.tsx +0 -25
  315. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-menu-alt.tsx +0 -27
  316. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-slash-forward.tsx +0 -36
  317. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-elements.tsx +0 -29
  318. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-sdk.tsx +0 -38
  319. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-chat-sdk.tsx +0 -42
  320. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-flags-sdk.tsx +0 -42
  321. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-icon-vercel.tsx +0 -31
  322. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-streamdown.tsx +0 -29
  323. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-vercel-oss.tsx +0 -24
  324. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-workflow-sdk.tsx +0 -73
  325. package/template/components/geistdocs/callout.tsx +0 -40
  326. package/template/components/geistdocs/chat.tsx +0 -24
  327. package/template/components/geistdocs/code-block-tabs.tsx +0 -61
  328. package/template/components/geistdocs/code-block.tsx +0 -134
  329. package/template/components/geistdocs/copy-page.tsx +0 -27
  330. package/template/components/geistdocs/desktop-menu.tsx +0 -52
  331. package/template/components/geistdocs/docs-page.tsx +0 -35
  332. package/template/components/geistdocs/edit-source.tsx +0 -30
  333. package/template/components/geistdocs/feedback.tsx +0 -139
  334. package/template/components/geistdocs/footer.tsx +0 -30
  335. package/template/components/geistdocs/github-button.tsx +0 -19
  336. package/template/components/geistdocs/home-layout.tsx +0 -46
  337. package/template/components/geistdocs/icons.tsx +0 -13
  338. package/template/components/geistdocs/installer.tsx +0 -58
  339. package/template/components/geistdocs/language-selector.tsx +0 -3
  340. package/template/components/geistdocs/mermaid.tsx +0 -68
  341. package/template/components/geistdocs/mobile-docs-bar.tsx +0 -81
  342. package/template/components/geistdocs/mobile-menu.tsx +0 -150
  343. package/template/components/geistdocs/navbar-logo.tsx +0 -124
  344. package/template/components/geistdocs/navbar.tsx +0 -22
  345. package/template/components/geistdocs/rss-button.tsx +0 -10
  346. package/template/components/geistdocs/scroll-top.tsx +0 -21
  347. package/template/components/geistdocs/search.tsx +0 -17
  348. package/template/components/geistdocs/sidebar.tsx +0 -128
  349. package/template/components/geistdocs/theme-aware-image.tsx +0 -22
  350. package/template/components/geistdocs/theme-toggle.tsx +0 -3
  351. package/template/components/geistdocs/video.tsx +0 -16
  352. package/template/components/ui/button-group.tsx +0 -83
  353. package/template/components/ui/card.tsx +0 -92
  354. package/template/components/ui/collapsible.tsx +0 -33
  355. package/template/components/ui/command.tsx +0 -184
  356. package/template/components/ui/dialog.tsx +0 -143
  357. package/template/components/ui/drawer.tsx +0 -135
  358. package/template/components/ui/dropdown-menu.tsx +0 -257
  359. package/template/components/ui/hover-card.tsx +0 -44
  360. package/template/components/ui/input-group.tsx +0 -170
  361. package/template/components/ui/input.tsx +0 -21
  362. package/template/components/ui/kbd.tsx +0 -28
  363. package/template/components/ui/navigation-menu.tsx +0 -192
  364. package/template/components/ui/popover.tsx +0 -48
  365. package/template/components/ui/scroll-area.tsx +0 -58
  366. package/template/components/ui/select.tsx +0 -187
  367. package/template/components/ui/separator.tsx +0 -28
  368. package/template/components/ui/sheet.tsx +0 -139
  369. package/template/components/ui/sonner.tsx +0 -40
  370. package/template/components/ui/spinner.tsx +0 -16
  371. package/template/components/ui/textarea.tsx +0 -18
  372. package/template/components/ui/tooltip.tsx +0 -61
  373. package/template/hooks/geistdocs/use-sidebar.ts +0 -13
  374. package/template/hooks/use-mobile.ts +0 -19
@@ -3,51 +3,29 @@
3
3
  @import "fumadocs-ui/css/preset.css";
4
4
  @import "tw-animate-css";
5
5
 
6
+ @source "../../node_modules/@vercel/geistdocs/dist/**/*.js";
6
7
  @source "../../node_modules/streamdown/dist/*.js";
7
8
 
8
9
  @custom-variant dark (&:is(.dark *));
9
10
 
10
11
  @theme inline {
11
- /* Geist border radii */
12
+ /* geist theme tokens */
13
+
12
14
  --radius-xs: 0.125rem; /* 2px */
13
15
  --radius-sm: 0.25rem; /* 4px */
14
16
  --radius-md: 0.375rem; /* 6px */
15
17
  --radius-lg: 0.5rem; /* 8px */
16
18
  --radius-xl: 0.75rem; /* 12px */
17
19
  --radius-2xl: 1rem; /* 16px */
18
- --color-background: var(--background);
19
- --color-foreground: var(--foreground);
20
- --color-card: var(--card);
21
- --color-card-foreground: var(--card-foreground);
22
- --color-popover: var(--popover);
23
- --color-popover-foreground: var(--popover-foreground);
24
- --color-primary: var(--ds-gray-1000);
25
- --color-primary-foreground: var(--ds-background-100);
26
- --color-secondary: var(--secondary);
27
- --color-secondary-foreground: var(--secondary-foreground);
28
- --color-muted: var(--muted);
29
- --color-muted-foreground: var(--muted-foreground);
30
- --color-accent: var(--accent);
31
- --color-accent-foreground: var(--accent-foreground);
32
- --color-destructive: var(--destructive);
33
- --color-border: var(--border);
34
- --color-input: var(--input);
35
- --color-ring: var(--ring);
36
- --color-chart-1: var(--chart-1);
37
- --color-chart-2: var(--chart-2);
38
- --color-chart-3: var(--chart-3);
39
- --color-chart-4: var(--chart-4);
40
- --color-chart-5: var(--chart-5);
41
- --color-sidebar: var(--sidebar);
42
- --color-sidebar-foreground: var(--sidebar-foreground);
43
- --color-sidebar-primary: var(--sidebar-primary);
44
- --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
45
- --color-sidebar-accent: var(--sidebar-accent);
46
- --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
47
- --color-sidebar-border: var(--sidebar-border);
48
- --color-sidebar-ring: var(--sidebar-ring);
49
-
50
- /* 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
+
51
29
  --color-background-100: var(--ds-background-100);
52
30
  --color-background-200: var(--ds-background-200);
53
31
 
@@ -153,7 +131,6 @@
153
131
  }
154
132
 
155
133
  :root {
156
- /* Geist colors */
157
134
  --ds-black: oklch(0 0 0);
158
135
  --ds-white: oklch(1 0 0);
159
136
  --ds-background-100: oklch(1 0 0);
@@ -250,48 +227,59 @@
250
227
  --ds-pink-900: oklch(53.5% 0.2058 2.84);
251
228
  --ds-pink-1000: oklch(26% 0.0977 359);
252
229
  --ds-shadow-background-border: 0 0 0 1px var(--ds-background-200);
230
+
253
231
  --ds-shadow-border-base: 0 0 0 1px rgba(0, 0, 0, 0.08);
254
- --ds-shadow-menu:
255
- var(--ds-shadow-border-base), 0px 1px 1px rgba(0, 0, 0, 0.02),
256
- 0px 4px 8px -4px rgba(0, 0, 0, 0.04),
257
- 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);
258
239
  --ds-shadow-small: 0px 2px 2px rgba(0, 0, 0, 0.04);
259
240
  --ds-shadow-border-small:
260
241
  var(--ds-shadow-border-base), var(--ds-shadow-small),
261
242
  var(--ds-shadow-background-border);
262
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
+
263
282
  --radius: 0.625rem;
264
- --background: oklch(1 0 0);
265
- --foreground: oklch(0.145 0 0);
266
- --card: oklch(1 0 0);
267
- --card-foreground: oklch(0.145 0 0);
268
- --popover: oklch(1 0 0);
269
- --popover-foreground: oklch(0.145 0 0);
270
- --primary: oklch(57.61% 0.2508 258.23);
271
- --primary-foreground: oklch(1 0 0);
272
- --secondary: oklch(0.97 0 0);
273
- --secondary-foreground: oklch(0.205 0 0);
274
- --muted: oklch(0.97 0 0);
275
- --muted-foreground: oklch(0.556 0 0);
276
- --accent: oklch(0.97 0 0);
277
- --accent-foreground: oklch(0.205 0 0);
278
- --destructive: oklch(0.577 0.245 27.325);
279
- --border: oklch(0.922 0 0);
280
- --input: oklch(0.922 0 0);
281
- --ring: oklch(0.708 0 0);
282
- --chart-1: oklch(0.646 0.222 41.116);
283
- --chart-2: oklch(0.6 0.118 184.704);
284
- --chart-3: oklch(0.398 0.07 227.392);
285
- --chart-4: oklch(0.828 0.189 84.429);
286
- --chart-5: oklch(0.769 0.188 70.08);
287
- --sidebar: oklch(0.985 0 0);
288
- --sidebar-foreground: oklch(0.145 0 0);
289
- --sidebar-primary: oklch(0.205 0 0);
290
- --sidebar-primary-foreground: oklch(0.985 0 0);
291
- --sidebar-accent: oklch(0.97 0 0);
292
- --sidebar-accent-foreground: oklch(0.205 0 0);
293
- --sidebar-border: oklch(0.922 0 0);
294
- --sidebar-ring: oklch(0.708 0 0);
295
283
  }
296
284
 
297
285
  .dark {
@@ -389,54 +377,66 @@
389
377
  --ds-pink-900: oklch(69.36% 0.2223 3.91);
390
378
  --ds-pink-1000: oklch(95.74% 0.0326 350.08);
391
379
 
392
- /* Geist shadow utilities */
393
- --ds-shadow-menu: 0 0 0 1px oklch(1 0 0 / 0.1), 0 8px 16px oklch(0 0 0 / 0.4);
394
380
  --ds-shadow-background-border: 0 0 0 1px var(--ds-background-200);
381
+
395
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);
396
390
  --ds-shadow-small: 0px 1px 2px rgba(0, 0, 0, 0.16);
397
391
  --ds-shadow-border-small:
398
392
  var(--ds-shadow-border-base), var(--ds-shadow-small),
399
393
  var(--ds-shadow-background-border);
400
394
 
401
- --background: oklch(0.145 0 0);
402
- --foreground: oklch(0.985 0 0);
403
- --card: oklch(0.205 0 0);
404
- --card-foreground: oklch(0.985 0 0);
405
- --popover: oklch(0.205 0 0);
406
- --popover-foreground: oklch(0.985 0 0);
407
- --primary: oklch(57.61% 0.2508 258.23);
408
- --primary-foreground: oklch(1 0 0);
409
- --secondary: oklch(0.269 0 0);
410
- --secondary-foreground: oklch(0.985 0 0);
411
- --muted: oklch(0.269 0 0);
412
- --muted-foreground: oklch(0.708 0 0);
413
- --accent: oklch(0.269 0 0);
414
- --accent-foreground: oklch(0.985 0 0);
415
- --destructive: oklch(0.704 0.191 22.216);
416
- --border: oklch(1 0 0 / 10%);
417
- --input: oklch(1 0 0 / 15%);
418
- --ring: oklch(0.556 0 0);
419
- --chart-1: oklch(0.488 0.243 264.376);
420
- --chart-2: oklch(0.696 0.17 162.48);
421
- --chart-3: oklch(0.769 0.188 70.08);
422
- --chart-4: oklch(0.627 0.265 303.9);
423
- --chart-5: oklch(0.645 0.246 16.439);
424
- --sidebar: oklch(0.205 0 0);
425
- --sidebar-foreground: oklch(0.985 0 0);
426
- --sidebar-primary: oklch(0.488 0.243 264.376);
427
- --sidebar-primary-foreground: oklch(0.985 0 0);
428
- --sidebar-accent: oklch(0.269 0 0);
429
- --sidebar-accent-foreground: oklch(0.985 0 0);
430
- --sidebar-border: oklch(1 0 0 / 10%);
431
- --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);
432
432
  }
433
433
 
434
434
  @layer base {
435
435
  * {
436
- @apply border-border outline-ring/50;
436
+ @apply border-gray-alpha-400 outline-gray-600/50;
437
437
  }
438
438
  body {
439
- @apply bg-background-200 text-foreground;
439
+ @apply bg-background-200 text-gray-1000;
440
440
  }
441
441
  }
442
442
 
@@ -446,7 +446,7 @@
446
446
  ::before,
447
447
  ::backdrop,
448
448
  ::file-selector-button {
449
- @apply border-border;
449
+ @apply border-gray-alpha-400;
450
450
  }
451
451
  * {
452
452
  @apply min-w-0;
@@ -459,7 +459,7 @@
459
459
  }
460
460
  input::placeholder,
461
461
  textarea::placeholder {
462
- @apply text-muted-foreground;
462
+ @apply text-gray-800;
463
463
  }
464
464
  button:not(:disabled),
465
465
  [role="button"]:not(:disabled) {
@@ -505,7 +505,7 @@
505
505
  .line-numbers code .line::before {
506
506
  content: counter(step);
507
507
  counter-increment: step;
508
- @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;
509
509
  }
510
510
  }
511
511
 
@@ -547,7 +547,49 @@
547
547
  @apply text-gray-1000;
548
548
  }
549
549
 
550
- /* Override fumadocs primary color to match design system */
550
+ /* Shiki syntax highlighting palette - matches packages/geist code-block.module.css */
551
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);
552
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);
553
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.
@@ -13,7 +13,11 @@ related:
13
13
 
14
14
  The Ask AI feature provides an intelligent chat assistant built directly into your documentation. Users can ask questions about your docs and get instant, context-aware answers powered by AI. The assistant can search through your documentation, understand context, and provide helpful responses.
15
15
 
16
- ## How It Works
16
+ <CopyPrompt text="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.">
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
+ </CopyPrompt>
19
+
20
+ ## How it works
17
21
 
18
22
  The AI chat assistant is available in two ways:
19
23
 
@@ -39,17 +43,69 @@ Once open, users can:
39
43
  - View AI-powered search results from your docs
40
44
  - Get step-by-step guidance on complex topics
41
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
+
42
96
  ## Features
43
97
 
44
98
  ### Context-Aware Search
45
99
 
46
- 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:
47
101
 
48
102
  1. Searches through your documentation content
49
103
  2. Finds relevant pages based on the user's question
50
104
  3. Shows source citations with links to the referenced pages
51
105
  4. Uses the content to provide accurate, contextual answers
52
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
+
53
109
  ### Persistent Chat History
54
110
 
55
111
  Conversations are automatically saved to the browser's IndexedDB, providing:
@@ -72,13 +128,13 @@ Conversations are automatically saved to the browser's IndexedDB, providing:
72
128
  The chat interface adapts to different screen sizes:
73
129
 
74
130
  - **Desktop**: Slides in from the right side as a sidebar panel
75
- - **Mobile**: Opens as a bottom drawer for easy access
131
+ - **Mobile**: Opens as a bottom drawer.
76
132
 
77
133
  ## Configuration
78
134
 
79
- 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.
80
136
 
81
- 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.
82
138
 
83
139
  ## Suggested Prompts
84
140