@vercel/geistdocs 1.24.1 → 1.25.1-canary.9556d32

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 (377) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/components/callout.d.ts.map +1 -1
  3. package/dist/components/callout.js +1 -1
  4. package/dist/components/code-block-tabs.d.ts.map +1 -1
  5. package/dist/components/code-block-tabs.js +1 -1
  6. package/dist/components/code-block.d.ts +2 -6
  7. package/dist/components/code-block.d.ts.map +1 -1
  8. package/dist/components/code-block.js +4 -75
  9. package/dist/components/command-prompt.d.ts.map +1 -1
  10. package/dist/components/command-prompt.js +3 -3
  11. package/dist/components/copy-prompt.d.ts.map +1 -1
  12. package/dist/components/copy-prompt.js +4 -4
  13. package/dist/components/mermaid.js +1 -1
  14. package/dist/controls.d.ts +8 -4
  15. package/dist/controls.d.ts.map +1 -1
  16. package/dist/controls.js +14 -14
  17. package/dist/footer.d.ts.map +1 -1
  18. package/dist/footer.js +6 -6
  19. package/dist/home-layout.js +1 -1
  20. package/dist/internal/app-route-manifest.d.ts +19 -0
  21. package/dist/internal/app-route-manifest.d.ts.map +1 -0
  22. package/dist/internal/app-route-manifest.js +121 -0
  23. package/dist/internal/app-route-scanner.d.ts +9 -0
  24. package/dist/internal/app-route-scanner.d.ts.map +1 -0
  25. package/dist/internal/app-route-scanner.js +149 -0
  26. package/dist/internal/chat/conversation.d.ts +4 -3
  27. package/dist/internal/chat/conversation.d.ts.map +1 -1
  28. package/dist/internal/chat/conversation.js +5 -5
  29. package/dist/internal/chat/copy-chat.d.ts.map +1 -1
  30. package/dist/internal/chat/copy-chat.js +13 -10
  31. package/dist/internal/chat/dots-spinner.d.ts +5 -0
  32. package/dist/internal/chat/dots-spinner.d.ts.map +1 -0
  33. package/dist/internal/chat/dots-spinner.js +15 -0
  34. package/dist/internal/chat/message-metadata.d.ts.map +1 -1
  35. package/dist/internal/chat/message-metadata.js +8 -7
  36. package/dist/internal/chat/message.d.ts.map +1 -1
  37. package/dist/internal/chat/message.js +5 -5
  38. package/dist/internal/chat/prompt-input.d.ts +1 -1
  39. package/dist/internal/chat/prompt-input.d.ts.map +1 -1
  40. package/dist/internal/chat/prompt-input.js +24 -27
  41. package/dist/internal/chat/shell.d.ts.map +1 -1
  42. package/dist/internal/chat/shell.js +27 -19
  43. package/dist/internal/chat/sources.d.ts +3 -1
  44. package/dist/internal/chat/sources.d.ts.map +1 -1
  45. package/dist/internal/chat/sources.js +6 -6
  46. package/dist/internal/chat/suggestion.d.ts +11 -6
  47. package/dist/internal/chat/suggestion.d.ts.map +1 -1
  48. package/dist/internal/chat/suggestion.js +5 -5
  49. package/dist/internal/docs-page-error-boundary.d.ts.map +1 -1
  50. package/dist/internal/docs-page-error-boundary.js +3 -3
  51. package/dist/internal/external-arrow.d.ts.map +1 -1
  52. package/dist/internal/external-arrow.js +1 -1
  53. package/dist/internal/footer/rss-button.d.ts.map +1 -1
  54. package/dist/internal/footer/rss-button.js +3 -3
  55. package/dist/internal/github-button.d.ts.map +1 -1
  56. package/dist/internal/github-button.js +3 -3
  57. package/dist/internal/navbar/desktop-menu.d.ts.map +1 -1
  58. package/dist/internal/navbar/desktop-menu.js +3 -3
  59. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -1
  60. package/dist/internal/navbar/mobile-menu.js +3 -3
  61. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -1
  62. package/dist/internal/navbar/navbar-logo.js +6 -8
  63. package/dist/internal/navbar/navbar-shell.d.ts.map +1 -1
  64. package/dist/internal/navbar/navbar-shell.js +1 -1
  65. package/dist/internal/page-actions-client.d.ts.map +1 -1
  66. package/dist/internal/page-actions-client.js +20 -20
  67. package/dist/internal/page-breadcrumb.d.ts.map +1 -1
  68. package/dist/internal/page-breadcrumb.js +3 -3
  69. package/dist/internal/page-footer.d.ts.map +1 -1
  70. package/dist/internal/page-footer.js +2 -2
  71. package/dist/internal/provider-client.d.ts.map +1 -1
  72. package/dist/internal/provider-client.js +9 -9
  73. package/dist/internal/sidebar-tree.d.ts.map +1 -1
  74. package/dist/internal/sidebar-tree.js +9 -7
  75. package/dist/internal/sidebar.d.ts.map +1 -1
  76. package/dist/internal/sidebar.js +6 -8
  77. package/dist/internal/toc-items.d.ts.map +1 -1
  78. package/dist/internal/toc-items.js +1 -1
  79. package/dist/internal/ui/dropdown-menu.d.ts.map +1 -1
  80. package/dist/internal/ui/dropdown-menu.js +5 -5
  81. package/dist/internal/ui/navigation-menu.d.ts.map +1 -1
  82. package/dist/internal/ui/navigation-menu.js +2 -2
  83. package/dist/internal/ui/popover.d.ts.map +1 -1
  84. package/dist/internal/ui/popover.js +1 -1
  85. package/dist/internal/ui/scroll-area.d.ts.map +1 -1
  86. package/dist/internal/ui/scroll-area.js +1 -1
  87. package/dist/layout.js +1 -1
  88. package/dist/mobile-docs-bar.d.ts.map +1 -1
  89. package/dist/mobile-docs-bar.js +1 -2
  90. package/dist/navbar.js +3 -2
  91. package/dist/next.d.ts +6 -0
  92. package/dist/next.d.ts.map +1 -0
  93. package/dist/next.js +52 -0
  94. package/dist/pages/docs.d.ts.map +1 -1
  95. package/dist/pages/docs.js +1 -1
  96. package/dist/proxy.d.ts +2 -1
  97. package/dist/proxy.d.ts.map +1 -1
  98. package/dist/proxy.js +28 -5
  99. package/dist/routes/llms.d.ts +1 -1
  100. package/dist/routes/llms.d.ts.map +1 -1
  101. package/dist/routes/llms.js +1 -1
  102. package/dist/source.d.ts.map +1 -1
  103. package/dist/source.js +0 -2
  104. package/dist/versions.d.ts.map +1 -1
  105. package/dist/versions.js +5 -5
  106. package/docs/agents.md +2 -3
  107. package/docs/llms.txt +52 -86
  108. package/docs/manifest.json +2 -11
  109. package/docs/pages/configuration.md +8 -0
  110. package/docs/pages/md.md +8 -5
  111. package/docs/pages/migration.md +11 -11
  112. package/docs/pages/proxy.md +20 -1
  113. package/docs/pages/versioned-docs.md +3 -3
  114. package/docs/sitemap.md +1 -2
  115. package/package.json +12 -100
  116. package/styles.css +3 -2
  117. package/template/AGENTS.md +12 -0
  118. package/template/app/[lang]/(home)/components/hero.tsx +2 -2
  119. package/template/app/[lang]/(home)/components/one-two-section.tsx +9 -1
  120. package/template/app/[lang]/(home)/components/text-grid-section.tsx +1 -1
  121. package/template/app/[lang]/(home)/page.tsx +5 -6
  122. package/template/app/[lang]/layout.tsx +7 -4
  123. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +0 -1
  124. package/template/app/styles/geistdocs.css +17 -14
  125. package/template/content/docs/configuration.cn.mdx +2 -2
  126. package/template/content/docs/configuration.mdx +8 -0
  127. package/template/content/docs/md.mdx +8 -5
  128. package/template/content/docs/migration.mdx +11 -11
  129. package/template/content/docs/proxy.mdx +20 -1
  130. package/template/content/docs/versioned-docs.mdx +3 -3
  131. package/template/lib/geistdocs/config.tsx +0 -5
  132. package/template/next.config.ts +19 -5
  133. package/template/package.json +4 -6
  134. package/theme.css +4 -661
  135. package/dist/assets/icons/icon-acronym-ts.d.ts +0 -5
  136. package/dist/assets/icons/icon-acronym-ts.d.ts.map +0 -1
  137. package/dist/assets/icons/icon-acronym-ts.js +0 -4
  138. package/dist/assets/icons/icon-agents.d.ts +0 -5
  139. package/dist/assets/icons/icon-agents.d.ts.map +0 -1
  140. package/dist/assets/icons/icon-agents.js +0 -4
  141. package/dist/assets/icons/icon-api.d.ts +0 -5
  142. package/dist/assets/icons/icon-api.d.ts.map +0 -1
  143. package/dist/assets/icons/icon-api.js +0 -4
  144. package/dist/assets/icons/icon-arrow-up-right-small.d.ts +0 -8
  145. package/dist/assets/icons/icon-arrow-up-right-small.d.ts.map +0 -1
  146. package/dist/assets/icons/icon-arrow-up-right-small.js +0 -4
  147. package/dist/assets/icons/icon-arrow-up-right.d.ts +0 -5
  148. package/dist/assets/icons/icon-arrow-up-right.d.ts.map +0 -1
  149. package/dist/assets/icons/icon-arrow-up-right.js +0 -4
  150. package/dist/assets/icons/icon-check.d.ts +0 -5
  151. package/dist/assets/icons/icon-check.d.ts.map +0 -1
  152. package/dist/assets/icons/icon-check.js +0 -4
  153. package/dist/assets/icons/icon-chevron-down-small.d.ts +0 -8
  154. package/dist/assets/icons/icon-chevron-down-small.d.ts.map +0 -1
  155. package/dist/assets/icons/icon-chevron-down-small.js +0 -7
  156. package/dist/assets/icons/icon-chevron-right.d.ts +0 -5
  157. package/dist/assets/icons/icon-chevron-right.d.ts.map +0 -1
  158. package/dist/assets/icons/icon-chevron-right.js +0 -4
  159. package/dist/assets/icons/icon-clock.d.ts +0 -5
  160. package/dist/assets/icons/icon-clock.d.ts.map +0 -1
  161. package/dist/assets/icons/icon-clock.js +0 -4
  162. package/dist/assets/icons/icon-copy.d.ts +0 -5
  163. package/dist/assets/icons/icon-copy.d.ts.map +0 -1
  164. package/dist/assets/icons/icon-copy.js +0 -4
  165. package/dist/assets/icons/icon-display-small.d.ts +0 -5
  166. package/dist/assets/icons/icon-display-small.d.ts.map +0 -1
  167. package/dist/assets/icons/icon-display-small.js +0 -4
  168. package/dist/assets/icons/icon-display.d.ts +0 -5
  169. package/dist/assets/icons/icon-display.d.ts.map +0 -1
  170. package/dist/assets/icons/icon-display.js +0 -4
  171. package/dist/assets/icons/icon-file-text.d.ts +0 -5
  172. package/dist/assets/icons/icon-file-text.d.ts.map +0 -1
  173. package/dist/assets/icons/icon-file-text.js +0 -4
  174. package/dist/assets/icons/icon-folder-open.d.ts +0 -5
  175. package/dist/assets/icons/icon-folder-open.d.ts.map +0 -1
  176. package/dist/assets/icons/icon-folder-open.js +0 -4
  177. package/dist/assets/icons/icon-linked.d.ts +0 -5
  178. package/dist/assets/icons/icon-linked.d.ts.map +0 -1
  179. package/dist/assets/icons/icon-linked.js +0 -4
  180. package/dist/assets/icons/icon-logs.d.ts +0 -5
  181. package/dist/assets/icons/icon-logs.d.ts.map +0 -1
  182. package/dist/assets/icons/icon-logs.js +0 -4
  183. package/dist/assets/icons/icon-menu-alt.d.ts +0 -5
  184. package/dist/assets/icons/icon-menu-alt.d.ts.map +0 -1
  185. package/dist/assets/icons/icon-menu-alt.js +0 -4
  186. package/dist/assets/icons/icon-message.d.ts +0 -5
  187. package/dist/assets/icons/icon-message.d.ts.map +0 -1
  188. package/dist/assets/icons/icon-message.js +0 -4
  189. package/dist/assets/icons/icon-moon-small.d.ts +0 -5
  190. package/dist/assets/icons/icon-moon-small.d.ts.map +0 -1
  191. package/dist/assets/icons/icon-moon-small.js +0 -4
  192. package/dist/assets/icons/icon-moon.d.ts +0 -5
  193. package/dist/assets/icons/icon-moon.d.ts.map +0 -1
  194. package/dist/assets/icons/icon-moon.js +0 -4
  195. package/dist/assets/icons/icon-openai.d.ts +0 -5
  196. package/dist/assets/icons/icon-openai.d.ts.map +0 -1
  197. package/dist/assets/icons/icon-openai.js +0 -4
  198. package/dist/assets/icons/icon-plus-circle.d.ts +0 -5
  199. package/dist/assets/icons/icon-plus-circle.d.ts.map +0 -1
  200. package/dist/assets/icons/icon-plus-circle.js +0 -4
  201. package/dist/assets/icons/icon-refresh-counter-clockwise.d.ts +0 -5
  202. package/dist/assets/icons/icon-refresh-counter-clockwise.d.ts.map +0 -1
  203. package/dist/assets/icons/icon-refresh-counter-clockwise.js +0 -4
  204. package/dist/assets/icons/icon-robot.d.ts +0 -5
  205. package/dist/assets/icons/icon-robot.d.ts.map +0 -1
  206. package/dist/assets/icons/icon-robot.js +0 -4
  207. package/dist/assets/icons/icon-sandbox.d.ts +0 -5
  208. package/dist/assets/icons/icon-sandbox.d.ts.map +0 -1
  209. package/dist/assets/icons/icon-sandbox.js +0 -4
  210. package/dist/assets/icons/icon-slash-forward.d.ts +0 -8
  211. package/dist/assets/icons/icon-slash-forward.d.ts.map +0 -1
  212. package/dist/assets/icons/icon-slash-forward.js +0 -4
  213. package/dist/assets/icons/icon-sparkles.d.ts +0 -5
  214. package/dist/assets/icons/icon-sparkles.d.ts.map +0 -1
  215. package/dist/assets/icons/icon-sparkles.js +0 -4
  216. package/dist/assets/icons/icon-sun-small.d.ts +0 -5
  217. package/dist/assets/icons/icon-sun-small.d.ts.map +0 -1
  218. package/dist/assets/icons/icon-sun-small.js +0 -4
  219. package/dist/assets/icons/icon-sun.d.ts +0 -5
  220. package/dist/assets/icons/icon-sun.d.ts.map +0 -1
  221. package/dist/assets/icons/icon-sun.js +0 -4
  222. package/dist/assets/icons/icon-trash.d.ts +0 -5
  223. package/dist/assets/icons/icon-trash.d.ts.map +0 -1
  224. package/dist/assets/icons/icon-trash.js +0 -4
  225. package/dist/assets/icons/icon-user.d.ts +0 -5
  226. package/dist/assets/icons/icon-user.d.ts.map +0 -1
  227. package/dist/assets/icons/icon-user.js +0 -4
  228. package/dist/assets/icons/icon-workflow.d.ts +0 -5
  229. package/dist/assets/icons/icon-workflow.d.ts.map +0 -1
  230. package/dist/assets/icons/icon-workflow.js +0 -4
  231. package/dist/assets/icons/icon-wrench.d.ts +0 -5
  232. package/dist/assets/icons/icon-wrench.d.ts.map +0 -1
  233. package/dist/assets/icons/icon-wrench.js +0 -4
  234. package/dist/assets/icons/index.d.ts +0 -35
  235. package/dist/assets/icons/index.d.ts.map +0 -1
  236. package/dist/assets/icons/index.js +0 -35
  237. package/dist/assets/logos/index.d.ts +0 -17
  238. package/dist/assets/logos/index.d.ts.map +0 -1
  239. package/dist/assets/logos/index.js +0 -17
  240. package/dist/assets/logos/logo-ai-elements.d.ts +0 -5
  241. package/dist/assets/logos/logo-ai-elements.d.ts.map +0 -1
  242. package/dist/assets/logos/logo-ai-elements.js +0 -5
  243. package/dist/assets/logos/logo-ai-sdk.d.ts +0 -5
  244. package/dist/assets/logos/logo-ai-sdk.d.ts.map +0 -1
  245. package/dist/assets/logos/logo-ai-sdk.js +0 -5
  246. package/dist/assets/logos/logo-chat-sdk.d.ts +0 -5
  247. package/dist/assets/logos/logo-chat-sdk.d.ts.map +0 -1
  248. package/dist/assets/logos/logo-chat-sdk.js +0 -5
  249. package/dist/assets/logos/logo-eve.d.ts +0 -5
  250. package/dist/assets/logos/logo-eve.d.ts.map +0 -1
  251. package/dist/assets/logos/logo-eve.js +0 -5
  252. package/dist/assets/logos/logo-flags-sdk.d.ts +0 -5
  253. package/dist/assets/logos/logo-flags-sdk.d.ts.map +0 -1
  254. package/dist/assets/logos/logo-flags-sdk.js +0 -5
  255. package/dist/assets/logos/logo-icon-vercel.d.ts +0 -5
  256. package/dist/assets/logos/logo-icon-vercel.d.ts.map +0 -1
  257. package/dist/assets/logos/logo-icon-vercel.js +0 -4
  258. package/dist/assets/logos/logo-nextjs.d.ts +0 -5
  259. package/dist/assets/logos/logo-nextjs.d.ts.map +0 -1
  260. package/dist/assets/logos/logo-nextjs.js +0 -9
  261. package/dist/assets/logos/logo-streamdown.d.ts +0 -5
  262. package/dist/assets/logos/logo-streamdown.d.ts.map +0 -1
  263. package/dist/assets/logos/logo-streamdown.js +0 -5
  264. package/dist/assets/logos/logo-svelte-kit.d.ts +0 -5
  265. package/dist/assets/logos/logo-svelte-kit.d.ts.map +0 -1
  266. package/dist/assets/logos/logo-svelte-kit.js +0 -4
  267. package/dist/assets/logos/logo-turborepo.d.ts +0 -5
  268. package/dist/assets/logos/logo-turborepo.d.ts.map +0 -1
  269. package/dist/assets/logos/logo-turborepo.js +0 -5
  270. package/dist/assets/logos/logo-vercel-oss.d.ts +0 -5
  271. package/dist/assets/logos/logo-vercel-oss.d.ts.map +0 -1
  272. package/dist/assets/logos/logo-vercel-oss.js +0 -4
  273. package/dist/assets/logos/logo-workflow-sdk.d.ts +0 -5
  274. package/dist/assets/logos/logo-workflow-sdk.d.ts.map +0 -1
  275. package/dist/assets/logos/logo-workflow-sdk.js +0 -5
  276. package/dist/components/badge.d.ts +0 -11
  277. package/dist/components/badge.d.ts.map +0 -1
  278. package/dist/components/badge.js +0 -22
  279. package/dist/components/button-group.d.ts +0 -2
  280. package/dist/components/button-group.d.ts.map +0 -1
  281. package/dist/components/button-group.js +0 -2
  282. package/dist/components/button.d.ts +0 -2
  283. package/dist/components/button.d.ts.map +0 -1
  284. package/dist/components/button.js +0 -2
  285. package/dist/components/card.d.ts +0 -2
  286. package/dist/components/card.d.ts.map +0 -1
  287. package/dist/components/card.js +0 -2
  288. package/dist/components/dialog.d.ts +0 -13
  289. package/dist/components/dialog.d.ts.map +0 -1
  290. package/dist/components/dialog.js +0 -35
  291. package/dist/components/drawer.d.ts +0 -2
  292. package/dist/components/drawer.d.ts.map +0 -1
  293. package/dist/components/drawer.js +0 -3
  294. package/dist/components/input-group.d.ts +0 -2
  295. package/dist/components/input-group.d.ts.map +0 -1
  296. package/dist/components/input-group.js +0 -3
  297. package/dist/components/input.d.ts +0 -2
  298. package/dist/components/input.d.ts.map +0 -1
  299. package/dist/components/input.js +0 -2
  300. package/dist/components/kbd.d.ts +0 -2
  301. package/dist/components/kbd.d.ts.map +0 -1
  302. package/dist/components/kbd.js +0 -2
  303. package/dist/components/separator.d.ts +0 -2
  304. package/dist/components/separator.d.ts.map +0 -1
  305. package/dist/components/separator.js +0 -3
  306. package/dist/components/sheet.d.ts +0 -2
  307. package/dist/components/sheet.d.ts.map +0 -1
  308. package/dist/components/sheet.js +0 -3
  309. package/dist/components/sonner.d.ts +0 -2
  310. package/dist/components/sonner.d.ts.map +0 -1
  311. package/dist/components/sonner.js +0 -3
  312. package/dist/components/spinner.d.ts +0 -2
  313. package/dist/components/spinner.d.ts.map +0 -1
  314. package/dist/components/spinner.js +0 -2
  315. package/dist/components/switch.d.ts +0 -11
  316. package/dist/components/switch.d.ts.map +0 -1
  317. package/dist/components/switch.js +0 -12
  318. package/dist/components/textarea.d.ts +0 -2
  319. package/dist/components/textarea.d.ts.map +0 -1
  320. package/dist/components/textarea.js +0 -2
  321. package/dist/components/theme-aware-image.d.ts +0 -12
  322. package/dist/components/theme-aware-image.d.ts.map +0 -1
  323. package/dist/components/theme-aware-image.js +0 -8
  324. package/dist/components/theme-switcher.d.ts +0 -8
  325. package/dist/components/theme-switcher.d.ts.map +0 -1
  326. package/dist/components/theme-switcher.js +0 -37
  327. package/dist/components/tooltip.d.ts +0 -2
  328. package/dist/components/tooltip.d.ts.map +0 -1
  329. package/dist/components/tooltip.js +0 -3
  330. package/dist/internal/chat/shimmer.d.ts +0 -11
  331. package/dist/internal/chat/shimmer.d.ts.map +0 -1
  332. package/dist/internal/chat/shimmer.js +0 -22
  333. package/dist/internal/cn.d.ts +0 -3
  334. package/dist/internal/cn.d.ts.map +0 -1
  335. package/dist/internal/cn.js +0 -47
  336. package/dist/internal/ui/button-group.d.ts +0 -13
  337. package/dist/internal/ui/button-group.d.ts.map +0 -1
  338. package/dist/internal/ui/button-group.js +0 -26
  339. package/dist/internal/ui/button.d.ts +0 -12
  340. package/dist/internal/ui/button.d.ts.map +0 -1
  341. package/dist/internal/ui/button.js +0 -33
  342. package/dist/internal/ui/card.d.ts +0 -6
  343. package/dist/internal/ui/card.d.ts.map +0 -1
  344. package/dist/internal/ui/card.js +0 -14
  345. package/dist/internal/ui/drawer.d.ts +0 -8
  346. package/dist/internal/ui/drawer.d.ts.map +0 -1
  347. package/dist/internal/ui/drawer.js +0 -19
  348. package/dist/internal/ui/input-group.d.ts +0 -15
  349. package/dist/internal/ui/input-group.d.ts.map +0 -1
  350. package/dist/internal/ui/input-group.js +0 -44
  351. package/dist/internal/ui/input.d.ts +0 -3
  352. package/dist/internal/ui/input.d.ts.map +0 -1
  353. package/dist/internal/ui/input.js +0 -5
  354. package/dist/internal/ui/kbd.d.ts +0 -4
  355. package/dist/internal/ui/kbd.d.ts.map +0 -1
  356. package/dist/internal/ui/kbd.js +0 -8
  357. package/dist/internal/ui/separator.d.ts +0 -4
  358. package/dist/internal/ui/separator.d.ts.map +0 -1
  359. package/dist/internal/ui/separator.js +0 -7
  360. package/dist/internal/ui/sheet.d.ts +0 -13
  361. package/dist/internal/ui/sheet.d.ts.map +0 -1
  362. package/dist/internal/ui/sheet.js +0 -24
  363. package/dist/internal/ui/sonner.d.ts +0 -3
  364. package/dist/internal/ui/sonner.d.ts.map +0 -1
  365. package/dist/internal/ui/sonner.js +0 -20
  366. package/dist/internal/ui/spinner.d.ts +0 -3
  367. package/dist/internal/ui/spinner.d.ts.map +0 -1
  368. package/dist/internal/ui/spinner.js +0 -6
  369. package/dist/internal/ui/textarea.d.ts +0 -3
  370. package/dist/internal/ui/textarea.d.ts.map +0 -1
  371. package/dist/internal/ui/textarea.js +0 -5
  372. package/dist/internal/ui/tooltip.d.ts +0 -7
  373. package/dist/internal/ui/tooltip.d.ts.map +0 -1
  374. package/dist/internal/ui/tooltip.js +0 -16
  375. package/docs/pages/theme-aware-image.md +0 -59
  376. package/template/app/[lang]/(home)/components/centered-section.tsx +0 -32
  377. package/template/content/docs/theme-aware-image.mdx +0 -57
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@vercel/geistdocs",
3
3
  "description": "Runtime and CLI for Geistdocs projects.",
