@vercel/geistdocs 1.2.3-canary.48fea3c → 1.2.3-canary.73598cf

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 (342) 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 +47 -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.js +3 -3
  170. package/dist/internal/ui/button-group.js +2 -2
  171. package/dist/internal/ui/button.d.ts +1 -1
  172. package/dist/internal/ui/button.d.ts.map +1 -1
  173. package/dist/internal/ui/button.js +7 -7
  174. package/dist/internal/ui/card.js +1 -1
  175. package/dist/internal/ui/drawer.js +1 -1
  176. package/dist/internal/ui/dropdown-menu.js +7 -7
  177. package/dist/internal/ui/input-group.js +2 -2
  178. package/dist/internal/ui/input.js +1 -1
  179. package/dist/internal/ui/kbd.js +1 -1
  180. package/dist/internal/ui/navigation-menu.d.ts +17 -0
  181. package/dist/internal/ui/navigation-menu.d.ts.map +1 -0
  182. package/dist/internal/ui/navigation-menu.js +38 -0
  183. package/dist/internal/ui/popover.js +1 -1
  184. package/dist/internal/ui/scroll-area.js +2 -2
  185. package/dist/internal/ui/separator.js +1 -1
  186. package/dist/internal/ui/sheet.js +4 -4
  187. package/dist/internal/ui/sonner.js +3 -3
  188. package/dist/internal/ui/textarea.js +1 -1
  189. package/dist/internal/ui/tooltip.js +1 -1
  190. package/dist/mdx.d.ts +55 -24
  191. package/dist/mdx.d.ts.map +1 -1
  192. package/dist/mdx.js +7 -46
  193. package/dist/mobile-docs-bar.d.ts +7 -0
  194. package/dist/mobile-docs-bar.d.ts.map +1 -0
  195. package/dist/mobile-docs-bar.js +13 -0
  196. package/dist/navbar.d.ts +7 -0
  197. package/dist/navbar.d.ts.map +1 -0
  198. package/dist/navbar.js +10 -0
  199. package/dist/pages/docs.d.ts +8 -2
  200. package/dist/pages/docs.d.ts.map +1 -1
  201. package/dist/pages/docs.js +13 -7
  202. package/dist/proxy.d.ts +1 -1
  203. package/dist/proxy.d.ts.map +1 -1
  204. package/dist/proxy.js +29 -2
  205. package/dist/routes/agents.d.ts +21 -0
  206. package/dist/routes/agents.d.ts.map +1 -0
  207. package/dist/routes/agents.js +201 -0
  208. package/dist/routes/chat.d.ts +7 -2
  209. package/dist/routes/chat.d.ts.map +1 -1
  210. package/dist/routes/chat.js +373 -65
  211. package/dist/routes/llms.d.ts +6 -5
  212. package/dist/routes/llms.d.ts.map +1 -1
  213. package/dist/routes/llms.js +63 -12
  214. package/dist/routes/search.d.ts +6 -4
  215. package/dist/routes/search.d.ts.map +1 -1
  216. package/dist/routes/search.js +8 -1
  217. package/dist/routes/sitemap.d.ts +6 -3
  218. package/dist/routes/sitemap.d.ts.map +1 -1
  219. package/dist/routes/sitemap.js +10 -2
  220. package/dist/shiki-theme.d.ts +20 -0
  221. package/dist/shiki-theme.d.ts.map +1 -0
  222. package/dist/shiki-theme.js +110 -0
  223. package/dist/source-config.d.ts +68 -0
  224. package/dist/source-config.d.ts.map +1 -0
  225. package/dist/source-config.js +161 -0
  226. package/dist/source.d.ts +8 -1
  227. package/dist/source.d.ts.map +1 -1
  228. package/dist/source.js +14 -1
  229. package/dist/versions.d.ts +31 -1
  230. package/dist/versions.d.ts.map +1 -1
  231. package/dist/versions.js +56 -29
  232. package/package.json +126 -5
  233. package/source-config.js +174 -0
  234. package/styles.css +465 -102
  235. package/template/AGENTS.md +95 -0
  236. package/template/app/[lang]/(home)/components/centered-section.tsx +1 -3
  237. package/template/app/[lang]/(home)/components/hero.tsx +2 -2
  238. package/template/app/[lang]/(home)/components/one-two-section.tsx +1 -3
  239. package/template/app/[lang]/(home)/components/templates.tsx +3 -5
  240. package/template/app/[lang]/(home)/components/text-grid-section.tsx +1 -1
  241. package/template/app/[lang]/(home)/layout.tsx +4 -3
  242. package/template/app/[lang]/(home)/page.tsx +2 -2
  243. package/template/app/[lang]/agents.md/route.ts +6 -0
  244. package/template/app/[lang]/docs/[[...slug]]/page.tsx +4 -1
  245. package/template/app/[lang]/layout.tsx +6 -6
  246. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +1 -1
  247. package/template/app/[lang]/sitemap.md/route.ts +2 -2
  248. package/template/app/api/chat/route.ts +11 -0
  249. package/template/app/api/search/route.ts +2 -2
  250. package/template/app/styles/geistdocs.css +150 -109
  251. package/template/components/ui/badge.tsx +5 -5
  252. package/template/components/ui/button.tsx +7 -7
  253. package/template/components/ui/command-prompt.tsx +2 -2
  254. package/template/content/docs/agent-readiness.mdx +103 -0
  255. package/template/content/docs/ask-ai.mdx +55 -3
  256. package/template/content/docs/configuration.mdx +77 -2
  257. package/template/content/docs/deployment.mdx +11 -0
  258. package/template/content/docs/env.mdx +36 -5
  259. package/template/content/docs/getting-started.mdx +8 -1
  260. package/template/content/docs/index.mdx +5 -0
  261. package/template/content/docs/llms-txt.mdx +1 -0
  262. package/template/content/docs/md.mdx +2 -1
  263. package/template/content/docs/meta.json +2 -0
  264. package/template/content/docs/migration.mdx +364 -0
  265. package/template/content/docs/proxy.cn.mdx +1 -1
  266. package/template/content/docs/proxy.mdx +56 -2
  267. package/template/content/docs/theme-aware-image.mdx +1 -1
  268. package/template/content/docs/versioned-docs.mdx +49 -2
  269. package/template/geistdocs.tsx +26 -0
  270. package/template/lib/geistdocs/config.tsx +3 -0
  271. package/template/package.json +5 -5
  272. package/template/proxy.ts +1 -2
  273. package/template/source.config.ts +8 -47
  274. package/template/app/actions/feedback/emotions.ts +0 -18
  275. package/template/app/actions/feedback/index.ts +0 -45
  276. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right-small.tsx +0 -35
  277. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right.tsx +0 -27
  278. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-check.tsx +0 -27
  279. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-down-small.tsx +0 -30
  280. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-right.tsx +0 -27
  281. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy.tsx +0 -27
  282. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-file-text.tsx +0 -25
  283. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-menu-alt.tsx +0 -27
  284. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-slash-forward.tsx +0 -36
  285. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-elements.tsx +0 -29
  286. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-sdk.tsx +0 -38
  287. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-chat-sdk.tsx +0 -42
  288. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-flags-sdk.tsx +0 -42
  289. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-icon-vercel.tsx +0 -31
  290. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-streamdown.tsx +0 -29
  291. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-vercel-oss.tsx +0 -24
  292. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-workflow-sdk.tsx +0 -73
  293. package/template/components/geistdocs/callout.tsx +0 -40
  294. package/template/components/geistdocs/chat.tsx +0 -24
  295. package/template/components/geistdocs/code-block-tabs.tsx +0 -61
  296. package/template/components/geistdocs/code-block.tsx +0 -134
  297. package/template/components/geistdocs/copy-page.tsx +0 -27
  298. package/template/components/geistdocs/desktop-menu.tsx +0 -52
  299. package/template/components/geistdocs/docs-page.tsx +0 -35
  300. package/template/components/geistdocs/edit-source.tsx +0 -30
  301. package/template/components/geistdocs/feedback.tsx +0 -139
  302. package/template/components/geistdocs/footer.tsx +0 -30
  303. package/template/components/geistdocs/github-button.tsx +0 -19
  304. package/template/components/geistdocs/home-layout.tsx +0 -46
  305. package/template/components/geistdocs/icons.tsx +0 -13
  306. package/template/components/geistdocs/installer.tsx +0 -58
  307. package/template/components/geistdocs/language-selector.tsx +0 -3
  308. package/template/components/geistdocs/mermaid.tsx +0 -68
  309. package/template/components/geistdocs/mobile-docs-bar.tsx +0 -77
  310. package/template/components/geistdocs/mobile-menu.tsx +0 -150
  311. package/template/components/geistdocs/navbar-logo.tsx +0 -124
  312. package/template/components/geistdocs/navbar.tsx +0 -22
  313. package/template/components/geistdocs/rss-button.tsx +0 -10
  314. package/template/components/geistdocs/scroll-top.tsx +0 -21
  315. package/template/components/geistdocs/search.tsx +0 -17
  316. package/template/components/geistdocs/sidebar.tsx +0 -128
  317. package/template/components/geistdocs/theme-aware-image.tsx +0 -22
  318. package/template/components/geistdocs/theme-toggle.tsx +0 -3
  319. package/template/components/geistdocs/video.tsx +0 -16
  320. package/template/components/ui/button-group.tsx +0 -83
  321. package/template/components/ui/card.tsx +0 -92
  322. package/template/components/ui/collapsible.tsx +0 -33
  323. package/template/components/ui/command.tsx +0 -184
  324. package/template/components/ui/dialog.tsx +0 -143
  325. package/template/components/ui/drawer.tsx +0 -135
  326. package/template/components/ui/dropdown-menu.tsx +0 -257
  327. package/template/components/ui/hover-card.tsx +0 -44
  328. package/template/components/ui/input-group.tsx +0 -170
  329. package/template/components/ui/input.tsx +0 -21
  330. package/template/components/ui/kbd.tsx +0 -28
  331. package/template/components/ui/navigation-menu.tsx +0 -192
  332. package/template/components/ui/popover.tsx +0 -48
  333. package/template/components/ui/scroll-area.tsx +0 -58
  334. package/template/components/ui/select.tsx +0 -187
  335. package/template/components/ui/separator.tsx +0 -28
  336. package/template/components/ui/sheet.tsx +0 -139
  337. package/template/components/ui/sonner.tsx +0 -40
  338. package/template/components/ui/spinner.tsx +0 -16
  339. package/template/components/ui/textarea.tsx +0 -18
  340. package/template/components/ui/tooltip.tsx +0 -61
  341. package/template/hooks/geistdocs/use-sidebar.ts +0 -13
  342. package/template/hooks/use-mobile.ts +0 -19
