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

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 (332) 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 +52 -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 +6 -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 +13 -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 +55 -0
  156. package/dist/pages/docs.d.ts.map +1 -0
  157. package/dist/pages/docs.js +69 -0
  158. package/dist/proxy.d.ts +21 -0
  159. package/dist/proxy.d.ts.map +1 -0
  160. package/dist/proxy.js +109 -0
  161. package/dist/routes/chat.d.ts +13 -0
  162. package/dist/routes/chat.d.ts.map +1 -0
  163. package/dist/routes/chat.js +229 -0
  164. package/dist/routes/llms.d.ts +33 -0
  165. package/dist/routes/llms.d.ts.map +1 -0
  166. package/dist/routes/llms.js +39 -0
  167. package/dist/routes/search.d.ts +10 -0
  168. package/dist/routes/search.d.ts.map +1 -0
  169. package/dist/routes/search.js +33 -0
  170. package/dist/routes/sitemap.d.ts +35 -0
  171. package/dist/routes/sitemap.d.ts.map +1 -0
  172. package/dist/routes/sitemap.js +150 -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 +30 -0
  177. package/dist/source.d.ts.map +1 -0
  178. package/dist/source.js +72 -0
  179. package/package.json +137 -9
  180. package/styles.css +193 -0
  181. package/template/_gitignore +29 -0
  182. package/template/app/[lang]/(home)/components/centered-section.tsx +26 -0
  183. package/template/app/[lang]/(home)/components/cta.tsx +19 -0
  184. package/template/app/[lang]/(home)/components/hero.tsx +27 -0
  185. package/template/app/[lang]/(home)/components/one-two-section.tsx +25 -0
  186. package/template/app/[lang]/(home)/components/templates.tsx +50 -0
  187. package/template/app/[lang]/(home)/components/text-grid-section.tsx +20 -0
  188. package/template/app/[lang]/(home)/layout.tsx +14 -0
  189. package/template/app/[lang]/(home)/page.tsx +126 -0
  190. package/template/app/[lang]/docs/[[...slug]]/page.tsx +19 -0
  191. package/template/app/[lang]/docs/layout.tsx +14 -0
  192. package/template/app/[lang]/layout.tsx +29 -0
  193. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +7 -0
  194. package/template/app/[lang]/llms.txt/route.ts +6 -0
  195. package/template/app/[lang]/og/[...slug]/background.png +0 -0
  196. package/template/app/[lang]/og/[...slug]/geist-sans-regular.ttf +0 -0
  197. package/template/app/[lang]/og/[...slug]/geist-sans-semibold.ttf +0 -0
  198. package/template/app/[lang]/og/[...slug]/route.tsx +95 -0
  199. package/template/app/[lang]/rss.xml/route.ts +52 -0
  200. package/template/app/[lang]/sitemap.md/route.ts +9 -0
  201. package/template/app/actions/feedback/emotions.ts +18 -0
  202. package/template/app/actions/feedback/index.ts +45 -0
  203. package/template/app/api/chat/route.ts +8 -0
  204. package/template/app/api/search/route.ts +5 -0
  205. package/template/app/favicon.ico +0 -0
  206. package/template/app/global.css +2 -0
  207. package/template/app/robots.ts +14 -0
  208. package/template/app/sitemap.ts +36 -0
  209. package/template/app/styles/geistdocs.css +554 -0
  210. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right-small.tsx +35 -0
  211. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-arrow-up-right.tsx +27 -0
  212. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-check.tsx +27 -0
  213. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-down-small.tsx +30 -0
  214. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-chevron-right.tsx +27 -0
  215. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-copy.tsx +27 -0
  216. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-file-text.tsx +25 -0
  217. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-menu-alt.tsx +27 -0
  218. package/template/components/geistcn-fallbacks/geistcn-assets/icons/icon-slash-forward.tsx +36 -0
  219. package/template/components/geistcn-fallbacks/geistcn-assets/icons/index.tsx +11 -0
  220. package/template/components/geistcn-fallbacks/geistcn-assets/logos/index.tsx +14 -0
  221. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-elements.tsx +29 -0
  222. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-ai-sdk.tsx +38 -0
  223. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-chat-sdk.tsx +42 -0
  224. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-flags-sdk.tsx +42 -0
  225. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-icon-vercel.tsx +31 -0
  226. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-streamdown.tsx +29 -0
  227. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-vercel-oss.tsx +24 -0
  228. package/template/components/geistcn-fallbacks/geistcn-assets/logos/logo-workflow-sdk.tsx +73 -0
  229. package/template/components/geistdocs/callout.tsx +40 -0
  230. package/template/components/geistdocs/chat.tsx +24 -0
  231. package/template/components/geistdocs/code-block-tabs.tsx +61 -0
  232. package/template/components/geistdocs/code-block.tsx +134 -0
  233. package/template/components/geistdocs/copy-page.tsx +27 -0
  234. package/template/components/geistdocs/desktop-menu.tsx +52 -0
  235. package/template/components/geistdocs/docs-layout.tsx +20 -0
  236. package/template/components/geistdocs/docs-page.tsx +35 -0
  237. package/template/components/geistdocs/edit-source.tsx +30 -0
  238. package/template/components/geistdocs/feedback.tsx +139 -0
  239. package/template/components/geistdocs/footer.tsx +30 -0
  240. package/template/components/geistdocs/github-button.tsx +19 -0
  241. package/template/components/geistdocs/home-layout.tsx +46 -0
  242. package/template/components/geistdocs/icons.tsx +13 -0
  243. package/template/components/geistdocs/installer.tsx +58 -0
  244. package/template/components/geistdocs/language-selector.tsx +3 -0
  245. package/template/components/geistdocs/mdx-components.tsx +5 -0
  246. package/template/components/geistdocs/mermaid.tsx +68 -0
  247. package/template/components/geistdocs/mobile-docs-bar.tsx +77 -0
  248. package/template/components/geistdocs/mobile-menu.tsx +150 -0
  249. package/template/components/geistdocs/navbar-logo.tsx +124 -0
  250. package/template/components/geistdocs/navbar.tsx +22 -0
  251. package/template/components/geistdocs/provider.tsx +31 -0
  252. package/template/components/geistdocs/rss-button.tsx +10 -0
  253. package/template/components/geistdocs/scroll-top.tsx +21 -0
  254. package/template/components/geistdocs/search.tsx +17 -0
  255. package/template/components/geistdocs/sidebar.tsx +128 -0
  256. package/template/components/geistdocs/theme-aware-image.tsx +22 -0
  257. package/template/components/geistdocs/theme-toggle.tsx +3 -0
  258. package/template/components/geistdocs/video.tsx +16 -0
  259. package/template/components/ui/badge.tsx +46 -0
  260. package/template/components/ui/button-group.tsx +83 -0
  261. package/template/components/ui/button.tsx +60 -0
  262. package/template/components/ui/card.tsx +92 -0
  263. package/template/components/ui/collapsible.tsx +33 -0
  264. package/template/components/ui/command-prompt.tsx +488 -0
  265. package/template/components/ui/command.tsx +184 -0
  266. package/template/components/ui/dialog.tsx +143 -0
  267. package/template/components/ui/drawer.tsx +135 -0
  268. package/template/components/ui/dropdown-menu.tsx +257 -0
  269. package/template/components/ui/hover-card.tsx +44 -0
  270. package/template/components/ui/input-group.tsx +170 -0
  271. package/template/components/ui/input.tsx +21 -0
  272. package/template/components/ui/kbd.tsx +28 -0
  273. package/template/components/ui/navigation-menu.tsx +192 -0
  274. package/template/components/ui/popover.tsx +48 -0
  275. package/template/components/ui/scroll-area.tsx +58 -0
  276. package/template/components/ui/select.tsx +187 -0
  277. package/template/components/ui/separator.tsx +28 -0
  278. package/template/components/ui/sheet.tsx +139 -0
  279. package/template/components/ui/sonner.tsx +40 -0
  280. package/template/components/ui/spinner.tsx +16 -0
  281. package/template/components/ui/textarea.tsx +18 -0
  282. package/template/components/ui/tooltip.tsx +61 -0
  283. package/template/components.json +22 -0
  284. package/template/content/docs/ask-ai.cn.mdx +85 -0
  285. package/template/content/docs/ask-ai.mdx +89 -0
  286. package/template/content/docs/configuration.cn.mdx +115 -0
  287. package/template/content/docs/configuration.mdx +118 -0
  288. package/template/content/docs/deployment.cn.mdx +34 -0
  289. package/template/content/docs/deployment.mdx +40 -0
  290. package/template/content/docs/edit-on-github.cn.mdx +47 -0
  291. package/template/content/docs/edit-on-github.mdx +51 -0
  292. package/template/content/docs/env.cn.mdx +25 -0
  293. package/template/content/docs/env.mdx +29 -0
  294. package/template/content/docs/feedback.cn.mdx +85 -0
  295. package/template/content/docs/feedback.mdx +89 -0
  296. package/template/content/docs/getting-started.cn.mdx +86 -0
  297. package/template/content/docs/getting-started.mdx +107 -0
  298. package/template/content/docs/index.cn.mdx +54 -0
  299. package/template/content/docs/index.mdx +85 -0
  300. package/template/content/docs/internationalization.cn.mdx +111 -0
  301. package/template/content/docs/internationalization.mdx +122 -0
  302. package/template/content/docs/llms-txt.cn.mdx +50 -0
  303. package/template/content/docs/llms-txt.mdx +54 -0
  304. package/template/content/docs/md.cn.mdx +68 -0
  305. package/template/content/docs/md.mdx +72 -0
  306. package/template/content/docs/meta.json +21 -0
  307. package/template/content/docs/open-in-chat.cn.mdx +78 -0
  308. package/template/content/docs/open-in-chat.mdx +82 -0
  309. package/template/content/docs/provider.cn.mdx +69 -0
  310. package/template/content/docs/provider.mdx +73 -0
  311. package/template/content/docs/rss.cn.mdx +104 -0
  312. package/template/content/docs/rss.mdx +108 -0
  313. package/template/content/docs/syntax.cn.mdx +416 -0
  314. package/template/content/docs/syntax.mdx +411 -0
  315. package/template/content/docs/theme-aware-image.mdx +57 -0
  316. package/template/geistdocs.tsx +51 -0
  317. package/template/hooks/geistdocs/use-sidebar.ts +13 -0
  318. package/template/hooks/use-mobile.ts +19 -0
  319. package/template/lib/geistdocs/config.tsx +27 -0
  320. package/template/lib/geistdocs/fonts.ts +18 -0
  321. package/template/lib/geistdocs/i18n.ts +13 -0
  322. package/template/lib/geistdocs/md-tracking.ts +56 -0
  323. package/template/lib/geistdocs/source.ts +12 -0
  324. package/template/lib/utils.ts +6 -0
  325. package/template/next.config.ts +22 -0
  326. package/template/package.json +63 -0
  327. package/template/postcss.config.mjs +5 -0
  328. package/template/proxy.ts +16 -0
  329. package/template/source.config.ts +62 -0
  330. package/template/tsconfig.json +37 -0
  331. package/dist/index.js +0 -2
  332. /package/dist/{index.d.ts → cli/index.d.ts} +0 -0
