@vercel/geistdocs 1.2.2 → 1.2.3-canary.48fea3c

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 (339) hide show
  1. package/dist/cli/index.js +3 -0
  2. package/dist/components/callout.d.ts +12 -0
  3. package/dist/components/callout.d.ts.map +1 -0
  4. package/dist/components/callout.js +7 -0
  5. package/dist/components/code-block-tabs.d.ts +7 -0
  6. package/dist/components/code-block-tabs.d.ts.map +1 -0
  7. package/dist/components/code-block-tabs.js +7 -0
  8. package/dist/components/code-block.d.ts +14 -0
  9. package/dist/components/code-block.d.ts.map +1 -0
  10. package/dist/components/code-block.js +45 -0
  11. package/dist/components/copy-prompt.d.ts +11 -0
  12. package/dist/components/copy-prompt.d.ts.map +1 -0
  13. package/dist/components/copy-prompt.js +58 -0
  14. package/dist/components/mermaid.d.ts +4 -0
  15. package/dist/components/mermaid.d.ts.map +1 -0
  16. package/dist/components/mermaid.js +44 -0
  17. package/dist/components/theme-aware-image.d.ts +12 -0
  18. package/dist/components/theme-aware-image.d.ts.map +1 -0
  19. package/dist/components/theme-aware-image.js +8 -0
  20. package/dist/components/video.d.ts +6 -0
  21. package/dist/components/video.d.ts.map +1 -0
  22. package/dist/components/video.js +3 -0
  23. package/dist/config.d.ts +71 -0
  24. package/dist/config.d.ts.map +1 -0
  25. package/dist/config.js +1 -0
  26. package/dist/controls.d.ts +15 -0
  27. package/dist/controls.d.ts.map +1 -0
  28. package/dist/controls.js +52 -0
  29. package/dist/internal/chat/context.d.ts +19 -0
  30. package/dist/internal/chat/context.d.ts.map +1 -0
  31. package/dist/internal/chat/context.js +36 -0
  32. package/dist/internal/chat/conversation.d.ts +10 -0
  33. package/dist/internal/chat/conversation.d.ts.map +1 -0
  34. package/dist/internal/chat/conversation.js +16 -0
  35. package/dist/internal/chat/copy-chat.d.ts +5 -0
  36. package/dist/internal/chat/copy-chat.d.ts.map +1 -0
  37. package/dist/internal/chat/copy-chat.js +35 -0
  38. package/dist/internal/chat/db.d.ts +13 -0
  39. package/dist/internal/chat/db.d.ts.map +1 -0
  40. package/dist/internal/chat/db.js +19 -0
  41. package/dist/internal/chat/message-metadata.d.ts +8 -0
  42. package/dist/internal/chat/message-metadata.d.ts.map +1 -0
  43. package/dist/internal/chat/message-metadata.js +29 -0
  44. package/dist/internal/chat/message.d.ts +11 -0
  45. package/dist/internal/chat/message.d.ts.map +1 -0
  46. package/dist/internal/chat/message.js +11 -0
  47. package/dist/internal/chat/prompt-input.d.ts +13 -0
  48. package/dist/internal/chat/prompt-input.d.ts.map +1 -0
  49. package/dist/internal/chat/prompt-input.js +39 -0
  50. package/dist/internal/chat/shell.d.ts +2 -0
  51. package/dist/internal/chat/shell.d.ts.map +1 -0
  52. package/dist/internal/chat/shell.js +194 -0
  53. package/dist/internal/chat/shimmer.d.ts +11 -0
  54. package/dist/internal/chat/shimmer.d.ts.map +1 -0
  55. package/dist/internal/chat/shimmer.js +18 -0
  56. package/dist/internal/chat/sources.d.ts +13 -0
  57. package/dist/internal/chat/sources.d.ts.map +1 -0
  58. package/dist/internal/chat/sources.js +9 -0
  59. package/dist/internal/chat/suggestion.d.ts +11 -0
  60. package/dist/internal/chat/suggestion.d.ts.map +1 -0
  61. package/dist/internal/chat/suggestion.js +12 -0
  62. package/dist/internal/cn.d.ts +3 -0
  63. package/dist/internal/cn.d.ts.map +1 -0
  64. package/dist/internal/cn.js +3 -0
  65. package/dist/internal/feedback-action.d.ts +14 -0
  66. package/dist/internal/feedback-action.d.ts.map +1 -0
  67. package/dist/internal/feedback-action.js +34 -0
  68. package/dist/internal/i18n.d.ts +6 -0
  69. package/dist/internal/i18n.d.ts.map +1 -0
  70. package/dist/internal/i18n.js +18 -0
  71. package/dist/internal/languages.d.ts +7 -0
  72. package/dist/internal/languages.d.ts.map +1 -0
  73. package/dist/internal/languages.js +18 -0
  74. package/dist/internal/not-implemented.d.ts +2 -0
  75. package/dist/internal/not-implemented.d.ts.map +1 -0
  76. package/dist/internal/not-implemented.js +4 -0
  77. package/dist/internal/page-actions-client.d.ts +13 -0
  78. package/dist/internal/page-actions-client.d.ts.map +1 -0
  79. package/dist/internal/page-actions-client.js +160 -0
  80. package/dist/internal/page-actions.d.ts +18 -0
  81. package/dist/internal/page-actions.d.ts.map +1 -0
  82. package/dist/internal/page-actions.js +4 -0
  83. package/dist/internal/provider-client.d.ts +9 -0
  84. package/dist/internal/provider-client.d.ts.map +1 -0
  85. package/dist/internal/provider-client.js +23 -0
  86. package/dist/internal/search.d.ts +5 -0
  87. package/dist/internal/search.d.ts.map +1 -0
  88. package/dist/internal/search.js +14 -0
  89. package/dist/internal/sidebar.d.ts +9 -0
  90. package/dist/internal/sidebar.d.ts.map +1 -0
  91. package/dist/internal/sidebar.js +38 -0
  92. package/dist/internal/table-of-contents.d.ts +9 -0
  93. package/dist/internal/table-of-contents.d.ts.map +1 -0
  94. package/dist/internal/table-of-contents.js +5 -0
  95. package/dist/internal/ui/button-group.d.ts +13 -0
  96. package/dist/internal/ui/button-group.d.ts.map +1 -0
  97. package/dist/internal/ui/button-group.js +26 -0
  98. package/dist/internal/ui/button.d.ts +12 -0
  99. package/dist/internal/ui/button.d.ts.map +1 -0
  100. package/dist/internal/ui/button.js +33 -0
  101. package/dist/internal/ui/card.d.ts +6 -0
  102. package/dist/internal/ui/card.d.ts.map +1 -0
  103. package/dist/internal/ui/card.js +14 -0
  104. package/dist/internal/ui/collapsible.d.ts +6 -0
  105. package/dist/internal/ui/collapsible.d.ts.map +1 -0
  106. package/dist/internal/ui/collapsible.js +12 -0
  107. package/dist/internal/ui/drawer.d.ts +6 -0
  108. package/dist/internal/ui/drawer.d.ts.map +1 -0
  109. package/dist/internal/ui/drawer.js +13 -0
  110. package/dist/internal/ui/dropdown-menu.d.ts +22 -0
  111. package/dist/internal/ui/dropdown-menu.d.ts.map +1 -0
  112. package/dist/internal/ui/dropdown-menu.js +41 -0
  113. package/dist/internal/ui/input-group.d.ts +15 -0
  114. package/dist/internal/ui/input-group.d.ts.map +1 -0
  115. package/dist/internal/ui/input-group.js +44 -0
  116. package/dist/internal/ui/input.d.ts +3 -0
  117. package/dist/internal/ui/input.d.ts.map +1 -0
  118. package/dist/internal/ui/input.js +5 -0
  119. package/dist/internal/ui/kbd.d.ts +4 -0
  120. package/dist/internal/ui/kbd.d.ts.map +1 -0
  121. package/dist/internal/ui/kbd.js +8 -0
  122. package/dist/internal/ui/popover.d.ts +6 -0
  123. package/dist/internal/ui/popover.d.ts.map +1 -0
  124. package/dist/internal/ui/popover.js +13 -0
  125. package/dist/internal/ui/scroll-area.d.ts +5 -0
  126. package/dist/internal/ui/scroll-area.d.ts.map +1 -0
  127. package/dist/internal/ui/scroll-area.js +12 -0
  128. package/dist/internal/ui/separator.d.ts +4 -0
  129. package/dist/internal/ui/separator.d.ts.map +1 -0
  130. package/dist/internal/ui/separator.js +7 -0
  131. package/dist/internal/ui/sheet.d.ts +10 -0
  132. package/dist/internal/ui/sheet.d.ts.map +1 -0
  133. package/dist/internal/ui/sheet.js +24 -0
  134. package/dist/internal/ui/sonner.d.ts +3 -0
  135. package/dist/internal/ui/sonner.d.ts.map +1 -0
  136. package/dist/internal/ui/sonner.js +20 -0
  137. package/dist/internal/ui/spinner.d.ts +3 -0
  138. package/dist/internal/ui/spinner.d.ts.map +1 -0
  139. package/dist/internal/ui/spinner.js +6 -0
  140. package/dist/internal/ui/textarea.d.ts +3 -0
  141. package/dist/internal/ui/textarea.d.ts.map +1 -0
  142. package/dist/internal/ui/textarea.js +5 -0
  143. package/dist/internal/ui/tooltip.d.ts +7 -0
  144. package/dist/internal/ui/tooltip.d.ts.map +1 -0
  145. package/dist/internal/ui/tooltip.js +16 -0
  146. package/dist/internal/use-mobile.d.ts +2 -0
  147. package/dist/internal/use-mobile.d.ts.map +1 -0
  148. package/dist/internal/use-mobile.js +16 -0
  149. package/dist/layout.d.ts +14 -0
  150. package/dist/layout.d.ts.map +1 -0
  151. package/dist/layout.js +31 -0
  152. package/dist/mdx.d.ts +36 -0
  153. package/dist/mdx.d.ts.map +1 -0
  154. package/dist/mdx.js +74 -0
  155. package/dist/pages/docs.d.ts +77 -0
  156. package/dist/pages/docs.d.ts.map +1 -0
  157. package/dist/pages/docs.js +92 -0
  158. package/dist/proxy.d.ts +37 -0
  159. package/dist/proxy.d.ts.map +1 -0
  160. package/dist/proxy.js +162 -0
  161. package/dist/routes/chat.d.ts +14 -0
  162. package/dist/routes/chat.d.ts.map +1 -0
  163. package/dist/routes/chat.js +242 -0
  164. package/dist/routes/llms.d.ts +51 -0
  165. package/dist/routes/llms.d.ts.map +1 -0
  166. package/dist/routes/llms.js +59 -0
  167. package/dist/routes/search.d.ts +11 -0
  168. package/dist/routes/search.d.ts.map +1 -0
  169. package/dist/routes/search.js +74 -0
  170. package/dist/routes/sitemap.d.ts +44 -0
  171. package/dist/routes/sitemap.d.ts.map +1 -0
  172. package/dist/routes/sitemap.js +168 -0
  173. package/dist/sidebar.d.ts +11 -0
  174. package/dist/sidebar.d.ts.map +1 -0
  175. package/dist/sidebar.js +16 -0
  176. package/dist/source.d.ts +174 -0
  177. package/dist/source.d.ts.map +1 -0
  178. package/dist/source.js +129 -0
  179. package/dist/versions.d.ts +15 -0
  180. package/dist/versions.d.ts.map +1 -0
  181. package/dist/versions.js +52 -0
  182. package/package.json +141 -9
  183. package/styles.css +193 -0
  184. package/template/_gitignore +29 -0
  185. package/template/app/[lang]/(home)/components/centered-section.tsx +26 -0
  186. package/template/app/[lang]/(home)/components/cta.tsx +19 -0
  187. package/template/app/[lang]/(home)/components/hero.tsx +27 -0
  188. package/template/app/[lang]/(home)/components/one-two-section.tsx +25 -0
  189. package/template/app/[lang]/(home)/components/templates.tsx +50 -0
  190. package/template/app/[lang]/(home)/components/text-grid-section.tsx +20 -0
  191. package/template/app/[lang]/(home)/layout.tsx +14 -0
  192. package/template/app/[lang]/(home)/page.tsx +126 -0
  193. package/template/app/[lang]/docs/[[...slug]]/page.tsx +19 -0
  194. package/template/app/[lang]/docs/layout.tsx +14 -0
  195. package/template/app/[lang]/layout.tsx +29 -0
  196. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +7 -0
  197. package/template/app/[lang]/llms.txt/route.ts +6 -0
  198. package/template/app/[lang]/og/[...slug]/background.png +0 -0
  199. package/template/app/[lang]/og/[...slug]/geist-sans-regular.ttf +0 -0
  200. package/template/app/[lang]/og/[...slug]/geist-sans-semibold.ttf +0 -0
  201. package/template/app/[lang]/og/[...slug]/route.tsx +95 -0
  202. package/template/app/[lang]/rss.xml/route.ts +52 -0
  203. package/template/app/[lang]/sitemap.md/route.ts +9 -0
  204. package/template/app/actions/feedback/emotions.ts +18 -0
  205. package/template/app/actions/feedback/index.ts +45 -0
  206. package/template/app/api/chat/route.ts +8 -0
  207. package/template/app/api/search/route.ts +5 -0
  208. package/template/app/favicon.ico +0 -0
  209. package/template/app/global.css +2 -0
  210. package/template/app/robots.ts +14 -0
  211. package/template/app/sitemap.ts +36 -0
  212. package/template/app/styles/geistdocs.css +554 -0
  213. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right-small.tsx +35 -0
  214. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right.tsx +27 -0
  215. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-check.tsx +27 -0
  216. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-down-small.tsx +30 -0
  217. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-right.tsx +27 -0
  218. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy.tsx +27 -0
  219. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-file-text.tsx +25 -0
  220. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-menu-alt.tsx +27 -0
  221. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-slash-forward.tsx +36 -0
  222. package/template/components/geistcn-fallbacks/geistcn-assets/icons/index.tsx +11 -0
  223. package/template/components/geistcn-fallbacks/geistcn-assets/logos/index.tsx +14 -0
  224. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-elements.tsx +29 -0
  225. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-sdk.tsx +38 -0
  226. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-chat-sdk.tsx +42 -0
  227. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-flags-sdk.tsx +42 -0
  228. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-icon-vercel.tsx +31 -0
  229. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-streamdown.tsx +29 -0
  230. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-vercel-oss.tsx +24 -0
  231. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-workflow-sdk.tsx +73 -0
  232. package/template/components/geistdocs/callout.tsx +40 -0
  233. package/template/components/geistdocs/chat.tsx +24 -0
  234. package/template/components/geistdocs/code-block-tabs.tsx +61 -0
  235. package/template/components/geistdocs/code-block.tsx +134 -0
  236. package/template/components/geistdocs/copy-page.tsx +27 -0
  237. package/template/components/geistdocs/desktop-menu.tsx +52 -0
  238. package/template/components/geistdocs/docs-layout.tsx +20 -0
  239. package/template/components/geistdocs/docs-page.tsx +35 -0
  240. package/template/components/geistdocs/edit-source.tsx +30 -0
  241. package/template/components/geistdocs/feedback.tsx +139 -0
  242. package/template/components/geistdocs/footer.tsx +30 -0
  243. package/template/components/geistdocs/github-button.tsx +19 -0
  244. package/template/components/geistdocs/home-layout.tsx +46 -0
  245. package/template/components/geistdocs/icons.tsx +13 -0
  246. package/template/components/geistdocs/installer.tsx +58 -0
  247. package/template/components/geistdocs/language-selector.tsx +3 -0
  248. package/template/components/geistdocs/mdx-components.tsx +5 -0
  249. package/template/components/geistdocs/mermaid.tsx +68 -0
  250. package/template/components/geistdocs/mobile-docs-bar.tsx +77 -0
  251. package/template/components/geistdocs/mobile-menu.tsx +150 -0
  252. package/template/components/geistdocs/navbar-logo.tsx +124 -0
  253. package/template/components/geistdocs/navbar.tsx +22 -0
  254. package/template/components/geistdocs/provider.tsx +31 -0
  255. package/template/components/geistdocs/rss-button.tsx +10 -0
  256. package/template/components/geistdocs/scroll-top.tsx +21 -0
  257. package/template/components/geistdocs/search.tsx +17 -0
  258. package/template/components/geistdocs/sidebar.tsx +128 -0
  259. package/template/components/geistdocs/theme-aware-image.tsx +22 -0
  260. package/template/components/geistdocs/theme-toggle.tsx +3 -0
  261. package/template/components/geistdocs/video.tsx +16 -0
  262. package/template/components/ui/badge.tsx +46 -0
  263. package/template/components/ui/button-group.tsx +83 -0
  264. package/template/components/ui/button.tsx +60 -0
  265. package/template/components/ui/card.tsx +92 -0
  266. package/template/components/ui/collapsible.tsx +33 -0
  267. package/template/components/ui/command-prompt.tsx +488 -0
  268. package/template/components/ui/command.tsx +184 -0
  269. package/template/components/ui/dialog.tsx +143 -0
  270. package/template/components/ui/drawer.tsx +135 -0
  271. package/template/components/ui/dropdown-menu.tsx +257 -0
  272. package/template/components/ui/hover-card.tsx +44 -0
  273. package/template/components/ui/input-group.tsx +170 -0
  274. package/template/components/ui/input.tsx +21 -0
  275. package/template/components/ui/kbd.tsx +28 -0
  276. package/template/components/ui/navigation-menu.tsx +192 -0
  277. package/template/components/ui/popover.tsx +48 -0
  278. package/template/components/ui/scroll-area.tsx +58 -0
  279. package/template/components/ui/select.tsx +187 -0
  280. package/template/components/ui/separator.tsx +28 -0
  281. package/template/components/ui/sheet.tsx +139 -0
  282. package/template/components/ui/sonner.tsx +40 -0
  283. package/template/components/ui/spinner.tsx +16 -0
  284. package/template/components/ui/textarea.tsx +18 -0
  285. package/template/components/ui/tooltip.tsx +61 -0
  286. package/template/components.json +22 -0
  287. package/template/content/docs/ask-ai.cn.mdx +85 -0
  288. package/template/content/docs/ask-ai.mdx +89 -0
  289. package/template/content/docs/configuration.cn.mdx +155 -0
  290. package/template/content/docs/configuration.mdx +200 -0
  291. package/template/content/docs/deployment.cn.mdx +34 -0
  292. package/template/content/docs/deployment.mdx +40 -0
  293. package/template/content/docs/edit-on-github.cn.mdx +47 -0
  294. package/template/content/docs/edit-on-github.mdx +51 -0
  295. package/template/content/docs/env.cn.mdx +25 -0
  296. package/template/content/docs/env.mdx +29 -0
  297. package/template/content/docs/feedback.cn.mdx +85 -0
  298. package/template/content/docs/feedback.mdx +89 -0
  299. package/template/content/docs/getting-started.cn.mdx +86 -0
  300. package/template/content/docs/getting-started.mdx +107 -0
  301. package/template/content/docs/index.cn.mdx +57 -0
  302. package/template/content/docs/index.mdx +92 -0
  303. package/template/content/docs/internationalization.cn.mdx +111 -0
  304. package/template/content/docs/internationalization.mdx +122 -0
  305. package/template/content/docs/llms-txt.cn.mdx +72 -0
  306. package/template/content/docs/llms-txt.mdx +85 -0
  307. package/template/content/docs/md.cn.mdx +65 -0
  308. package/template/content/docs/md.mdx +81 -0
  309. package/template/content/docs/meta.json +23 -0
  310. package/template/content/docs/open-in-chat.cn.mdx +78 -0
  311. package/template/content/docs/open-in-chat.mdx +80 -0
  312. package/template/content/docs/provider.cn.mdx +70 -0
  313. package/template/content/docs/provider.mdx +74 -0
  314. package/template/content/docs/proxy.cn.mdx +96 -0
  315. package/template/content/docs/proxy.mdx +124 -0
  316. package/template/content/docs/rss.cn.mdx +104 -0
  317. package/template/content/docs/rss.mdx +108 -0
  318. package/template/content/docs/syntax.cn.mdx +416 -0
  319. package/template/content/docs/syntax.mdx +411 -0
  320. package/template/content/docs/theme-aware-image.mdx +57 -0
  321. package/template/content/docs/versioned-docs.cn.mdx +117 -0
  322. package/template/content/docs/versioned-docs.mdx +181 -0
  323. package/template/geistdocs.tsx +51 -0
  324. package/template/hooks/geistdocs/use-sidebar.ts +13 -0
  325. package/template/hooks/use-mobile.ts +19 -0
  326. package/template/lib/geistdocs/config.tsx +27 -0
  327. package/template/lib/geistdocs/fonts.ts +18 -0
  328. package/template/lib/geistdocs/i18n.ts +13 -0
  329. package/template/lib/geistdocs/md-tracking.ts +56 -0
  330. package/template/lib/geistdocs/source.ts +12 -0
  331. package/template/lib/utils.ts +6 -0
  332. package/template/next.config.ts +22 -0
  333. package/template/package.json +63 -0
  334. package/template/postcss.config.mjs +5 -0
  335. package/template/proxy.ts +18 -0
  336. package/template/source.config.ts +62 -0
  337. package/template/tsconfig.json +37 -0
  338. package/dist/index.js +0 -2
  339. /package/dist/{index.d.ts → cli/index.d.ts} +0 -0