@@ -0,0 +1,95 @@
1
+ # Geistdocs agent instructions
2
+
3
+ This project uses the packaged Geistdocs architecture. The `@vercel/geistdocs` package owns shared runtime behavior; this app owns local content, configuration, adapters, and site-specific routes.
4
+
5
+ Use these instructions when an AI coding agent edits this project.
6
+
7
+ ## Architecture
8
+
9
+ - Runtime features come from `@vercel/geistdocs`, including the docs page renderer, layout helpers, MDX components, search, Ask AI, markdown routes, proxy helpers, and source helpers.
10
+ - `@vercel/geistdocs` owns the Ask AI client, server route behavior, and AI SDK v6 runtime dependencies. Do not fork package internals to fit an older app-level `ai` version.
11
+ - Local files are user-owned adapters. They should stay thin and call public package exports from `@vercel/geistdocs/*`.
12
+ - Do not copy package internals into the app to make a customization. Prefer configuring an adapter file or upgrading `@vercel/geistdocs`.
13
+ - Do not deep import from `@vercel/geistdocs/dist` or edit files in `node_modules/@vercel/geistdocs`.
14
+ - Do not edit generated directories such as `.source/`, `.next/`, `node_modules/`, or build output.
15
+
16
+ ## Common edit targets
17
+
18
+ | Task | Edit |
19
+ | --- | --- |
20
+ | Configure site title, logo, nav, GitHub links, AI prompt, suggestions, translations, `basePath`, or `siteId` | `geistdocs.tsx` |
21
+ | Add or update documentation pages | `content/docs/**/*.mdx` |
22
+ | Control sidebar order, groups, and labels | `content/docs/meta.json` |
23
+ | Override MDX components | `components/geistdocs/mdx-components.tsx` |
24
+ | Wrap the site provider, analytics, or global client behavior | `components/geistdocs/provider.tsx` |
25
+ | Customize the docs layout shell | `components/geistdocs/docs-layout.tsx` |
26
+ | Configure the Fumadocs source adapter or versioned docs | `lib/geistdocs/source.ts` |
27
+ | Configure Fumadocs collections and source-safe MDX processing | `source.config.ts` |
28
+ | Configure the docs page renderer | `app/[lang]/docs/[[...slug]]/page.tsx` |
29
+ | Configure AI-readable markdown output | `app/[lang]/llms.txt/route.ts`, `app/[lang]/llms.mdx/[[...slug]]/route.ts`, `app/[lang]/sitemap.md/route.ts` |
30
+ | Configure chat or search APIs | `app/api/chat/route.ts`, `app/api/search/route.ts` |
31
+ | Add request handling before or after Geistdocs routing | `proxy.ts` |
32
+ | Edit the marketing home page | `app/[lang]/(home)/**` |
33
+ | Edit shared styles | `app/global.css`, `app/styles/geistdocs.css` |
34
+
35
+ ## Content guidelines
36
+
37
+ - Put docs in `content/docs` unless the project has added another source in `lib/geistdocs/source.ts`.
38
+ - Add each new page to `content/docs/meta.json` so it appears in the sidebar.
39
+ - Use MDX frontmatter with at least `title` and `description` for documentation pages.
40
+ - Keep slugs stable unless the task explicitly includes redirects or link updates.
41
+ - When adding translated content, follow the existing locale suffix pattern, such as `page.cn.mdx`.
42
+ - Use `CopyPrompt` when a page should give readers a prompt they can copy into a coding agent.
43
+
44
+ ## Routing and proxy guidelines
45
+
46
+ - Keep App Router route files as thin adapters around package helpers such as `createDocsPage`, `createChatRoute`, `createLlmsRoute`, and `createProxy`.
47
+ - Keep `export const config` in `proxy.ts` as a static object. Next.js must parse proxy matchers at build time.
48
+ - Use proxy matcher exclusions that only match `/api` and `/api/...`, such as `api(?:/|$)`. Do not exclude broad prefixes like `api`, because that also excludes routes such as `/api-reference`.
49
+ - Preserve markdown negotiation unless the task explicitly changes AI-readable output. Geistdocs serves `/llms.txt` and per-page Markdown for `.md`, `.mdx`, `Accept: text/markdown`, and AI-agent requests.
50
+ - When adding custom proxy behavior, prefer `before`, `after`, and `markdownRoutes` options on `createProxy` instead of replacing the proxy.
51
+ - Use explicit `markdownRoutes` for root-mounted docs or any site where homepage/app routes coexist with docs routes.
52
+
53
+ ## Ask AI and Vertex proxy guidelines
54
+
55
+ - Leave `GEISTDOCS_CHAT_PROXY_URL` unset to use the default AI Gateway path. In that mode, `app/api/chat/route.ts` calls `createChatRoute` without a `proxy` option and uses the local docs search tool during the AI SDK `streamText` loop.
56
+ - Geistdocs Ask AI targets AI SDK v6: `ai` v6 and `@ai-sdk/react` v3. Keep those dependencies on the generated package versions unless a `@vercel/geistdocs` release changes them.
57
+ - If the app uses `ai` or `@ai-sdk/react` for product code outside Geistdocs, migrate that app code separately or let the package manager install separate versions. Do not downgrade Geistdocs Ask AI to match unrelated app code.
58
+ - Set `GEISTDOCS_CHAT_PROXY_URL` only when Ask AI should route through the central Vertex-backed proxy. The value must include the `/vertex` route, such as `https://<geistdocs-platform-deployment>/vertex`.
59
+ - Do not add Vertex credentials to a Geistdocs site. The central platform proxy forwards the Vercel OIDC token in `x-vercel-trusted-oidc-idp-token`; the Vertex deployment should trust the platform Vercel project through Deployment Protection Trusted Sources.
60
+ - Use `GEISTDOCS_CHAT_PROXY_TOKEN` only for a custom proxy that requires bearer authentication. The default Geistdocs platform `/vertex` proxy does not require it.
61
+ - Keep `app/api/chat/route.ts` as a thin adapter around `createChatRoute`. Prefer configuring `GEISTDOCS_CHAT_PROXY_URL` and `GEISTDOCS_CHAT_PROXY_TOKEN` over forking the package chat route.
62
+ - If custom chat client code uses `DefaultChatTransport.prepareSendMessagesRequest`, preserve `messages` in the returned `body` when adding fields such as `currentRoute`. Returning a custom `body` replaces the AI SDK default request body.
63
+
64
+ ## Migration guidelines
65
+
66
+ - When migrating from Fumadocs or a custom Geist docs site, inventory `source.config.ts`, route files, `middleware.ts` or `proxy.ts`, `public/llms.txt`, OG routes, Tailwind CSS setup, and required environment variables before editing.
67
+ - Inventory direct app usage of `ai` and `@ai-sdk/react`. Package-owned Ask AI uses AI SDK v6; migrate local AI SDK code separately from Geistdocs route adapters.
68
+ - Import source-config helpers from `@vercel/geistdocs/source-config` in `source.config.ts`. Do not import runtime component entry points from source config.
69
+ - Move existing `middleware.ts` behavior into `createProxy({ before })` or `createProxy({ after })` hooks.
70
+ - Delete `public/llms.txt` when using `createLlmsRoute`; otherwise the static file can mask the App Router route.
71
+ - Set `openGraph.images` in `createDocsPage` only when the app includes the Geistdocs OG route, or override metadata to avoid broken `/og/...` URLs.
72
+ - Add Tailwind CSS v4 `@source` entries for `@vercel/geistdocs` and related runtime dependencies when migrating styles.
73
+ - Add local fallbacks for production-only environment variables so migration builds do not require production secrets.
74
+
75
+ ## Package updates
76
+
77
+ - Use `pnpm exec geistdocs update` to update package-based Geistdocs projects.
78
+ - `geistdocs update` updates the `@vercel/geistdocs` dependency. It does not overwrite local adapter files.
79
+ - Review dependency changes and run the verification commands before committing an update.
80
+
81
+ ## Commands
82
+
83
+ - Start development: `pnpm dev`
84
+ - Build for production: `pnpm build`
85
+ - Start the built app: `pnpm start`
86
+ - Regenerate Fumadocs output after dependency installation: `pnpm postinstall`
87
+ - Update Geistdocs: `pnpm exec geistdocs update`
88
+ - Run translations if configured: `pnpm translate`
89
+
90
+ ## Verification
91
+
92
+ - Run `pnpm build` after changing routes, config, source setup, MDX components, or package versions.
93
+ - Run `pnpm dev` and open the changed pages when visual layout, navigation, or MDX rendering changes.
94
+ - Check both `/docs` and AI-readable routes such as `/llms.txt` or a page-level `.md` URL when changing content routing or proxy behavior.
95
+ - Confirm no secrets were added to source files. Use `.env.local` for local values and keep it out of Git.
@@ -16,9 +16,7 @@ export const CenteredSection = ({
16
16
  <h2 className="font-semibold text-xl tracking-tight sm:text-2xl md:text-3xl lg:text-[40px]">
17
17
  {title}
18
18
  </h2>
19
- <p className="text-balance text-lg text-muted-foreground">
20
- {description}
21
- </p>
19
+ <p className="text-balance text-gray-800 text-lg">{description}</p>
22
20
  </div>
23
21
 
24
22
  {children}
@@ -12,13 +12,13 @@ export const Hero = ({ badge, title, description, children }: HeroProps) => (
12
12
  <section className="mt-(--fd-nav-height) space-y-6 px-4 pt-16 pb-16 text-center sm:pt-24">
13
13
  <div className="mx-auto w-full max-w-4xl space-y-5">
14
14
  <Badge className="rounded-full" variant="secondary">
15
- <div className="size-2 rounded-full bg-muted-foreground" />
15
+ <div className="size-2 rounded-full bg-gray-800" />
16
16
  <p>{badge}</p>
17
17
  </Badge>
18
18
  <h1 className="text-balance text-center font-semibold text-[40px]! leading-[1.1] tracking-tight sm:text-5xl! lg:font-semibold xl:text-6xl!">
19
19
  {title}
20
20
  </h1>
21
- <p className="mx-auto max-w-3xl text-balance text-muted-foreground leading-relaxed sm:text-xl">
21
+ <p className="mx-auto max-w-3xl text-balance text-gray-800 leading-relaxed sm:text-xl">
22
22
  {description}
23
23
  </p>
24
24
  </div>
@@ -16,9 +16,7 @@ export const OneTwoSection = ({
16
16
  <h2 className="font-semibold text-xl tracking-tight sm:text-2xl md:text-3xl">
17
17
  {title}
18
18
  </h2>
19
- <p className="mt-2 text-balance text-lg text-muted-foreground">
20
- {description}
21
- </p>
19
+ <p className="mt-2 text-balance text-gray-800 text-lg">{description}</p>
22
20
  </div>
23
21
  <div className="sm:col-span-2 sm:p-12">{children}</div>
24
22
  </div>
@@ -18,19 +18,17 @@ export const Templates = ({ title, description, data }: TemplatesProps) => (
18
18
  <h2 className="font-semibold text-xl tracking-tight sm:text-2xl md:text-3xl lg:text-[40px]">
19
19
  {title}
20
20
  </h2>
21
- <p className="text-balance text-lg text-muted-foreground">
22
- {description}
23
- </p>
21
+ <p className="text-balance text-gray-800 text-lg">{description}</p>
24
22
  </div>
25
23
  <div className="grid gap-8 md:grid-cols-3">
26
24
  {data.map((item) => (
27
25
  <a
28
- className="group flex-col overflow-hidden rounded-lg border bg-background p-4"
26
+ className="group flex-col overflow-hidden rounded-lg border bg-background-100 p-4"
29
27
  href={item.link}
30
28
  key={item.title}
31
29
  >
32
30
  <h3 className="font-medium tracking-tight">{item.title}</h3>
33
- <p className="line-clamp-2 text-muted-foreground text-sm">
31
+ <p className="line-clamp-2 text-gray-800 text-sm">
34
32
  {item.description}
35
33
  </p>
36
34
  <Image
@@ -13,7 +13,7 @@ export const TextGridSection = ({ data }: TextGridSectionProps) => (
13
13
  <h3 className="mb-2 font-semibold text-lg tracking-tight">
14
14
  {item.title}
15
15
  </h3>
16
- <p className="text-muted-foreground">{item.description}</p>
16
+ <p className="text-gray-800">{item.description}</p>
17
17
  </div>
18
18
  ))}
19
19
  </div>
@@ -1,13 +1,14 @@
1
- import { HomeLayout } from "@/components/geistdocs/home-layout";
1
+ import { GeistdocsHomeLayout } from "@vercel/geistdocs/home-layout";
2
+ import { config } from "@/lib/geistdocs/config";
2
3
  import { source } from "@/lib/geistdocs/source";
3
4
 
4
5
  const Layout = async ({ children, params }: LayoutProps<"/[lang]">) => {
5
6
  const { lang } = await params;
6
7
 
7
8
  return (
8
- <HomeLayout tree={source.pageTree[lang]}>
9
+ <GeistdocsHomeLayout config={config} tree={source.pageTree[lang]}>
9
10
  <div className="pt-0 pb-32">{children}</div>
10
- </HomeLayout>
11
+ </GeistdocsHomeLayout>
11
12
  );
12
13
  };
13
14
 
@@ -105,13 +105,13 @@ const HomePage = () => (
105
105
  description="Description of centered section"
106
106
  title="Centered Section"
107
107
  >
108
- <div className="aspect-video rounded-lg border bg-background" />
108
+ <div className="aspect-video rounded-lg border bg-background-100" />
109
109
  </CenteredSection>
110
110
  <OneTwoSection
111
111
  description="Description of one/two section"
112
112
  title="One/Two Section"
113
113
  >
114
- <div className="aspect-video rounded-lg border bg-background" />
114
+ <div className="aspect-video rounded-lg border bg-background-100" />
115
115
  </OneTwoSection>
116
116
  <Templates
117
117
  data={templates}
@@ -0,0 +1,6 @@
1
+ import { createAgentsRoute } from "@vercel/geistdocs/routes/agents";
2
+ import { config } from "@/lib/geistdocs/config";
3
+
4
+ export const { GET, generateStaticParams, revalidate } = createAgentsRoute({
5
+ config,
6
+ });
@@ -1,12 +1,15 @@
1
+ import { MobileDocsBar } from "@vercel/geistdocs/mobile-docs-bar";
1
2
  import { createDocsPage } from "@vercel/geistdocs/pages/docs";
2
3
  import { getMDXComponents } from "@/components/geistdocs/mdx-components";
3
- import { MobileDocsBar } from "@/components/geistdocs/mobile-docs-bar";
4
4
  import { config } from "@/lib/geistdocs/config";
5
5
  import { geistdocsSource } from "@/lib/geistdocs/source";
6
6
 
7
7
  const docsPage = createDocsPage({
8
8
  config,
9
9
  mdx: ({ link }) => getMDXComponents({ a: link }),
10
+ openGraph: {
11
+ images: true,
12
+ },
10
13
  source: geistdocsSource,
11
14
  tableOfContentPopover: {
12
15
  enabled: false,
@@ -1,8 +1,8 @@
1
1
  import "../global.css";
2
- import { Footer } from "@/components/geistdocs/footer";
3
- import { Navbar } from "@/components/geistdocs/navbar";
2
+ import { Footer } from "@vercel/geistdocs/footer";
3
+ import { Navbar } from "@vercel/geistdocs/navbar";
4
4
  import { GeistdocsProvider } from "@/components/geistdocs/provider";
5
- import { basePath } from "@/geistdocs";
5
+ import { config } from "@/lib/geistdocs/config";
6
6
  import { mono, sans } from "@/lib/geistdocs/fonts";
7
7
  import { cn } from "@/lib/utils";
8
8
 
@@ -16,10 +16,10 @@ const Layout = async ({ children, params }: LayoutProps<"/[lang]">) => {
16
16
  suppressHydrationWarning
17
17
  >
18
18
  <body>
19
- <GeistdocsProvider basePath={basePath} lang={lang}>
20
- <Navbar />
19
+ <GeistdocsProvider basePath={config.basePath} lang={lang}>
20
+ <Navbar config={config} />
21
21
  {children}
22
- <Footer />
22
+ <Footer config={config} />
23
23
  </GeistdocsProvider>
24
24
  </body>
25
25
  </html>
@@ -3,5 +3,5 @@ import { geistdocsSource } from "@/lib/geistdocs/source";
3
3
 
4
4
  export const { GET, generateStaticParams, revalidate } =
5
5
  createDocsMarkdownRoute({
6
- source: geistdocsSource,
6
+ sources: [geistdocsSource],
7
7
  });
@@ -1,9 +1,9 @@
1
1
  import { createSitemapMarkdownRoute } from "@vercel/geistdocs/routes/sitemap";
2
2
  import { config } from "@/lib/geistdocs/config";
3
- import { source } from "@/lib/geistdocs/source";
3
+ import { geistdocsSource } from "@/lib/geistdocs/source";
4
4
 
5
5
  export const { GET, generateStaticParams, revalidate, dynamic } =
6
6
  createSitemapMarkdownRoute({
7
7
  config,
8
- sources: [{ source }],
8
+ sources: [{ source: geistdocsSource }],
9
9
  });
@@ -2,7 +2,18 @@ import { createChatRoute } from "@vercel/geistdocs/routes/chat";
2
2
  import { config } from "@/lib/geistdocs/config";
3
3
  import { geistdocsSource } from "@/lib/geistdocs/source";
4
4
 
5
+ const chatProxyUrl = process.env.GEISTDOCS_CHAT_PROXY_URL;
6
+ const chatProxyToken = process.env.GEISTDOCS_CHAT_PROXY_TOKEN;
7
+
5
8
  export const { POST, maxDuration } = createChatRoute({
6
9
  config,
10
+ proxy: chatProxyUrl
11
+ ? {
12
+ url: chatProxyUrl,
13
+ headers: chatProxyToken
14
+ ? { Authorization: `Bearer ${chatProxyToken}` }
15
+ : undefined,
16
+ }
17
+ : undefined,
7
18
  sources: [geistdocsSource],
8
19
  });
@@ -1,5 +1,5 @@
1
1
  import { createSearchRoute } from "@vercel/geistdocs/routes/search";
2
2
  import { config } from "@/lib/geistdocs/config";
3
- import { source } from "@/lib/geistdocs/source";
3
+ import { geistdocsSource } from "@/lib/geistdocs/source";
4
4
 
5
- export const GET = createSearchRoute({ config, sources: [source] });
5
+ export const GET = createSearchRoute({ config, sources: [geistdocsSource] });
@@ -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
  }