4
- "version": "1.24.1",
4
+ "version": "1.25.1-canary.9556d32",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
@@ -110,6 +110,10 @@
110
110
  "types": "./dist/proxy.d.ts",
111
111
  "default": "./dist/proxy.js"
112
112
  },
113
+ "./next": {
114
+ "types": "./dist/next.d.ts",
115
+ "default": "./dist/next.js"
116
+ },
113
117
  "./mdx": {
114
118
  "types": "./dist/mdx.d.ts",
115
119
  "default": "./dist/mdx.js"
@@ -127,26 +131,10 @@
127
131
  "types": "./dist/shiki-theme.d.ts",
128
132
  "default": "./dist/shiki-theme.js"
129
133
  },
130
- "./components/badge": {
131
- "types": "./dist/components/badge.d.ts",
132
- "default": "./dist/components/badge.js"
133
- },
134
- "./components/button": {
135
- "types": "./dist/components/button.d.ts",
136
- "default": "./dist/components/button.js"
137
- },
138
- "./components/button-group": {
139
- "types": "./dist/components/button-group.d.ts",
140
- "default": "./dist/components/button-group.js"
141
- },
142
134
  "./components/callout": {
143
135
  "types": "./dist/components/callout.d.ts",
144
136
  "default": "./dist/components/callout.js"
145
137
  },