@@ -0,0 +1,96 @@
1
+ ---
2
+ title: Proxy 和 Markdown 路由
3
+ description: 在保留包内 Markdown 协商逻辑的同时添加自定义请求逻辑
4
+ type: reference
5
+ summary: 使用 createProxy 的 before 和 after hooks、markdownRoutes 和静态 Next.js matcher 配置代理。
6
+ prerequisites:
7
+ - /docs/configuration
8
+ related:
9
+ - /docs/md
10
+ - /docs/llms-txt
11
+ - /docs/versioned-docs
12
+ ---
13
+
14
+ Geistdocs proxy 负责 Markdown 协商、AI agent 重写、请求追踪和 i18n fallback。使用 hooks 添加站点特有的请求逻辑,而不是复制包内实现。
15
+
16
+ ## 基础 proxy
17
+
18
+ 生成的项目使用 `createProxy` 和默认的 `/docs` Markdown 路由:
19
+
20
+ ```ts title="proxy.ts"
21
+ import { createProxy } from "@vercel/geistdocs/proxy";
22
+ import { config as geistdocsConfig } from "@/lib/geistdocs/config";
23
+ import { trackMdRequest } from "@/lib/geistdocs/md-tracking";
24
+
25
+ const proxy = createProxy({
26
+ config: geistdocsConfig,
27
+ trackMarkdownRequest: trackMdRequest,
28
+ });
29
+
30
+ export const config = {
31
+ matcher: [
32
+ "/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)",
33
+ ],
34
+ };
35
+
36
+ export default proxy;
37
+ ```
38
+
39
+ `export const config` 必须保持为静态对象。Next.js 会在构建时读取 proxy matcher,不支持在该导出中调用 helper。
40
+
41
+ ## 自定义请求逻辑
42
+
43
+ 使用 `before` 在 Geistdocs Markdown 处理之前运行逻辑。返回 `Response` 会停止后续处理。
44
+
45
+ ```ts title="proxy.ts"
46
+ import { createProxy } from "@vercel/geistdocs/proxy";
47
+ import { NextResponse } from "next/server";
48
+ import { config as geistdocsConfig } from "@/lib/geistdocs/config";
49
+
50
+ const proxy = createProxy({
51
+ config: geistdocsConfig,
52
+ before: async ({ request, defaultLanguage }) => {
53
+ if (request.nextUrl.pathname === "/") {
54
+ return NextResponse.rewrite(
55
+ new URL(`/${defaultLanguage}/home`, request.url)
56
+ );
57
+ }
58
+
59
+ return null;
60
+ },
61
+ });
62
+ ```
63
+
64
+ 使用 `after` 在 Markdown 处理之后、i18n fallback 之前运行逻辑。
65
+
66
+ ## Markdown 路由映射
67
+
68
+ `markdownRoutes` 将公开页面 URL 映射到返回 Markdown 的 App Router handler。包仍然通过 route helpers 服务 `/llms.txt` 和单页 Markdown;proxy 使用这些映射处理 `.md`、`.mdx`、`Accept: text/markdown` 和 AI-agent 请求。
69
+
70
+ ```ts title="proxy.ts"
71
+ const proxy = createProxy({
72
+ config: geistdocsConfig,
73
+ markdownRoutes: [
74
+ { from: "/docs/*path", to: "/[lang]/llms.mdx/*path" },
75
+ { from: "/cookbook/*path", to: "/[lang]/llms.mdx/cookbook/*path" },
76
+ { from: "/v5/docs/*path", to: "/[lang]/v5/llms.mdx/*path" },
77
+ ],
78
+ });
79
+ ```
80
+
81
+ | Request | Rewritten destination |
82
+ | --- | --- |
83
+ | `/docs/getting-started.md` | `/en/llms.mdx/getting-started` |
84
+ | `/cookbook/install.mdx` | `/en/llms.mdx/cookbook/install` |
85
+ | `/v5/docs/intro` with `Accept: text/markdown` | `/en/v5/llms.mdx/intro` |
86
+
87
+ ## Hook context
88
+
89
+ `before` 和 `after` 接收相同的 context:
90
+
91
+ | Property | Type | Description |
92
+ | --- | --- | --- |
93
+ | `request` | `NextRequest` | 传入请求。 |
94
+ | `context` | `NextFetchEvent` | Proxy event,包含 `waitUntil`。 |
95
+ | `defaultLanguage` | `string` | 配置的默认语言。 |
96
+ | `languages` | `string[]` | 所有配置的语言。 |
@@ -0,0 +1,124 @@
1
+ ---
2
+ title: Proxy and markdown routes
3
+ description: Add custom request logic while keeping Geistdocs markdown negotiation in the package
4
+ type: reference
5
+ summary: Configure createProxy with before and after hooks, markdown route mappings, and a static Next.js matcher.
6
+ prerequisites:
7
+ - /docs/configuration
8
+ related:
9
+ - /docs/md
10
+ - /docs/llms-txt
11
+ - /docs/versioned-docs
12
+ ---
13
+
14
+ The Geistdocs proxy handles markdown negotiation, AI-agent rewrites, request tracking, and i18n fallback. Add site-specific request logic with hooks instead of copying the package proxy implementation.
15
+
16
+ <CopyPrompt text="Review this Geistdocs proxy.ts file. Check that export const config is static, custom logic is inside createProxy before or after hooks, and markdownRoutes cover every public docs route family.">
17
+ Review this Geistdocs `proxy.ts` file. Check that `export const config` is static, custom logic is inside `createProxy` `before` or `after` hooks, and `markdownRoutes` cover every public docs route family.
18
+ </CopyPrompt>
19
+
20
+ ## Basic proxy
21
+
22
+ Generated projects use `createProxy` with the default `/docs` markdown route:
23
+
24
+ ```ts title="proxy.ts"
25
+ import { createProxy } from "@vercel/geistdocs/proxy";
26
+ import { config as geistdocsConfig } from "@/lib/geistdocs/config";
27
+ import { trackMdRequest } from "@/lib/geistdocs/md-tracking";
28
+
29
+ const proxy = createProxy({
30
+ config: geistdocsConfig,
31
+ trackMarkdownRequest: trackMdRequest,
32
+ });
33
+
34
+ export const config = {
35
+ matcher: [
36
+ "/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)",
37
+ ],
38
+ };
39
+
40
+ export default proxy;
41
+ ```
42
+
43
+ Keep `export const config` as a static object. Next.js reads proxy matchers at build time and does not support calling a helper for this export.
44
+
45
+ ## Custom request logic
46
+
47
+ Use `before` for logic that should run before Geistdocs markdown handling. Return a `Response` to stop processing.
48
+
49
+ ```ts title="proxy.ts"
50
+ import { createProxy } from "@vercel/geistdocs/proxy";
51
+ import { NextResponse } from "next/server";
52
+ import { config as geistdocsConfig } from "@/lib/geistdocs/config";
53
+
54
+ const proxy = createProxy({
55
+ config: geistdocsConfig,
56
+ before: async ({ request, defaultLanguage }) => {
57
+ if (request.nextUrl.pathname === "/") {
58
+ return NextResponse.rewrite(
59
+ new URL(`/${defaultLanguage}/home`, request.url)
60
+ );
61
+ }
62
+
63
+ return null;
64
+ },
65
+ });
66
+ ```
67
+
68
+ Use `after` for logic that should run after markdown handling but before the i18n fallback:
69
+
70
+ ```ts title="proxy.ts"
71
+ const proxy = createProxy({
72
+ config: geistdocsConfig,
73
+ after: async ({ request }) => {
74
+ const session = await getSessionFromReq(request);
75
+
76
+ if (!session) {
77
+ return null;
78
+ }
79
+
80
+ return refreshSession(request, session);
81
+ },
82
+ });
83
+ ```
84
+
85
+ ## Markdown route mappings
86
+
87
+ `markdownRoutes` maps public page URLs to the App Router handlers that return Markdown. The package still serves `/llms.txt` and individual page Markdown through route helpers; the proxy uses these mappings for `.md`, `.mdx`, `Accept: text/markdown`, and AI-agent requests.
88
+
89
+ ```ts title="proxy.ts"
90
+ const proxy = createProxy({
91
+ config: geistdocsConfig,
92
+ markdownRoutes: [
93
+ { from: "/docs/*path", to: "/[lang]/llms.mdx/*path" },
94
+ { from: "/cookbook/*path", to: "/[lang]/llms.mdx/cookbook/*path" },
95
+ { from: "/v5/docs/*path", to: "/[lang]/v5/llms.mdx/*path" },
96
+ ],
97
+ });
98
+ ```
99
+
100
+ With these mappings:
101
+
102
+ | Request | Rewritten destination |
103
+ | --- | --- |
104
+ | `/docs/getting-started.md` | `/en/llms.mdx/getting-started` |
105
+ | `/cookbook/install.mdx` | `/en/llms.mdx/cookbook/install` |
106
+ | `/v5/docs/intro` with `Accept: text/markdown` | `/en/v5/llms.mdx/intro` |
107
+
108
+ Use `[lang]` in the destination when your markdown route is nested under `app/[lang]`. Use `*path` or `:path*` to insert the matched wildcard path.
109
+
110
+ ## Hook context
111
+
112
+ Both `before` and `after` receive the same context:
113
+
114
+ | Property | Type | Description |
115
+ | --- | --- | --- |
116
+ | `request` | `NextRequest` | The incoming request. |
117
+ | `context` | `NextFetchEvent` | The proxy event, including `waitUntil`. |
118
+ | `defaultLanguage` | `string` | The configured default language. |
119
+ | `languages` | `string[]` | All configured languages. |
120
+
121
+ ## Next steps
122
+
123
+ - Read [.md extension](/docs/md) to understand single-page Markdown responses.
124
+ - Read [Versioned docs](/docs/versioned-docs) to map multiple public route families.
@@ -0,0 +1,104 @@
1
+ ---
2
+ title: RSS
3
+ description: 通过为您的文档自动生成的 RSS 订阅源让用户保持更新
4
+ type: conceptual
5
+ summary: 自动生成的 RSS 2.0 订阅源,在文档发布或更新时通知用户。
6
+ related:
7
+ - /docs/env
8
+ - /docs/configuration
9
+ ---
10
+
11
+ RSS 功能为您的文档提供了一个自动生成的 RSS 2.0 订阅源。用户可以订阅该订阅源,在发布新内容或修改现有页面时及时收到通知。
12
+
13
+ ## 工作原理
14
+
15
+ Geistdocs 会自动生成一个包含以下内容的 RSS 订阅源:
16
+
17
+ - 所有已发布的文档页面
18
+ - 页面标题和描述
19
+ - 每页的直接链接
20
+ - 最后修改日期
21
+ - 作者信息
22
+
23
+ 订阅源会在每次请求时重新生成,确保订阅者始终收到有关文档的最新信息。
24
+
25
+ ## 访问订阅源
26
+
27
+ RSS 订阅源可通过以下地址访问:
28
+
29
+ ```
30
+ https://your-domain.com/rss.xml
31
+ ```
32
+
33
+ 用户可以使用以下方式订阅该 URL:
34
+
35
+ - RSS 阅读器 (Feedly, Inoreader, NewsBlur)
36
+ - 电子邮件服务 (Blogtrottr, Kill the Newsletter)
37
+ - 浏览器扩展
38
+ - 新闻聚合器
39
+
40
+ ### RSS 按钮
41
+
42
+ 导航栏中会显示一个便捷的 RSS 按钮,方便用户发现并订阅您的订阅源。单击该按钮会在新标签页中打开 RSS XML。
43
+
44
+ ## 订阅源格式
45
+
46
+ 该 RSS 订阅源遵循 RSS 2.0 规范,并包含以下内容:
47
+
48
+ ### 频道元数据
49
+
50
+ ```xml
51
+ <channel>
52
+ <title>Your Documentation Title</title>
53
+ <link>https://your-domain.com</link>
54
+ <language>en</language>
55
+ <image>https://your-domain.com/banner.png</image>
56
+ <copyright>All rights reserved [Year], [Your Organization]</copyright>
57
+ </channel>
58
+ ```
59
+
60
+ ### 条目格式
61
+
62
+ 每个文档页面都会作为一个条目出现:
63
+
64
+ ```xml
65
+ <item>
66
+ <guid>page-url</guid>
67
+ <title>Page Title</title>
68
+ <description>Page description</description>
69
+ <link>https://your-domain.com/docs/page-url</link>
70
+ <pubDate>Thu, 12 Nov 2025 00:00:00 GMT</pubDate>
71
+ <author>
72
+ <name>Your Organization</name>
73
+ </author>
74
+ </item>
75
+ ```
76
+
77
+ ## 配置
78
+
79
+ RSS 订阅源要求设置 `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` 环境变量,您可以在 [环境变量](/docs/env) 一节中阅读更多信息。
80
+
81
+ 它还需要在 Geistdocs 配置文件中导出一个 `title`,您可以在 [配置](/docs/configuration) 一节中阅读更多信息。
82
+
83
+ ## 功能
84
+
85
+ ### 自动更新
86
+
87
+ 订阅源会自动包含:
88
+
89
+ - 新创建的页面
90
+ - 已更新的页面内容(使用最后修改日期)
91
+ - 更改的标题或描述
92
+ - 来自您的文档源的所有页面
93
+
94
+ ### 最后修改日期
95
+
96
+ 页面使用它们的 `lastModified` frontmatter 字段,或回退到当前日期:
97
+
98
+ ```mdx title="content/docs/example.mdx"
99
+ ---
100
+ title: Example Page
101
+ description: An example documentation page
102
+ lastModified: 2025-11-12
103
+ ---
104
+ ```
@@ -0,0 +1,108 @@
1
+ ---
2
+ title: RSS
3
+ description: Keep users updated with an automatically generated RSS feed for your documentation
4
+ type: conceptual
5
+ summary: An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
6
+ related:
7
+ - /docs/env
8
+ - /docs/configuration
9
+ ---
10
+
11
+ The RSS feature provides an automatically generated RSS 2.0 feed for your documentation. This allows users to subscribe to updates and stay informed when new content is published or existing pages are modified.
12
+
13
+ <CopyPrompt text="Help me verify the RSS feed for this Geistdocs site. Check the /rss.xml route, confirm the production URL environment variable is set, and explain how page metadata affects feed items.">
14
+ Help me verify the RSS feed for this Geistdocs site. Check the `/rss.xml` route, confirm the production URL environment variable is set, and explain how page metadata affects feed items.
15
+ </CopyPrompt>
16
+
17
+ ## How it works
18
+
19
+ Geistdocs automatically generates an RSS feed that includes:
20
+
21
+ - All published documentation pages
22
+ - Page titles and descriptions
23
+ - Direct links to each page
24
+ - Last modified dates
25
+ - Author information
26
+
27
+ The feed is regenerated on each request, ensuring subscribers always receive the most current information about your documentation.
28
+
29
+ ## Accessing the Feed
30
+
31
+ The RSS feed is available at:
32
+
33
+ ```
34
+ https://your-domain.com/rss.xml
35
+ ```
36
+
37
+ Users can subscribe to this URL using:
38
+
39
+ - RSS readers (Feedly, Inoreader, NewsBlur)
40
+ - Email services (Blogtrottr, Kill the Newsletter)
41
+ - Browser extensions
42
+ - News aggregators
43
+
44
+ ### RSS Button
45
+
46
+ An RSS button appears in the navigation bar so readers can discover and subscribe to your feed. Clicking the button opens the RSS XML in a new tab.
47
+
48
+ ## Feed Format
49
+
50
+ The RSS feed follows the RSS 2.0 specification and includes:
51
+
52
+ ### Channel Metadata
53
+
54
+ ```xml
55
+ <channel>
56
+ <title>Your Documentation Title</title>
57
+ <link>https://your-domain.com</link>
58
+ <language>en</language>
59
+ <image>https://your-domain.com/banner.png</image>
60
+ <copyright>All rights reserved [Year], [Your Organization]</copyright>
61
+ </channel>
62
+ ```
63
+
64
+ ### Item Format
65
+
66
+ Each documentation page appears as an item:
67
+
68
+ ```xml
69
+ <item>
70
+ <guid>page-url</guid>
71
+ <title>Page Title</title>
72
+ <description>Page description</description>
73
+ <link>https://your-domain.com/docs/page-url</link>
74
+ <pubDate>Thu, 12 Nov 2025 00:00:00 GMT</pubDate>
75
+ <author>
76
+ <name>Your Organization</name>
77
+ </author>
78
+ </item>
79
+ ```
80
+
81
+ ## Configuration
82
+
83
+ The RSS feed requires the `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` environment variable to be set, which you can read more about in the [Environment Variables](/docs/env) section.
84
+
85
+ It also requires a `title` exported from the Geistdocs configuration file, which you can read more about in the [Configuration](/docs/configuration) section.
86
+
87
+ ## Features
88
+
89
+ ### Automatic Updates
90
+
91
+ The feed automatically includes:
92
+
93
+ - Newly created pages
94
+ - Updated page content (using last modified dates)
95
+ - Changed titles or descriptions
96
+ - All pages from your documentation source
97
+
98
+ ### Last Modified Dates
99
+
100
+ Pages use their `lastModified` frontmatter field or fall back to the current date:
101
+
102
+ ```mdx title="content/docs/example.mdx"
103
+ ---
104
+ title: Example Page
105
+ description: An example documentation page
106
+ lastModified: 2025-11-12
107
+ ---
108
+ ```