@@ -0,0 +1,411 @@
1
+ ---
2
+ title: Syntax
3
+ description: Learn about the supported markdown syntax and formatting options
4
+ type: reference
5
+ summary: Supported MDX syntax including text formatting, code blocks, line highlighting, and Mermaid diagrams.
6
+ prerequisites:
7
+ - /docs/getting-started
8
+ related:
9
+ - /docs/configuration
10
+ ---
11
+
12
+ Geistdocs supports MDX, a superset of Markdown that allows you to use JSX components within your documentation. This guide covers all the formatting options available.
13
+
14
+ <CopyPrompt text="Help me write a Geistdocs MDX page. Use this page as a syntax reference and create an example page with frontmatter, headings, links, a code block, a Callout, and a CopyPrompt component.">
15
+ Help me write a Geistdocs MDX page. Use this page as a syntax reference and create an example page with frontmatter, headings, links, a code block, a `Callout`, and a `CopyPrompt` component.
16
+ </CopyPrompt>
17
+
18
+ ## Frontmatter
19
+
20
+ Every MDX file should include frontmatter at the top:
21
+
22
+ ```yaml
23
+ ---
24
+ title: Page Title
25
+ description: A brief description of the page content
26
+ ---
27
+ ```
28
+
29
+ The `title` property is required and is used for the page heading and navigation. The `description` is used for SEO and page previews.
30
+
31
+ ## Basic Markdown
32
+
33
+ ### Text Formatting
34
+
35
+ You can style text using standard Markdown syntax:
36
+
37
+ - **Bold text** with `**double asterisks**`
38
+ - _Italic text_ with `*single asterisks*`
39
+ - ~~Strikethrough~~ with `~~double tildes~~`
40
+ - `Inline code` with `` `backticks` ``
41
+
42
+ ### Headings
43
+
44
+ Use `#` symbols to create headings:
45
+
46
+ ```text
47
+ # Heading 1
48
+
49
+ ## Heading 2
50
+
51
+ ### Heading 3
52
+
53
+ #### Heading 4
54
+
55
+ ##### Heading 5
56
+
57
+ ###### Heading 6
58
+ ```
59
+
60
+ Headings automatically generate anchor links for easy navigation and deep linking.
61
+
62
+ ### Lists
63
+
64
+ Create unordered lists with `-`, `*`, or `+`:
65
+
66
+ - First item
67
+ - Second item
68
+ - Nested item
69
+ - Another nested item
70
+ - Third item
71
+
72
+ Create ordered lists with numbers:
73
+
74
+ 1. First step
75
+ 2. Second step
76
+ 3. Third step
77
+
78
+ ### Blockquotes
79
+
80
+ Use `>` to create blockquotes:
81
+
82
+ > This is a blockquote. You can use it to highlight important information or quotes from external sources.
83
+
84
+ ### Links
85
+
86
+ Create links with `[text](url)`:
87
+
88
+ - [External link](https://vercel.com)
89
+ - [Internal link](/docs/getting-started)
90
+
91
+ ### Images
92
+
93
+ Add images with `![alt text](url)`:
94
+
95
+ ```md
96
+ ![Description of the image](/path/to/image.png)
97
+ ```
98
+
99
+ ## GitHub Flavored Markdown
100
+
101
+ Geistdocs supports GFM extensions including tables, task lists, and autolinks.
102
+
103
+ ### Tables
104
+
105
+ Create tables using pipes and dashes:
106
+
107
+ ```md
108
+ | Feature | Description | Status |
109
+ | -------- | ----------------- | --------- |
110
+ | Markdown | Basic formatting | Supported |
111
+ | GFM | GitHub extensions | Supported |
112
+ | MDX | JSX in Markdown | Supported |
113
+ ```
114
+
115
+ This renders as:
116
+
117
+ | Feature | Description | Status |
118
+ | -------- | ----------------- | --------- |
119
+ | Markdown | Basic formatting | Supported |
120
+ | GFM | GitHub extensions | Supported |
121
+ | MDX | JSX in Markdown | Supported |
122
+
123
+ ### Task Lists
124
+
125
+ Create interactive task lists:
126
+
127
+ ```md
128
+ - [x] Completed task
129
+ - [ ] Incomplete task
130
+ - [ ] Another task to do
131
+ ```
132
+
133
+ This renders as:
134
+
135
+ - [x] Completed task
136
+ - [ ] Incomplete task
137
+ - [ ] Another task to do
138
+
139
+ ### Autolinks
140
+
141
+ URLs are automatically converted to clickable links:
142
+
143
+ ```md
144
+ https://vercel.com
145
+ ```
146
+
147
+ This renders as:
148
+
149
+ https://vercel.com
150
+
151
+ ## Code Blocks
152
+
153
+ Fenced code blocks support syntax highlighting for many languages.
154
+
155
+ ### Basic Syntax Highlighting
156
+
157
+ Specify the language after the opening backticks:
158
+
159
+ ````md
160
+ ```typescript
161
+ const greet = (name: string): string => {
162
+ return `Hello, ${name}!`;
163
+ };
164
+ ```
165
+ ````
166
+
167
+ This renders as:
168
+
169
+ ```typescript
170
+ const greet = (name: string): string => {
171
+ return `Hello, ${name}!`;
172
+ };
173
+ ```
174
+
175
+ ### Titles
176
+
177
+ Add a title to your code block with the `title` attribute:
178
+
179
+ ````md
180
+ ```tsx title="components/button.tsx"
181
+ export const Button = ({ children }) => {
182
+ return <button type="button">{children}</button>;
183
+ };
184
+ ```
185
+ ````
186
+
187
+ This renders as:
188
+
189
+ ```tsx title="components/button.tsx"
190
+ export const Button = ({ children }) => {
191
+ return <button type="button">{children}</button>;
192
+ };
193
+ ```
194
+
195
+ ### Line Numbers
196
+
197
+ Display line numbers by adding the `lineNumbers` attribute:
198
+
199
+ ````md
200
+ ```typescript lineNumbers
201
+ const numbers = [1, 2, 3, 4, 5];
202
+ const doubled = numbers.map((n) => n * 2);
203
+ console.log(doubled);
204
+ ```
205
+ ````
206
+
207
+ This renders as:
208
+
209
+ ```typescript lineNumbers
210
+ const numbers = [1, 2, 3, 4, 5];
211
+ const doubled = numbers.map((n) => n * 2);
212
+ console.log(doubled);
213
+ ```
214
+
215
+ ### Line Highlighting
216
+
217
+ Highlight specific lines using the `[!code highlight]` comment:
218
+
219
+ ````md
220
+ ```typescript
221
+ const config = {
222
+ theme: "dark", // [ !code highlight]
223
+ language: "en",
224
+ };
225
+ ```
226
+ ````
227
+
228
+ Remove the space before `!` when using this syntax. This renders as:
229
+
230
+ ```typescript
231
+ const config = {
232
+ theme: "dark", // [!code highlight]
233
+ language: "en",
234
+ };
235
+ ```
236
+
237
+ ### Word Highlighting
238
+
239
+ Highlight specific words with `[!code word:term]`:
240
+
241
+ ````md
242
+ ```typescript
243
+ // [ !code word:config]
244
+ const config = {
245
+ theme: "dark",
246
+ };
247
+
248
+ console.log(config);
249
+ ```
250
+ ````
251
+
252
+ Remove the space before `!` when using this syntax. This renders as:
253
+
254
+ ```typescript
255
+ // [!code word:config]
256
+ const config = {
257
+ theme: "dark",
258
+ };
259
+
260
+ console.log(config);
261
+ ```
262
+
263
+ ### Diff Syntax
264
+
265
+ Show additions and deletions with `[!code ++]` and `[!code --]`:
266
+
267
+ ````md
268
+ ```typescript
269
+ const config = {
270
+ theme: "light", // [ !code --]
271
+ theme: "dark", // [ !code ++]
272
+ language: "en",
273
+ };
274
+ ```
275
+ ````
276
+
277
+ Remove the space before `!` when using this syntax. This renders as:
278
+
279
+ ```typescript
280
+ const config = {
281
+ theme: "light", // [!code --]
282
+ theme: "dark", // [!code ++]
283
+ language: "en",
284
+ };
285
+ ```
286
+
287
+ ### Focus Lines
288
+
289
+ Draw attention to specific lines with `[!code focus]`:
290
+
291
+ ````md
292
+ ```typescript
293
+ const numbers = [1, 2, 3, 4, 5];
294
+ const sum = numbers.reduce((a, b) => a + b, 0); // [ !code focus]
295
+ console.log(sum);
296
+ ```
297
+ ````
298
+
299
+ Remove the space before `!` when using this syntax. This renders as:
300
+
301
+ ```typescript
302
+ const numbers = [1, 2, 3, 4, 5];
303
+ const sum = numbers.reduce((a, b) => a + b, 0); // [!code focus]
304
+ console.log(sum);
305
+ ```
306
+
307
+ ## Mermaid Diagrams
308
+
309
+ Create diagrams and flowcharts using Mermaid syntax.
310
+
311
+ ### Flowcharts
312
+
313
+ ````md
314
+ ```mermaid
315
+ graph TD;
316
+ A[Start] --> B{Is it working?};
317
+ B -->|Yes| C[Great!];
318
+ B -->|No| D[Debug];
319
+ D --> B;
320
+ ```
321
+ ````
322
+
323
+ This renders as:
324
+
325
+ ```mermaid
326
+ graph TD;
327
+ A[Start] --> B{Is it working?};
328
+ B -->|Yes| C[Great!];
329
+ B -->|No| D[Debug];
330
+ D --> B;
331
+ ```
332
+
333
+ ### Sequence Diagrams
334
+
335
+ ````md
336
+ ```mermaid
337
+ sequenceDiagram
338
+ participant User
339
+ participant API
340
+ participant Database
341
+ User->>API: Request data
342
+ API->>Database: Query
343
+ Database-->>API: Results
344
+ API-->>User: Response
345
+ ```
346
+ ````
347
+
348
+ This renders as:
349
+
350
+ ```mermaid
351
+ sequenceDiagram
352
+ participant User
353
+ participant API
354
+ participant Database
355
+ User->>API: Request data
356
+ API->>Database: Query
357
+ Database-->>API: Results
358
+ API-->>User: Response
359
+ ```
360
+
361
+ ### Architecture Diagrams
362
+
363
+ ````md
364
+ ```mermaid
365
+ graph TD;
366
+ subgraph Frontend
367
+ A[Web App]
368
+ B[Mobile App]
369
+ end
370
+ subgraph Backend
371
+ C[API Gateway]
372
+ D[Auth Service]
373
+ E[Data Service]
374
+ end
375
+ subgraph Storage
376
+ F[(Database)]
377
+ G[(Cache)]
378
+ end
379
+ A --> C
380
+ B --> C
381
+ C --> D
382
+ C --> E
383
+ E --> F
384
+ E --> G
385
+ ```
386
+ ````
387
+
388
+ This renders as:
389
+
390
+ ```mermaid
391
+ graph TD;
392
+ subgraph Frontend
393
+ A[Web App]
394
+ B[Mobile App]
395
+ end
396
+ subgraph Backend
397
+ C[API Gateway]
398
+ D[Auth Service]
399
+ E[Data Service]
400
+ end
401
+ subgraph Storage
402
+ F[(Database)]
403
+ G[(Cache)]
404
+ end
405
+ A --> C
406
+ B --> C
407
+ C --> D
408
+ C --> E
409
+ E --> F
410
+ E --> G
411
+ ```
@@ -0,0 +1,57 @@
1
+ ---
2
+ title: Theme-Aware Image
3
+ description: Display different images based on the user's light or dark theme preference
4
+ type: reference
5
+ summary: A component that swaps images based on the active theme, built on top of Next.js Image.
6
+ prerequisites:
7
+ - /docs/getting-started
8
+ - /docs/provider
9
+ related:
10
+ - /docs/syntax
11
+ - /docs/configuration
12
+ ---
13
+
14
+ The `ThemeAwareImage` component renders different images depending on whether the user is viewing your documentation in light or dark mode. It extends the Next.js `Image` component, so you get all the same optimization benefits like lazy loading, responsive sizing, and format conversion.
15
+
16
+ <CopyPrompt text="Help me add a theme-aware image to a Geistdocs MDX page. Create a usage example with light and dark image sources, alt text, width, and height, then explain where to place the image files.">
17
+ Help me add a theme-aware image to a Geistdocs MDX page. Create a usage example with light and dark image sources, alt text, width, and height, then explain where to place the image files.
18
+ </CopyPrompt>
19
+
20
+ ## Usage
21
+
22
+ Import the component and pass a `src` object with `light` and `dark` variants:
23
+
24
+ ```tsx
25
+ import { ThemeAwareImage } from "@/components/geistdocs/theme-aware-image";
26
+
27
+ <ThemeAwareImage
28
+ src={{
29
+ light: "/images/diagram-light.png",
30
+ dark: "/images/diagram-dark.png",
31
+ }}
32
+ alt="Architecture diagram"
33
+ width={800}
34
+ height={400}
35
+ />
36
+ ```
37
+
38
+ The component reads the current theme from `next-themes` and resolves the correct image source automatically. All standard Next.js `Image` props (such as `width`, `height`, `alt`, `priority`, and `className`) are supported.
39
+
40
+ ## How it works
41
+
42
+ `ThemeAwareImage` uses the `resolvedTheme` value from the `useTheme` hook provided by `next-themes`. This ensures it responds to the actual rendered theme, even when the user's preference is set to "system".
43
+
44
+ - When `resolvedTheme` is `"dark"`, the `src.dark` image is displayed.
45
+ - Otherwise, the `src.light` image is used.
46
+
47
+ Because this component relies on client-side theme detection, it is a client component (`"use client"`).
48
+
49
+ ## Props
50
+
51
+ | Prop | Type | Description |
52
+ | --- | --- | --- |
53
+ | `src` | `{ light: ImageProps["src"]; dark: ImageProps["src"] }` | An object containing the light and dark image sources |
54
+ | `alt` | `string` | Accessible alt text for the image |
55
+ | `width` | `number` | The width of the image in pixels |
56
+ | `height` | `number` | The height of the image in pixels |
57
+ | `...rest` | `ImageProps` | Any additional props supported by the Next.js `Image` component |
@@ -0,0 +1,51 @@
1
+ export const Logo = () => (
2
+ <span className="font-semibold text-gray-1000 text-lg leading-none tracking-[-3%]">
3
+ Geistdocs
4
+ </span>
5
+ );
6
+
7
+ export const github = {
8
+ owner: "vercel",
9
+ repo: "geistdocs",
10
+ };
11
+
12
+ export const nav = [
13
+ {
14
+ label: "Docs",
15
+ href: "/docs",
16
+ },
17
+ {
18
+ label: "Source",
19
+ href: `https://github.com/${github.owner}/${github.repo}/`,
20
+ },
21
+ ];
22
+
23
+ export const suggestions = [
24
+ "What is Geistdocs?",
25
+ "What can I make with Geistdocs?",
26
+ "What syntax does Geistdocs support?",
27
+ "How do I deploy my Geistdocs site?",
28
+ ];
29
+
30
+ export const title = "Geistdocs Documentation";
31
+
32
+ export const prompt =
33
+ "You are a helpful assistant specializing in answering questions about Geistdocs, a modern documentation template built with Next.js and Fumadocs.";
34
+
35
+ export const translations = {
36
+ en: {
37
+ displayName: "English",
38
+ },
39
+ cn: {
40
+ displayName: "Chinese",
41
+ search: "搜尋文檔",
42
+ },
43
+ };
44
+
45
+ export const basePath: string | undefined = undefined;
46
+
47
+ /**
48
+ * Unique identifier for this site, used in markdown request tracking analytics.
49
+ * Each site using geistdocs should set this to a unique value (e.g. "ai-sdk-docs", "next-docs").
50
+ */
51
+ export const siteId: string | undefined = undefined;
@@ -0,0 +1,13 @@
1
+ import { atom, useAtom } from "jotai";
2
+
3
+ // Export the sidebar open state atom so it can be used from other parts of the app
4
+ export const sidebarOpenAtom = atom<boolean>(false);
5
+
6
+ export const useSidebarContext = () => {
7
+ const [isOpen, setIsOpen] = useAtom(sidebarOpenAtom);
8
+
9
+ return {
10
+ isOpen,
11
+ setIsOpen,
12
+ };
13
+ };
@@ -0,0 +1,19 @@
1
+ import * as React from "react"
2
+
3
+ const MOBILE_BREAKPOINT = 768
4
+
5
+ export function useIsMobile() {
6
+ const [isMobile, setIsMobile] = React.useState<boolean | undefined>(undefined)
7
+
8
+ React.useEffect(() => {
9
+ const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`)
10
+ const onChange = () => {
11
+ setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
12
+ }
13
+ mql.addEventListener("change", onChange)
14
+ setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
15
+ return () => mql.removeEventListener("change", onChange)
16
+ }, [])
17
+
18
+ return !!isMobile
19
+ }
@@ -0,0 +1,27 @@
1
+ import { defineConfig } from "@vercel/geistdocs/config";
2
+ import {
3
+ basePath,
4
+ github,
5
+ Logo,
6
+ nav,
7
+ prompt,
8
+ siteId,
9
+ suggestions,
10
+ title,
11
+ translations,
12
+ } from "@/geistdocs";
13
+
14
+ export const config = defineConfig({
15
+ title,
16
+ defaultLanguage: "en",
17
+ logo: <Logo />,
18
+ github,
19
+ nav,
20
+ basePath,
21
+ siteId,
22
+ translations,
23
+ ai: {
24
+ prompt,
25
+ suggestions,
26
+ },
27
+ });
@@ -0,0 +1,18 @@
1
+ import {
2
+ Geist_Mono as createMono,
3
+ Geist as createSans,
4
+ } from "next/font/google";
5
+
6
+ export const sans = createSans({
7
+ variable: "--font-sans",
8
+ subsets: ["latin"],
9
+ weight: "variable",
10
+ display: "swap",
11
+ });
12
+
13
+ export const mono = createMono({
14
+ variable: "--font-mono",
15
+ subsets: ["latin"],
16
+ weight: "variable",
17
+ display: "swap",
18
+ });
@@ -0,0 +1,13 @@
1
+ import { defineI18n } from "fumadocs-core/i18n";
2
+ import { defineI18nUI } from "fumadocs-ui/i18n";
3
+ import { translations } from "@/geistdocs";
4
+
5
+ export const i18n = defineI18n({
6
+ defaultLanguage: "en",
7
+ languages: Object.keys(translations),
8
+ hideLocale: "default-locale",
9
+ });
10
+
11
+ export const { provider: i18nProvider } = defineI18nUI(i18n, {
12
+ translations,
13
+ });
@@ -0,0 +1,56 @@
1
+ import type { DetectionMethod } from "@vercel/agent-readability";
2
+ import { siteId } from "@/geistdocs";
3
+
4
+ const PLATFORM_URL = "https://geistdocs.com/md-tracking";
5
+
6
+ interface TrackMdRequestParams {
7
+ acceptHeader: string | null;
8
+ /** Detection method used to identify the agent (only for agent-rewrite requests) */
9
+ detectionMethod?: DetectionMethod | null;
10
+ path: string;
11
+ referer: string | null;
12
+ /** How the markdown was requested: 'md-url' for direct .md URLs, 'header-negotiated' for Accept header, 'agent-rewrite' for detected AI agents */
13
+ requestType?: "md-url" | "header-negotiated" | "agent-rewrite";
14
+ userAgent: string | null;
15
+ }
16
+
17
+ /**
18
+ * Track a markdown page request via the geistdocs platform.
19
+ * Fire-and-forget: errors are logged but don't affect the response.
20
+ */
21
+ export async function trackMdRequest({
22
+ path,
23
+ userAgent,
24
+ referer,
25
+ acceptHeader,
26
+ requestType,
27
+ detectionMethod,
28
+ }: TrackMdRequestParams): Promise<void> {
29
+ try {
30
+ const response = await fetch(PLATFORM_URL, {
31
+ method: "POST",
32
+ headers: {
33
+ "Content-Type": "application/json",
34
+ },
35
+ body: JSON.stringify({
36
+ path,
37
+ siteId: siteId ?? "geistdocs-unknown",
38
+ userAgent,
39
+ referer,
40
+ acceptHeader,
41
+ requestType,
42
+ detectionMethod,
43
+ }),
44
+ });
45
+
46
+ if (!response.ok) {
47
+ console.error(
48
+ "MD tracking failed:",
49
+ response.status,
50
+ await response.text()
51
+ );
52
+ }
53
+ } catch (error) {
54
+ console.error("MD tracking error:", error);
55
+ }
56
+ }
@@ -0,0 +1,12 @@
1
+ import { createSource } from "@vercel/geistdocs/source";
2
+ import { docs } from "@/.source/server";
3
+ import { config } from "./config";
4
+
5
+ export const geistdocsSource = createSource({
6
+ docs,
7
+ config,
8
+ });
9
+
10
+ export const source = geistdocsSource.source;
11
+ export const getPageImage = geistdocsSource.getPageImage;
12
+ export const getLLMText = geistdocsSource.getPageMarkdown;
@@ -0,0 +1,6 @@
1
+ import { clsx, type ClassValue } from "clsx"
2
+ import { twMerge } from "tailwind-merge"
3
+
4
+ export function cn(...inputs: ClassValue[]) {
5
+ return twMerge(clsx(inputs))
6
+ }
@@ -0,0 +1,22 @@
1
+ import { createMDX } from "fumadocs-mdx/next";
2
+ import type { NextConfig } from "next";
3
+
4
+ const withMDX = createMDX();
5
+
6
+ const config: NextConfig = {
7
+ experimental: {
8
+ turbopackFileSystemCacheForDev: true,
9
+ },
10
+
11
+ images: {
12
+ formats: ["image/avif", "image/webp"],
13
+ remotePatterns: [
14
+ {
15
+ protocol: "https",
16
+ hostname: "placehold.co",
17
+ },
18
+ ],
19
+ },
20
+ };
21
+
22
+ export default withMDX(config);