146
- "./components/card": {
147
- "types": "./dist/components/card.d.ts",
148
- "default": "./dist/components/card.js"
149
- },
150
138
  "./components/code-block": {
151
139
  "types": "./dist/components/code-block.d.ts",
152
140
  "default": "./dist/components/code-block.js"
@@ -167,34 +155,10 @@
167
155
  "types": "./dist/components/copy-prompt.d.ts",
168
156
  "default": "./dist/components/copy-prompt.js"
169
157
  },
170
- "./components/dialog": {
171
- "types": "./dist/components/dialog.d.ts",
172
- "default": "./dist/components/dialog.js"
173
- },
174
- "./components/drawer": {
175
- "types": "./dist/components/drawer.d.ts",
176
- "default": "./dist/components/drawer.js"
177
- },
178
158
  "./components/dropdown-menu": {
179
159
  "types": "./dist/components/dropdown-menu.d.ts",
180
160
  "default": "./dist/components/dropdown-menu.js"
181
161
  },
182
- "./components/input": {
183
- "types": "./dist/components/input.d.ts",
184
- "default": "./dist/components/input.js"
185
- },
186
- "./components/input-group": {
187
- "types": "./dist/components/input-group.d.ts",
188
- "default": "./dist/components/input-group.js"
189
- },
190
- "./components/kbd": {
191
- "types": "./dist/components/kbd.d.ts",
192
- "default": "./dist/components/kbd.js"
193
- },
194
- "./components/theme-aware-image": {
195
- "types": "./dist/components/theme-aware-image.d.ts",
196
- "default": "./dist/components/theme-aware-image.js"
197
- },
198
162
  "./components/mermaid": {
199
163
  "types": "./dist/components/mermaid.d.ts",
200
164
  "default": "./dist/components/mermaid.js"
@@ -211,74 +175,30 @@
211
175
  "types": "./dist/components/scroll-area.d.ts",
212
176
  "default": "./dist/components/scroll-area.js"
213
177
  },
214
- "./components/separator": {
215
- "types": "./dist/components/separator.d.ts",
216
- "default": "./dist/components/separator.js"
217
- },
218
- "./components/sheet": {
219
- "types": "./dist/components/sheet.d.ts",
220
- "default": "./dist/components/sheet.js"
221
- },
222
- "./components/sonner": {
223
- "types": "./dist/components/sonner.d.ts",
224
- "default": "./dist/components/sonner.js"
225
- },
226
- "./components/spinner": {
227
- "types": "./dist/components/spinner.d.ts",
228
- "default": "./dist/components/spinner.js"
229
- },
230
- "./components/switch": {
231
- "types": "./dist/components/switch.d.ts",
232
- "default": "./dist/components/switch.js"
233
- },
234
- "./components/theme-switcher": {
235
- "types": "./dist/components/theme-switcher.d.ts",
236
- "default": "./dist/components/theme-switcher.js"
237
- },
238
- "./components/textarea": {
239
- "types": "./dist/components/textarea.d.ts",
240
- "default": "./dist/components/textarea.js"
241
- },
242
- "./components/tooltip": {
243
- "types": "./dist/components/tooltip.d.ts",
244
- "default": "./dist/components/tooltip.js"
245
- },
246
178
  "./components/video": {
247
179
  "types": "./dist/components/video.d.ts",
248
180
  "default": "./dist/components/video.js"
249
181
  },
250
- "./assets/icons": {
251
- "types": "./dist/assets/icons/index.d.ts",
252
- "default": "./dist/assets/icons/index.js"
253
- },
254
- "./assets/icons/*": {
255
- "types": "./dist/assets/icons/*.d.ts",
256
- "default": "./dist/assets/icons/*.js"
257
- },
258
- "./assets/logos": {
259
- "types": "./dist/assets/logos/index.d.ts",
260
- "default": "./dist/assets/logos/index.js"
261
- },
262
- "./assets/logos/*": {
263
- "types": "./dist/assets/logos/*.d.ts",
264
- "default": "./dist/assets/logos/*.js"
265
- },
266
182
  "./styles.css": "./styles.css",
267
183
  "./theme.css": "./theme.css",
268
184
  "./package.json": "./package.json"
269
185
  },
186
+ "scripts": {
187
+ "build": "rm -rf dist docs template && node ./scripts/bundle-template.mjs && node ./scripts/bundle-docs.mjs && tsc -p tsconfig.runtime.json && tsup --config tsup.config.cli.ts",
188
+ "dev": "tsc -p tsconfig.runtime.json --watch --preserveWatchOutput"
189
+ },
270
190
  "dependencies": {
271
191
  "@ai-sdk/react": "^3.0.134",
272
192
  "@clack/prompts": "^0.11.0",
273
- "@icons-pack/react-simple-icons": "^13.8.0",
274
193
  "@orama/tokenizers": "^3.1.16",
275
194
  "@streamdown/cjk": "^1.0.1",
276
195
  "@streamdown/code": "^1.0.1",
277
196
  "@vercel/agent-readability": "^0.6.0",
197
+ "@vercel/geistcn": "1.0.3",
198
+ "@vercel/geistcn-assets": "2.0.1",
278
199
  "@vercel/oidc": "^3.4.1",
279
200
  "ai": "^6.0.132",
280
201
  "class-variance-authority": "^0.7.1",
281
- "clsx": "^2.1.1",
282
202
  "commander": "^14.0.2",
283
203
  "dexie": "^4.2.1",
284
204
  "dexie-react-hooks": "^4.2.0",
@@ -286,7 +206,6 @@
286
206
  "fumadocs-mdx": "14.0.4",
287
207
  "fumadocs-ui": "16.2.2",
288
208
  "glob": "^11.0.0",
289
- "lucide-react": "^0.555.0",
290
209
  "mermaid": "^11.12.2",
291
210
  "motion": "^12.23.25",
292
211
  "next-themes": "^0.4.6",
@@ -296,15 +215,12 @@
296
215
  "remark-gfm": "^4.0.1",
297
216
  "remark-mdx": "^3.1.1",
298
217
  "remark-parse": "^11.0.0",
299
- "sonner": "^2.0.7",
300
218
  "streamdown": "^2.1.0",
301
- "tailwind-merge": "^3.4.0",
302
219
  "ts-morph": "^27.0.2",
303
220
  "tw-animate-css": "^1.4.0",
304
221
  "unified": "^11.0.5",
305
222
  "unist-util-visit": "^5.1.0",
306
223
  "use-stick-to-bottom": "^1.1.1",
307
- "vaul": "^1.1.2",
308
224
  "zod": "^4.1.13"
309
225
  },
310
226
  "peerDependencies": {
@@ -327,9 +243,5 @@
327
243
  "react-dom": "^19.2.3",
328
244
  "tsup": "^8.5.1",
329
245
  "typescript": "^5.9.3"
330
- },
331
- "scripts": {
332
- "build": "rm -rf dist docs template && node ./scripts/bundle-template.mjs && node ./scripts/bundle-docs.mjs && tsc -p tsconfig.runtime.json && tsup --config tsup.config.cli.ts",
333
- "dev": "tsc -p tsconfig.runtime.json --watch --preserveWatchOutput"
334
246
  }
335
- }
247
+ }
package/styles.css CHANGED
@@ -1,9 +1,10 @@
1
- @import "tailwindcss";
1
+ @import "@vercel/geistcn/tailwind.css";
2
2
  @import "fumadocs-ui/css/shadcn.css";
3
3
  @import "fumadocs-ui/css/preset.css";
4
- @import "tw-animate-css";
5
4
 
6
5
  /* The Geist design layer (theme tokens, utilities, base, fumadocs theming).
7
6
  Kept in a separate, import-free file so consuming apps can pull in the same
8
7
  design system without re-bundling Tailwind and the fumadocs presets. */
9
8
  @import "./theme.css";
9
+ @import "@vercel/geistcn/styles.css";
10
+ @import "@vercel/geistcn/marketing-typography.css";
@@ -52,12 +52,14 @@ Use these instructions when an AI coding agent edits this project.
52
52
  ## Routing and proxy guidelines
53
53
 
54
54
  - Keep App Router route files as thin adapters around package helpers such as `createDocsPage`, `createChatRoute`, `createLlmsRoute`, and `createProxy`.
55
+ - Keep `createGeistdocs` from `@vercel/geistdocs/next` as the `next.config.ts` wrapper. It composes Fumadocs MDX and generates the app-route manifest used by `createProxy`; do not replace it with `createMDX` directly.
55
56
  - Keep `cacheComponents: true` and `partialPrefetching: true` in `next.config.ts`. Do not export `dynamic`, `revalidate`, or `fetchCache` from App Router pages or route handlers.
56
57
  - Read `[lang]` from `next/root-params` in Server Components. Keep route context `params` in Route Handlers and Server Actions.
57
58
  - Use `prefetch={true}` for app-owned links to fully static documentation pages so navigation does not stop at the generic route shell.
58
59
  - Keep `export const config` in `proxy.ts` as a static object. Next.js must parse proxy matchers at build time.
59
60
  - 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`.
60
61
  - Preserve markdown negotiation unless the task explicitly changes AI-readable output. Geistdocs serves `/agents.md`, `/llms.txt`, `/.well-known/mcp.json`, and per-page Markdown for `.md`, `.mdx`, `Accept: text/markdown`, and AI-agent requests.
62
+ - Restart `next dev` after adding, deleting, or renaming an App Router page or route so `createGeistdocs` regenerates its route manifest.
61
63
  - When adding custom proxy behavior, prefer `before`, `after`, and `markdownRoutes` options on `createProxy` instead of replacing the proxy.
62
64
  - Use explicit `markdownRoutes` for root-mounted docs or any site where homepage/app routes coexist with docs routes.
63
65
  - Keep source URLs, navigation links, `getPageUrl`, and `markdownRoutes` app-local when `config.basePath` is set. Geistdocs derives public page-action and Markdown URLs separately.
@@ -107,3 +109,13 @@ Use these instructions when an AI coding agent edits this project.
107
109
  - Run `pnpm dev` and open the changed pages when visual layout, navigation, or MDX rendering changes.
108
110
  - Check both `/docs` and AI-readable routes such as `/agents.md`, `/.well-known/mcp.json`, `/llms.txt`, or a page-level `.md` URL when changing content routing or proxy behavior.
109
111
  - Confirm no secrets were added to source files. Use `.env.local` for local values and keep it out of Git.
112
+
113
+ <!-- BEGIN:nextjs-agent-rules -->
114
+
115
+ # This is NOT the Next.js you know
116
+
117
+ This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
118
+
119
+ This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
120
+
121
+ <!-- END:nextjs-agent-rules -->
@@ -1,4 +1,4 @@
1
- import { Badge } from "@vercel/geistdocs/components/badge";
1
+ import { Badge } from "@vercel/geistcn/components/badge";
2
2
  import type { ReactNode } from "react";
3
3
 
4
4
  interface HeroProps {
@@ -11,7 +11,7 @@ interface HeroProps {
11
11
  export const Hero = ({ badge, title, description, children }: HeroProps) => (
12
12
  <section className="mt-(--fd-nav-height) space-y-6 px-4 @min-[640px]:pt-24 pt-16 pb-16 text-center">
13
13
  <div className="mx-auto w-full max-w-4xl space-y-5">
14
- <Badge className="rounded-full" variant="secondary">
14
+ <Badge className="rounded-full" contrast="low" variant="gray">
15
15
  <div className="size-2 rounded-full bg-gray-800" />
16
16
  <p>{badge}</p>
17
17
  </Badge>
@@ -1,17 +1,25 @@
1
+ import { cn } from "@vercel/geistcn/utils";
1
2
  import type { ReactNode } from "react";
2
3
 
3
4
  interface OneTwoSectionProps {
4
5
  children?: ReactNode;
6
+ className?: string;
5
7
  description: string;
6
8
  title: string;
7
9
  }
8
10
 
9
11
  export const OneTwoSection = ({
12
+ className,
10
13
  title,
11
14
  description,
12
15
  children,
13
16
  }: OneTwoSectionProps) => (
14
- <div className="grid @min-[640px]:grid-cols-3 @min-[640px]:gap-0 gap-12 @min-[640px]:py-12 py-8">
17
+ <div
18
+ className={cn(
19
+ "grid @min-[640px]:grid-cols-3 @min-[640px]:gap-0 gap-12 @min-[640px]:py-12 py-8",
20
+ className
21
+ )}
22
+ >
15
23
  <div className="flex flex-col gap-2 text-balance">
16
24
  <h2 className="font-[450]! @min-[640px]:text-2xl @min-[768px]:text-3xl text-gray-1000 text-xl tracking-tighter">
17
25
  {title}
@@ -24,7 +24,7 @@ export const TextGridSection = ({
24
24
  )}
25
25
  >
26
26
  {title || description ? (
27
- <div className="grid max-w-3xl gap-2 text-balance">
27
+ <div className="grid @min-[768px]:grid-cols-2 @min-[768px]:items-start @min-[768px]:gap-8 gap-4 text-balance">
28
28
  {title ? (
29
29
  <h2 className="font-[450]! @min-[1024px]:text-[40px] @min-[640px]:text-2xl @min-[768px]:text-3xl text-gray-1000 text-xl tracking-tighter">
30
30
  {title}
@@ -13,7 +13,6 @@ import type { GeistdocsAgentReadinessConfig } from "@vercel/geistdocs/config";
13
13
  import type { Metadata } from "next";
14
14
  import { config } from "@/lib/geistdocs/config";
15
15
  import { getLocalizedPath } from "@/lib/geistdocs/public-path";
16
- import { CenteredSection } from "./components/centered-section";
17
16
  import { CTA } from "./components/cta";
18
17
  import { Hero } from "./components/hero";
19
18
  import { OneTwoSection } from "./components/one-two-section";
@@ -132,22 +131,22 @@ const HomePage = async ({ params }: PageProps<"/[lang]">) => {
132
131
  description="Geistdocs combines a shared runtime with local ownership, so documentation teams can standardize behavior without centralizing every page."
133
132
  title="A complete foundation for product documentation"
134
133
  />
135
- <CenteredSection
136
- align="left"
134
+ <OneTwoSection
135
+ className="@min-[640px]:mt-16 mt-12"
137
136
  description="Every generated project starts as a normal Next.js application. Write MDX locally, configure the shared shell, and deploy with the same workflow as the product it documents."
138
137
  title="Keep documentation close to the product"
139
138
  >
140
- <div className="grid gap-3 rounded-lg border bg-background-100 p-6 font-mono text-sm">
139
+ <div className="grid w-full max-w-3xl gap-3 justify-self-end rounded-lg border bg-background-100 p-6 font-mono text-sm">
141
140
  <p>content/docs/ stores the documentation source.</p>
142
141
  <p>geistdocs.tsx defines product and agent metadata.</p>
143
142
  <p>@vercel/geistdocs provides the shared runtime.</p>
144
143
  </div>
145
- </CenteredSection>
144
+ </OneTwoSection>
146
145
  <OneTwoSection
147
146
  description="Agents can discover the documentation corpus, choose a focused page, and recover from stale links without parsing the interactive application shell."
148
147
  title="Give agents a direct path through the docs"
149
148
  >
150
- <ul className="grid gap-4 rounded-lg border bg-background-100 p-6 text-gray-900">
149
+ <ul className="grid w-full max-w-3xl gap-4 justify-self-end rounded-lg border bg-background-100 p-6 text-gray-900">
151
150
  <li>
152
151
  <a
153
152
  className="underline"
@@ -1,15 +1,15 @@
1
1
  import "../global.css";
2
+ import { geistFontClasses } from "@vercel/geistcn/core";
3
+ import { cn } from "@vercel/geistcn/utils";
2
4
  import "@/lib/geistdocs/site-url-warning";
3
5
  import { Footer } from "@vercel/geistdocs/footer";
4
6
  import { Navbar } from "@vercel/geistdocs/navbar";
5
7
  import type { Metadata } from "next";
6
8
  import { GeistdocsProvider } from "@/components/geistdocs/provider";
7
9
  import { config } from "@/lib/geistdocs/config";
8
- import { mono, sans } from "@/lib/geistdocs/fonts";
9
10
  import { i18n } from "@/lib/geistdocs/i18n";
10
11
  import { getRootLang } from "@/lib/geistdocs/root-params";
11
12
  import { isSiteUrlConfigured, siteUrl } from "@/lib/geistdocs/site-url";
12
- import { cn } from "@/lib/utils";
13
13
 
14
14
  export const generateStaticParams = () =>
15
15
  i18n.languages.map((lang) => ({ lang }));
@@ -23,11 +23,14 @@ const Layout = async ({ children }: LayoutProps<"/[lang]">) => {
23
23
 
24
24
  return (
25
25
  <html
26
- className={cn(sans.variable, mono.variable, "antialiased")}
26
+ className={cn(
27
+ geistFontClasses,
28
+ "tailwind tailwind-preflight antialiased"
29
+ )}
27
30
  lang={lang}
28
31
  suppressHydrationWarning
29
32
  >
30
- <body>
33
+ <body style={{ backgroundColor: "var(--ds-background-200)" }}>
31
34
  <GeistdocsProvider basePath={config.basePath} lang={lang}>
32
35
  <Navbar config={config} />
33
36
  {children}
@@ -2,6 +2,5 @@ import { createDocsMarkdownRoute } from "@vercel/geistdocs/routes/llms";
2
2
  import { geistdocsSource } from "@/lib/geistdocs/source";
3
3
 
4
4
  export const { GET, generateStaticParams } = createDocsMarkdownRoute({
5
- notFound: {},
6
5
  sources: [geistdocsSource],
7
6
  });
@@ -1,25 +1,28 @@
1
- @import "tailwindcss";
1
+ @import "@vercel/geistcn/tailwind.css";
2
2
  @import "fumadocs-ui/css/shadcn.css";
3
3
  @import "fumadocs-ui/css/preset.css";
4
- @import "tw-animate-css";
5
-
6
- /* Geist design layer from the package. theme.css already @sources the package
7
- dist and streamdown, so don't re-@source those here; only @source your own
8
- files if Tailwind misses them. Keep app-only deltas below. */
9
4
  @import "@vercel/geistdocs/theme.css";
5
+ @import "@vercel/geistcn/styles.css";
6
+ @import "@vercel/geistcn/marketing-typography.css";
7
+
8
+ /* GeistCN components are authored with Tailwind utilities. Scan only component
9
+ source: scanning the package root also includes font-pixel internals whose
10
+ published paths point outside the app and make Turbopack panic. */
11
+ @source "../../node_modules/@vercel/geistcn/src/components/**/*.{ts,tsx}";
12
+
13
+ :root {
14
+ --font-sans: var(--font-geist-sans);
15
+ font-feature-settings:
16
+ "rlig" 1,
17
+ "calt" 0,
18
+ "ss11" 1;
19
+ }
10
20
 
11
21
  /* App-only override: this template uses the 200 surface as the page
12
22
  background (the package defaults to background-100). */
13
23
  @layer base {
14
24
  body {
15
- @apply bg-background-200 text-gray-1000;
16
- }
17
-
18
- /* Geist Sans is loaded from the `geist` npm package, which exposes the
19
- `--font-geist-sans` variable. Alias it so `font-sans`/`--font-sans`
20
- resolves to it. */
21
- :root {
22
- --font-sans: var(--font-geist-sans);
25
+ @apply text-gray-1000;
23
26
  }
24
27
  }
25
28
 
@@ -31,11 +31,11 @@ related:
31
31
  项目根目录下的 `geistdocs.tsx` 文件包含主要自定义选项:
32
32
 
33
33
  ```tsx title="geistdocs.tsx"
34
- import { BookHeartIcon } from "lucide-react";
34
+ import { IconBookOpen } from "@vercel/geistcn-assets/icons";
35
35
 
36
36
  export const Logo = () => (
37
37
  <div className="flex items-center gap-2">
38
- <BookHeartIcon className="size-5" />
38
+ <IconBookOpen className="size-5" />
39
39
  <p className="font-semibold text-xl tracking-tight">Geistdocs</p>
40
40
  </div>
41
41
  );
@@ -25,6 +25,7 @@ Configure Geistdocs through user-owned files in the generated project. Runtime f
25
25
  | File | Purpose |
26
26
  | --- | --- |
27
27
  | `geistdocs.tsx` | Site-level settings, including logo, nav, GitHub repo, AI prompt, agent-readiness metadata, translations, and feature flags. |
28
+ | `next.config.ts` | Composes Fumadocs MDX, discovers App Router routes, and configures Next.js. |
28
29
  | `source.config.ts` | Configures Fumadocs collections with the package-provided schema, Markdown plugins, and syntax theme. |
29
30
  | `lib/geistdocs/config.tsx` | Converts `geistdocs.tsx` exports into the package config using `defineConfig`. |
30
31
  | `source.config.ts` | Configures Fumadocs collections with package-safe schemas and Markdown processing. |
@@ -214,11 +215,18 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
214
215
  When Next.js mounts the application below a path, set the same value in `next.config.ts` and Geistdocs config:
215
216
 
216
217
  ```ts title="next.config.ts"
218
+ import { createGeistdocs } from "@vercel/geistdocs/next";
219
+ import type { NextConfig } from "next";
220
+
221
+ const withGeistdocs = createGeistdocs();
222
+
217
223
  const config: NextConfig = {
218
224
  basePath: "/docs",
219
225
  cacheComponents: true,
220
226
  partialPrefetching: true,
221
227
  };
228
+
229
+ export default withGeistdocs(config);
222
230
  ```
223
231
 
224
232
  ```tsx title="geistdocs.tsx"
@@ -69,7 +69,6 @@ import { geistdocsSource } from "@/lib/geistdocs/source";
69
69
 
70
70
  export const { GET, generateStaticParams } =
71
71
  createDocsMarkdownRoute({
72
- notFound: {},
73
72
  sources: [geistdocsSource],
74
73
  });
75
74
  ```
@@ -93,7 +92,7 @@ When a Markdown request does not match a page, Geistdocs returns an agent-readab
93
92
 
94
93
  For example, a request for `/docs/env-vars` can suggest `/docs/environment-variables.md`. The response uses a short cache lifetime and returns a real `404` status. It also sends `X-Robots-Tag: noindex` and no canonical link because the requested page does not exist. Regular HTML requests keep the app's standard not-found behavior.
95
94
 
96
- Enable the suggestion response with `notFound: {}` on `createDocsMarkdownRoute`. Pass `notFound: { status: 410 }` for permanently removed pages. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status. Without `notFound`, Markdown requests use the standard Next.js not-found response.
95
+ The suggestion response is enabled by default. Pass `notFound: { status: 410 }` for permanently removed pages, or `notFound: false` to use the standard Next.js not-found response. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status.
97
96
 
98
97
  If a custom `markdownRoutes` mapping changes the public path shape, set `notFound.getRequestedPath` to reconstruct the app-local public pathname. This also keeps page lookup and suggestions within the right source when a flattened route serves multiple sources:
99
98
 
@@ -110,15 +109,19 @@ Set `notFound.getPageMarkdownUrl` as well when suggested pages use a custom app-
110
109
 
111
110
  ### Unmatched application paths
112
111
 
113
- Set `markdownNotFound: true` on `createProxy` only when every valid app page has a Markdown mapping. Unmapped Markdown or detected-agent requests then receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`, while browser requests continue to the app's existing Next.js not-found UI.
112
+ When `agent` is enabled, `createGeistdocs` scans App Router pages and route handlers during `next dev` and `next build`. `createProxy` uses that generated manifest to distinguish valid application routes from unknown paths. Valid routes continue to the app's HTML or route-handler response. Unknown Markdown or detected-agent `GET` and `HEAD` requests receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`.
114
113
 
115
- Sites with valid custom pages outside their Markdown mappings should pass a predicate instead. Return `false` for route families that should continue to Next.js:
114
+ Markdown mappings take precedence over generated app routes, so a route that has both HTML and Markdown continues to negotiate Markdown. Dynamic app routes are treated as potentially valid; the app remains responsible for returning its own 404 when a specific slug does not exist.
115
+
116
+ Pass `markdownNotFound: false` to disable automatic unmatched-path recovery:
116
117
 
117
118
  ```ts title="proxy.ts"
118
119
  const proxy = createProxy({
119
120
  config: geistdocsConfig,
120
- markdownNotFound: ({ pathname }) => !pathname.startsWith("/playground"),
121
+ markdownNotFound: false,
121
122
  });
122
123
  ```
123
124
 
125
+ Sites that do not use `createGeistdocs` keep the previous opt-in behavior. Existing boolean and predicate forms remain supported for compatibility.
126
+
124
127
  `createNotFoundRoute` remains available for apps that prefer an explicit catch-all Route Handler with Geistdocs' minimal HTML response.
@@ -56,24 +56,26 @@ If you are starting from a generated Geistdocs project and moving content into i
56
56
  pnpm dlx @vercel/geistdocs init --name my-docs
57
57
  ```
58
58
 
59
- ## Enable Cache Components
59
+ ## Configure Next.js
60
60
 
61
- Geistdocs uses Next.js Cache Components to prerender static application shells while dynamic content streams from the server. Enable Cache Components in `next.config.ts`:
61
+ The Geistdocs Next.js integration composes Fumadocs MDX, enables automatic app-route discovery for agent-readable 404s, and preserves your Next.js configuration. Enable Cache Components in the same file:
62
62
 
63
63
  ```ts title="next.config.ts"
64
- import { createMDX } from "fumadocs-mdx/next";
64
+ import { createGeistdocs } from "@vercel/geistdocs/next";
65
65
  import type { NextConfig } from "next";
66
66
 
67
- const withMDX = createMDX();
67
+ const withGeistdocs = createGeistdocs();
68
68
 
69
69
  const config: NextConfig = {
70
70
  cacheComponents: true,
71
71
  partialPrefetching: true,
72
72
  };
73
73
 
74
- export default withMDX(config);
74
+ export default withGeistdocs(config);
75
75
  ```
76
76
 
77
+ Restart `next dev` after adding, deleting, or renaming an App Router page or route. Production builds always regenerate the route manifest.
78
+
77
79
  Every root dynamic parameter needs at least one value from `generateStaticParams`. For a site with a `[lang]` root segment, return every configured language from the root layout:
78
80
 
79
81
  ```tsx title="app/[lang]/layout.tsx"
@@ -373,16 +375,14 @@ For a base-path application whose root page is documentation, add `"/"` to the s
373
375
  Tailwind CSS v4 requires `@source` entries for package components and related dependencies.
374
376
 
375
377
  ```css title="app/styles/geistdocs.css"
376
- @import "tailwindcss";
378
+ @import "@vercel/geistcn/tailwind.css";
379
+ @import "@vercel/geistcn/styles.css";
377
380
  @import "fumadocs-ui/css/shadcn.css";
378
381
  @import "fumadocs-ui/css/preset.css";
379
- @import "tw-animate-css";
380
-
381
- @source "../../node_modules/@vercel/geistdocs/dist/**/*.js";
382
- @source "../../node_modules/streamdown/dist/*.js";
382
+ @import "@vercel/geistdocs/theme.css";
383
383
  ```
384
384
 
385
- Move Tailwind CSS v3 plugin utilities into CSS-first v4 utilities or theme variables. Keep custom token names stable while you migrate components.
385
+ Geistcn owns the Geist tokens, theme, typography, preflight, and animation utilities. The Geistdocs theme entry point remains during the compatibility migration for documentation and Fumadocs integration rules and to source the compiled runtime dependencies.
386
386
 
387
387
  ## Handle environment variables
388
388
 
@@ -2,7 +2,7 @@
2
2
  title: Proxy and markdown routes
3
3
  description: Add custom request logic while keeping Geistdocs markdown negotiation in the package
4
4
  type: reference
5
- summary: Configure createProxy with before and after hooks, markdown route mappings, and a static Next.js matcher.
5
+ summary: Configure createProxy with generated route discovery, request hooks, markdown mappings, and a static Next.js matcher.
6
6
  prerequisites:
7
7
  - /docs/configuration
8
8
  related:
@@ -177,6 +177,25 @@ export const config = {
177
177
 
178
178
  The package keeps `llms.txt`, `sitemap.md`, `agents.md`, MCP discovery, and RSS out of root page-Markdown negotiation. Continue to exclude site-specific application and API routes with the matcher or a `before` hook. A root Markdown page is exposed as `/index.md`, or `<basePath>/index.md` publicly.
179
179
 
180
+ ## Recover unmatched Markdown requests
181
+
182
+ `createGeistdocs` in `next.config.ts` generates a lightweight manifest from App Router pages and route handlers. When `agent` is enabled, `createProxy` uses this manifest to return a Markdown 404 only when a `GET` or `HEAD` request matches neither a Markdown mapping nor an application route.
183
+
184
+ The manifest contains route patterns, not page modules or content. Static, dynamic, catch-all, optional catch-all, grouped, and localized routes continue to Next.js. Root catch-all pages are treated as potentially valid, so the app remains responsible for their 404 behavior. The package's own `[...not-found]` route handler is excluded so it does not claim every path.
185
+
186
+ The integration also resolves `next.config.ts` rewrites. Static rewrite sources are matched exactly, while parameterized sources protect their safe static prefix. If a rewrite begins with a dynamic root segment, Geistdocs disables automatic recovery rather than risk returning a Markdown 404 for a real rewritten route.
187
+
188
+ No proxy option is required. Pass `markdownNotFound: false` only when the site needs to disable automatic recovery:
189
+
190
+ ```ts title="proxy.ts"
191
+ const proxy = createProxy({
192
+ config: geistdocsConfig,
193
+ markdownNotFound: false,
194
+ });
195
+ ```
196
+
197
+ Existing sites that use `createMDX` directly do not receive a generated manifest and keep the previous opt-in behavior. Restart `next dev` after adding, deleting, or renaming a route; production builds always regenerate the manifest.
198
+
180
199
  ## Hook context
181
200
 
182
201
  Both `before` and `after` receive the same context:
@@ -179,7 +179,7 @@ Each version can define an `icon` to override the default current/previous versi
179
179
  Use `GeistdocsRouteSelect` for framework, product, or route switchers that should not use version-specific labels:
180
180
 
181
181
  ```tsx
182
- import { LogoNextjs, LogoSvelteKit } from "@vercel/geistdocs/assets/logos";
182
+ import { LogoIconNextSvg, LogoSvelte } from "@vercel/geistcn-assets/logos";
183
183
  import { GeistdocsRouteSelect } from "@vercel/geistdocs/versions";
184
184
 
185
185
  <GeistdocsRouteSelect
@@ -190,14 +190,14 @@ import { GeistdocsRouteSelect } from "@vercel/geistdocs/versions";
190
190
  id: "nextjs",
191
191
  label: "Next.js",
192
192
  description: "React framework",
193
- icon: <LogoNextjs height={18} />,
193
+ icon: <LogoIconNextSvg size={18} />,
194
194
  href: "/:path*",
195
195
  },
196
196
  {
197
197
  id: "sveltekit",
198
198
  label: "SvelteKit",
199
199
  description: "Svelte framework",
200
- icon: <LogoSvelteKit height={18} />,
200
+ icon: <LogoSvelte height={18} />,
201
201
  routePrefix: "/sveltekit",
202
202
  href: "/sveltekit/:path*",
203
203
  },
@@ -28,10 +28,5 @@ export const config = defineConfig({
28
28
  ai: {
29
29
  prompt,
30
30
  suggestions,
31
- footer: (
32
- <div className="text-right">
33
- <a href="https://example.com">Powered by your AI provider</a>
34
- </div>
35
- ),
36
31
  },
37
32
  });