@vercel/geistdocs 2.6.1 → 2.7.1

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 (99) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/components/toasts.d.ts +10 -0
  3. package/dist/components/toasts.d.ts.map +1 -0
  4. package/dist/components/toasts.js +16 -0
  5. package/dist/internal/github-button.d.ts.map +1 -1
  6. package/dist/internal/github-button.js +2 -1
  7. package/dist/providers/public/components/badge.d.ts +13 -6
  8. package/dist/providers/public/components/badge.d.ts.map +1 -1
  9. package/dist/providers/public/components/badge.js +54 -9
  10. package/dist/providers/public/components/code-block-server.d.ts.map +1 -1
  11. package/dist/providers/public/components/code-block-server.js +13 -3
  12. package/dist/providers/public/components/filename-icon.d.ts +3 -0
  13. package/dist/providers/public/components/filename-icon.d.ts.map +1 -0
  14. package/dist/providers/public/components/filename-icon.js +13 -0
  15. package/dist/providers/public/components/input.d.ts +27 -0
  16. package/dist/providers/public/components/input.d.ts.map +1 -0
  17. package/dist/providers/public/components/input.js +27 -0
  18. package/dist/providers/public/components/theme-switcher.d.ts +5 -1
  19. package/dist/providers/public/components/theme-switcher.d.ts.map +1 -1
  20. package/dist/providers/public/components/theme-switcher.js +7 -3
  21. package/dist/providers/public/components/toasts.d.ts +1 -0
  22. package/dist/providers/public/components/toasts.d.ts.map +1 -1
  23. package/dist/providers/public/components/toasts.js +21 -1
  24. package/dist/providers/public/components/toggle.d.ts +26 -0
  25. package/dist/providers/public/components/toggle.d.ts.map +1 -0
  26. package/dist/providers/public/components/toggle.js +53 -0
  27. package/dist/providers/public/components/tooltip.d.ts +33 -7
  28. package/dist/providers/public/components/tooltip.d.ts.map +1 -1
  29. package/dist/providers/public/components/tooltip.js +19 -1
  30. package/dist/providers/public-assets/icons.d.ts +1 -0
  31. package/dist/providers/public-assets/icons.d.ts.map +1 -1
  32. package/dist/providers/public-assets/icons.js +1 -0
  33. package/docs/agents.md +25 -2
  34. package/docs/llms.txt +1023 -18
  35. package/docs/manifest.json +211 -4
  36. package/docs/pages/components/badge.md +30 -0
  37. package/docs/pages/components/button.md +28 -0
  38. package/docs/pages/components/callout.md +28 -0
  39. package/docs/pages/components/code-block.md +62 -0
  40. package/docs/pages/components/collapsible.md +38 -0
  41. package/docs/pages/components/command-prompt.md +59 -0
  42. package/docs/pages/components/copy-prompt.md +25 -0
  43. package/docs/pages/components/details.md +37 -0
  44. package/docs/pages/components/dropdown-menu.md +43 -0
  45. package/docs/pages/components/image.md +36 -0
  46. package/docs/pages/components/index.md +49 -0
  47. package/docs/pages/components/input.md +35 -0
  48. package/docs/pages/components/link.md +28 -0
  49. package/docs/pages/components/mermaid.md +29 -0
  50. package/docs/pages/components/navigation-menu.md +50 -0
  51. package/docs/pages/components/popover.md +38 -0
  52. package/docs/pages/components/scroll-area.md +40 -0
  53. package/docs/pages/components/tabs.md +47 -0
  54. package/docs/pages/components/theme-switcher.md +32 -0
  55. package/docs/pages/components/toast.md +49 -0
  56. package/docs/pages/components/toggle.md +37 -0
  57. package/docs/pages/components/tooltip.md +36 -0
  58. package/docs/pages/components/video.md +26 -0
  59. package/docs/pages/index.md +1 -1
  60. package/docs/pages/migration.md +5 -5
  61. package/docs/pages/provider.md +11 -3
  62. package/docs/pages/syntax.md +7 -7
  63. package/docs/sitemap.md +24 -1
  64. package/package.json +33 -1
  65. package/public-foundation.css +1 -1
  66. package/template/components/geistdocs/toast-demo.tsx +33 -0
  67. package/template/components/geistdocs/toggle-demo.tsx +14 -0
  68. package/template/content/docs/components/badge.mdx +26 -0
  69. package/template/content/docs/components/button.mdx +24 -0
  70. package/template/content/docs/components/callout.mdx +24 -0
  71. package/template/content/docs/components/code-block.mdx +58 -0
  72. package/template/content/docs/components/collapsible.mdx +34 -0
  73. package/template/content/docs/components/command-prompt.mdx +55 -0
  74. package/template/content/docs/components/copy-prompt.mdx +23 -0
  75. package/template/content/docs/components/details.mdx +33 -0
  76. package/template/content/docs/components/dropdown-menu.mdx +39 -0
  77. package/template/content/docs/components/image.mdx +32 -0
  78. package/template/content/docs/components/index.mdx +45 -0
  79. package/template/content/docs/components/input.mdx +31 -0
  80. package/template/content/docs/components/link.mdx +24 -0
  81. package/template/content/docs/components/mermaid.mdx +25 -0
  82. package/template/content/docs/components/meta.json +25 -1
  83. package/template/content/docs/components/navigation-menu.mdx +46 -0
  84. package/template/content/docs/components/popover.mdx +34 -0
  85. package/template/content/docs/components/scroll-area.mdx +36 -0
  86. package/template/content/docs/components/tabs.mdx +43 -0
  87. package/template/content/docs/components/theme-switcher.mdx +28 -0
  88. package/template/content/docs/components/toast.mdx +45 -0
  89. package/template/content/docs/components/toggle.mdx +33 -0
  90. package/template/content/docs/components/tooltip.mdx +32 -0
  91. package/template/content/docs/components/video.mdx +22 -0
  92. package/template/content/docs/index.mdx +1 -1
  93. package/template/content/docs/meta.json +1 -1
  94. package/template/content/docs/migration.mdx +5 -5
  95. package/template/content/docs/provider.cn.mdx +11 -3
  96. package/template/content/docs/provider.mdx +11 -3
  97. package/template/content/docs/syntax.cn.mdx +3 -3
  98. package/template/content/docs/syntax.mdx +7 -7
  99. package/template/package.json +1 -1
package/docs/llms.txt CHANGED
@@ -1,6 +1,6 @@
1
1
  # Geistdocs Package Documentation
2
2
 
3
- These docs are bundled with `@vercel/geistdocs` 2.6.1.
3
+ These docs are bundled with `@vercel/geistdocs` 2.7.1.
4
4
  They describe how to build package-backed Geistdocs sites and how to use the package APIs from generated project adapters.
5
5
 
6
6
  ## Documentation Index
@@ -12,7 +12,7 @@ They describe how to build package-backed Geistdocs sites and how to use the pac
12
12
  - [Migrate to Geistdocs](pages/migration.md): Move an existing documentation site to @vercel/geistdocs while keeping local content, routing, middleware behavior, and AI-readable surfaces intact.
13
13
  - [Choose a Geistdocs package](pages/packages.md): Use the public package by default and the private package only where restricted Vercel npm dependencies are already available.
14
14
  - [Configuration](pages/configuration.md): Configure site metadata, navigation, AI features, page actions, translations, and local adapters.
15
- - [Syntax](pages/syntax.md): Supported MDX components and syntax including tabs, text formatting, code blocks, line highlighting, and Mermaid diagrams.
15
+ - [MDX Components](pages/syntax.md): MDX component and authoring reference covering tabs, text formatting, code blocks, line highlighting, and Mermaid diagrams.
16
16
  - [Geistdocs Provider](pages/provider.md): The root provider component that wraps your application to handle toast notifications, search, and analytics.
17
17
  - [Versioned docs](pages/versioned-docs.md): Use createVersionedSources to configure stable, pre-release, or host-based documentation versions.
18
18
  - [Proxy and markdown routes](pages/proxy.md): Configure createProxy with generated route discovery, request hooks, markdown mappings, and a static Next.js matcher.
@@ -20,16 +20,39 @@ They describe how to build package-backed Geistdocs sites and how to use the pac
20
20
  - [.md Extension](pages/md.md): Access any documentation page as raw Markdown by appending .md or .mdx to the URL for AI tool consumption.
21
21
  - [Agent readiness](pages/agent-readiness.md): Generate /agents.md and /.well-known/mcp.json from Geistdocs config so agents can find docs, Markdown surfaces, API specs, and MCP endpoints.
22
22
  - [Ask AI](pages/ask-ai.md): An AI-powered chat assistant with context-aware search, persistent history, and suggested prompts for your documentation.
23
+ - [Badge](pages/components/badge.md): Import Badge from the package component subpath for labels outside authored MDX.
24
+ - [Button](pages/components/button.md): Use the provider-backed Button in application UI or directly in MDX.
25
+ - [Callout](pages/components/callout.md): Use Callout directly or compose its container, title, and description primitives.
26
+ - [Code Block](pages/components/code-block.md): Use CodeBlock when code is highlighted or assembled outside authored Markdown fences.
27
+ - [Collapsible](pages/components/collapsible.md): Compose Collapsible, CollapsibleTrigger, and CollapsibleContent in custom React UI.
28
+ - [Command Prompt](pages/components/command-prompt.md): Compose the CommandPrompt primitives for application-owned install and setup commands.
29
+ - [Components](pages/components/index.md): Browse every component subpath exported by Geistdocs. These components can be imported into application code without relying on the default MDX component map.
23
30
  - [Configure sidebar navigation](pages/guides/nested-navigation.md): Configure sidebar order, section labels, folder landing pages, and deeply nested page trees with meta.json files.
31
+ - [Copy Prompt](pages/components/copy-prompt.md): Use CopyPrompt for reusable instructions that readers can send to an AI assistant.
32
+ - [Details](pages/components/details.md): Compose Details and Summary for accessible browser-native disclosures.
33
+ - [Dropdown Menu](pages/components/dropdown-menu.md): Compose DropdownMenu primitives for application-owned menus outside MDX.
24
34
  - [Edit on GitHub](pages/edit-on-github.md): A direct link on every documentation page that lets readers propose changes through GitHub pull requests.
25
35
  - [Feedback](pages/feedback.md): An interactive feedback widget that collects user sentiment and creates structured GitHub Issues automatically.
36
+ - [Image](pages/components/image.md): Use the Geistdocs Image wrapper for documentation-aware Next.js images.
26
37
  - [Improve Ask AI answers with Mixedbread](pages/mixedbread-retrieval.md): Provision a Mixedbread Store for one Geistdocs consumer site, enable semantic retrieval, and sync documentation during production builds.
38
+ - [Input](pages/components/input.md): Use Input for text entry in custom documentation and application interfaces.
27
39
  - [Internationalization](pages/internationalization.md): Serve documentation in multiple languages with automatic translation via the Geistdocs CLI and Fumadocs routing.
28
40
  - [llms.txt](pages/llms-txt.md): A single endpoint that returns all documentation as plain Markdown text following the llms.txt standard.
41
+ - [Mermaid](pages/components/mermaid.md): Use Mermaid directly when diagram source is assembled outside an MDX Mermaid fence.
42
+ - [Native Link](pages/components/link.md): Use NativeDocsLink where Next.js client navigation is not appropriate.
43
+ - [Navigation Menu](pages/components/navigation-menu.md): Compose NavigationMenu primitives for custom product and documentation navigation.
29
44
  - [Open in Chat](pages/open-in-chat.md): Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
45
+ - [Popover](pages/components/popover.md): Compose Popover, PopoverTrigger, and PopoverContent outside MDX.
30
46
  - [RSS](pages/rss.md): An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
47
+ - [Scroll Area](pages/components/scroll-area.md): Compose ScrollArea and ScrollBar for constrained custom interfaces.
31
48
  - [Steps](pages/components/steps.md): Write consecutive headings that start with a number, such as "### 1. Install", to render a numbered step list. The Steps and Step components cover cases where a heading must be wrapped in another component.
32
49
  - [Table of contents](pages/table-of-contents.md): Geistdocs builds the "On this page" outline from your headings, indents sub-headings under their parent, and tracks the active section along a straight vertical guide rail.
50
+ - [Tabs](pages/components/tabs.md): Use Tabs for navigation-only controls or TabsWithChildren and TabContent for mounted content panels.
51
+ - [Theme Switcher](pages/components/theme-switcher.md): Use ThemeSwitcher in custom navigation, settings, and footer UI.
52
+ - [Toast](pages/components/toast.md): Trigger provider-backed success, warning, and error notifications.
53
+ - [Toggle](pages/components/toggle.md): Toggle is the provider-backed replacement for the former Switch export.
54
+ - [Tooltip](pages/components/tooltip.md): Wrap controls with provider-backed Tooltip content outside MDX.
55
+ - [Video](pages/components/video.md): Use Video for embedded video sources inside React UI or authored MDX.
33
56
  - [WebMCP](pages/webmcp.md): Expose documentation search and page reading to browser agents.
34
57
 
35
58
  ---
@@ -133,7 +156,7 @@ Advanced projects can use package APIs for versioned docs, multiple content sour
133
156
  - Read [Configuration](/docs/configuration) to customize the generated site.
134
157
  - Read [Versioned docs](/docs/versioned-docs) to configure multiple docs versions.
135
158
  - Read [Proxy and markdown routes](/docs/proxy) to add custom request logic.
136
- - Read [Syntax](/docs/syntax) to write content with MDX components.
159
+ - Read [MDX Components](/docs/syntax) to author content with the default component map.
137
160
 
138
161
 
139
162
  ---
@@ -572,12 +595,12 @@ Replace imports according to this table:
572
595
 
573
596
  | Previous Geistdocs import | Replacement |
574
597
  | --- | --- |
575
- | `components/badge`, `components/button`, or `components/theme-switcher` | Keep the import package-backed. Geistdocs resolves these template primitives through the selected public or private provider. |
576
- | `components/dialog`, `components/drawer`, `components/input`, `components/kbd`, `components/separator`, `components/sheet`, `components/spinner`, `components/textarea`, or `components/tooltip` | Import the matching component directly from `@vercel/geistcn/components/<name>` in approved private projects, or keep an application-owned public equivalent. |
577
- | `components/switch` | Import toggle controls from `@vercel/geistcn/components/toggle`. |
578
- | `components/sonner` | Use `Toasts` and `useToasts` from `@vercel/geistcn/components/toasts`. |
598
+ | `components/badge`, `components/button`, `components/input`, `components/theme-switcher`, or `components/tooltip` | Keep the import package-backed. Geistdocs resolves these template primitives through the selected public or private provider. |
599
+ | `components/dialog`, `components/drawer`, `components/kbd`, `components/separator`, `components/sheet`, `components/spinner`, or `components/textarea` | Import the matching component directly from `@vercel/geistcn/components/<name>` in approved private projects, or keep an application-owned public equivalent. |
600
+ | `components/switch` | Replace `Switch` with package-backed `Toggle` from `components/toggle`, and replace `onCheckedChange` with `onChange`. |
601
+ | `components/sonner` | Use the package-backed `useToasts` from `components/toasts`. |
579
602
  | `components/theme-aware-image` | Use `Image` from `@vercel/geistcn/components/image` with `srcLight` and `srcDark`. |
580
- | `assets/icons`, `assets/icons/*`, `assets/logos`, or `assets/logos/*` | Import from `@vercel/geistcn-assets/icons`, `@vercel/geistcn-assets/icons/*`, `@vercel/geistcn-assets/logos`, or `@vercel/geistcn-assets/logos/*`. |
603
+ | `assets/icons`, `assets/icons/*`, `assets/logos`, or `assets/logos/*` | Keep the import package-backed. Both Geistdocs package variants expose the index and deep asset subpaths. |
581
604
  | `components/button-group`, `components/card`, or `components/input-group` | Use an appropriate Geistcn component or keep an application-owned composition. There is no direct Geistcn replacement with the same API. |
582
605
 
583
606
  Keep documentation-specific composites such as `Callout`, `CodeBlock`, `CodeBlockTabs`, `CommandPrompt`, `CopyPrompt`, and `Mermaid` imported from `@vercel/geistdocs/components/*`.
@@ -1553,10 +1576,10 @@ If a release adds an optional prop or config field, opt into it by editing the r
1553
1576
  ---
1554
1577
 
1555
1578
  ---
1556
- title: Syntax
1557
- description: Learn about the supported markdown syntax and formatting options
1579
+ title: MDX Components
1580
+ description: Author MDX content with supported components, Markdown syntax, and formatting options
1558
1581
  type: reference
1559
- summary: Supported MDX components and syntax including tabs, text formatting, code blocks, line highlighting, and Mermaid diagrams.
1582
+ summary: MDX component and authoring reference covering tabs, text formatting, code blocks, line highlighting, and Mermaid diagrams.
1560
1583
  url: /docs/syntax
1561
1584
  source: apps/template/content/docs/syntax.mdx
1562
1585
  prerequisites:
@@ -1565,13 +1588,13 @@ related:
1565
1588
  - /docs/configuration
1566
1589
  ---
1567
1590
 
1568
- # Syntax
1591
+ # MDX Components
1569
1592
 
1570
1593
  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.
1571
1594
 
1572
- Help me write a Geistdocs MDX page. Use this page as a syntax reference and
1573
- create an example page with frontmatter, headings, links, a code block, a
1574
- `Callout`, and a `CopyPrompt` component.
1595
+ Help me write a Geistdocs MDX page. Use this page as an MDX component
1596
+ reference and create an example page with frontmatter, headings, links, a
1597
+ code block, a `Callout`, and a `CopyPrompt` component.
1575
1598
 
1576
1599
  ## Frontmatter
1577
1600
 
@@ -2421,10 +2444,18 @@ If Ask AI fails while rendering, its panel shows **Try again** and **Close** act
2421
2444
  The provider includes a global toast notification system. Use it anywhere in your app:
2422
2445
 
2423
2446
  ```tsx title="page.tsx"
2424
- import { toast } from "sonner";
2447
+ "use client";
2425
2448
 
2426
- toast.success("Changes saved");
2427
- toast.error("Something went wrong");
2449
+ import { useToasts } from "@vercel/geistdocs/components/toasts";
2450
+
2451
+ export function StatusActions() {
2452
+ const toast = useToasts();
2453
+
2454
+ // Trigger these from your event handlers:
2455
+ toast.success({ text: "Changes saved" });
2456
+ toast.warning({ text: "Review these changes" });
2457
+ toast.error({ text: "Something went wrong" });
2458
+ }
2428
2459
  ```
2429
2460
 
2430
2461
  ## Analytics
@@ -3939,6 +3970,328 @@ In default AI Gateway mode, Geistdocs uses `openai/gpt-5.6-sol` via the Vercel A
3939
3970
  You can customize the initial suggested prompts shown to users. These are configured in the Geistdocs configuration file, which you can read more about in the [Configuration](/docs/configuration) section.
3940
3971
 
3941
3972
 
3973
+ ---
3974
+
3975
+ ---
3976
+ title: Badge
3977
+ description: Render compact status and category labels
3978
+ type: reference
3979
+ summary: Import Badge from the package component subpath for labels outside authored MDX.
3980
+ url: /docs/components/badge
3981
+ source: apps/template/content/docs/components/badge.mdx
3982
+ related:
3983
+ - /docs/components
3984
+ ---
3985
+
3986
+ # Badge
3987
+
3988
+ import { Badge } from "@vercel/geistdocs/components/badge";
3989
+
3990
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
3991
+ <Badge variant="blue">New</Badge>
3992
+ </div>
3993
+
3994
+ Import `Badge` from the selected Geistdocs package:
3995
+
3996
+ ```tsx
3997
+ import { Badge } from "@vercel/geistdocs/components/badge";
3998
+
3999
+ export function Status() {
4000
+ return <Badge variant="blue">New</Badge>;
4001
+ }
4002
+ ```
4003
+
4004
+ The public variant supports `gray`, `blue`, `red`, `amber`, and `green` tones. The private package resolves the component through Geistcn.
4005
+
4006
+
4007
+ ---
4008
+
4009
+ ---
4010
+ title: Button
4011
+ description: Render buttons and link-style actions
4012
+ type: reference
4013
+ summary: Use the provider-backed Button in application UI or directly in MDX.
4014
+ url: /docs/components/button
4015
+ source: apps/template/content/docs/components/button.mdx
4016
+ related:
4017
+ - /docs/components
4018
+ ---
4019
+
4020
+ # Button
4021
+
4022
+ import { Button } from "@vercel/geistdocs/components/button";
4023
+
4024
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
4025
+ <Button variant="secondary">Continue</Button>
4026
+ </div>
4027
+
4028
+ ```tsx
4029
+ import { Button } from "@vercel/geistdocs/components/button";
4030
+
4031
+ export function Actions() {
4032
+ return <Button variant="secondary">Continue</Button>;
4033
+ }
4034
+ ```
4035
+
4036
+ `Button` supports native buttons, anchors, and internal localized links. It is also included in the default MDX component map.
4037
+
4038
+
4039
+ ---
4040
+
4041
+ ---
4042
+ title: Callout
4043
+ description: Render notices with optional titles and descriptions
4044
+ type: reference
4045
+ summary: Use Callout directly or compose its container, title, and description primitives.
4046
+ url: /docs/components/callout
4047
+ source: apps/template/content/docs/components/callout.mdx
4048
+ related:
4049
+ - /docs/components
4050
+ ---
4051
+
4052
+ # Callout
4053
+
4054
+ import { Callout } from "@vercel/geistdocs/components/callout";
4055
+
4056
+ <div className="not-prose my-6 rounded-lg border border-gray-400 bg-background-100 p-6">
4057
+ > Restart the dev server after changing configuration.
4058
+ </div>
4059
+
4060
+ ```tsx
4061
+ import { Callout } from "@vercel/geistdocs/components/callout";
4062
+
4063
+ export function Notice() {
4064
+ return <Callout title="Note">Restart the dev server after changing configuration.</Callout>;
4065
+ }
4066
+ ```
4067
+
4068
+ The subpath also exports `CalloutContainer`, `CalloutTitle`, and `CalloutDescription`. These components are included in the default MDX component map.
4069
+
4070
+
4071
+ ---
4072
+
4073
+ ---
4074
+ title: Code Block
4075
+ description: Render highlighted code with filename and copy controls
4076
+ type: reference
4077
+ summary: Use CodeBlock when code is highlighted or assembled outside authored Markdown fences.
4078
+ url: /docs/components/code-block
4079
+ source: apps/template/content/docs/components/code-block.mdx
4080
+ related:
4081
+ - /docs/components
4082
+ - /docs/syntax
4083
+ ---
4084
+
4085
+ # Code Block
4086
+
4087
+ import { CodeBlock } from "@vercel/geistdocs/components/code-block";
4088
+ import {
4089
+ CodeBlockTab,
4090
+ CodeBlockTabs,
4091
+ CodeBlockTabsList,
4092
+ CodeBlockTabsTrigger,
4093
+ } from "@vercel/geistdocs/components/code-block-tabs";
4094
+
4095
+ ## Code block
4096
+
4097
+ <div className="not-prose my-6">
4098
+ <CodeBlock title="example.ts">{'export const enabled = true;'}</CodeBlock>
4099
+ </div>
4100
+
4101
+ ```tsx
4102
+ import { CodeBlock } from "@vercel/geistdocs/components/code-block";
4103
+ ```
4104
+
4105
+ Pass a `title` to show header chrome with a filename-aware icon and copy control. Markdown code fences use `CodeBlock` automatically through the default MDX map.
4106
+
4107
+ ## Code block with tabs
4108
+
4109
+ <div className="not-prose my-6">
4110
+ <CodeBlockTabs defaultValue="pnpm">
4111
+ <CodeBlockTabsList>
4112
+ <CodeBlockTabsTrigger value="pnpm">pnpm</CodeBlockTabsTrigger>
4113
+ <CodeBlockTabsTrigger value="npm">npm</CodeBlockTabsTrigger>
4114
+ </CodeBlockTabsList>
4115
+ <CodeBlockTab value="pnpm">
4116
+ <CodeBlock title="Terminal">pnpm add @vercel/geistdocs</CodeBlock>
4117
+ </CodeBlockTab>
4118
+ <CodeBlockTab value="npm">
4119
+ <CodeBlock title="Terminal">npm install @vercel/geistdocs</CodeBlock>
4120
+ </CodeBlockTab>
4121
+ </CodeBlockTabs>
4122
+ </div>
4123
+
4124
+ ```tsx
4125
+ import {
4126
+ CodeBlockTab,
4127
+ CodeBlockTabs,
4128
+ CodeBlockTabsList,
4129
+ CodeBlockTabsTrigger,
4130
+ CompactCodeBlockTabs,
4131
+ } from "@vercel/geistdocs/components/code-block-tabs";
4132
+ ```
4133
+
4134
+ The same components are available without imports in authored MDX.
4135
+
4136
+
4137
+ ---
4138
+
4139
+ ---
4140
+ title: Collapsible
4141
+ description: Show and hide expandable content regions
4142
+ type: reference
4143
+ summary: Compose Collapsible, CollapsibleTrigger, and CollapsibleContent in custom React UI.
4144
+ url: /docs/components/collapsible
4145
+ source: apps/template/content/docs/components/collapsible.mdx
4146
+ related:
4147
+ - /docs/components
4148
+ - /docs/components/details
4149
+ ---
4150
+
4151
+ # Collapsible
4152
+
4153
+ import {
4154
+ Collapsible,
4155
+ CollapsibleContent,
4156
+ CollapsibleTrigger,
4157
+ } from "@vercel/geistdocs/components/collapsible";
4158
+
4159
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
4160
+ <Collapsible className="w-full max-w-sm" defaultOpen>
4161
+ <CollapsibleTrigger className="font-medium">Advanced options</CollapsibleTrigger>
4162
+ <CollapsibleContent className="pt-3 text-gray-900">
4163
+ Configure optional behavior here.
4164
+ </CollapsibleContent>
4165
+ </Collapsible>
4166
+ </div>
4167
+
4168
+ ```tsx
4169
+ import {
4170
+ Collapsible,
4171
+ CollapsibleContent,
4172
+ CollapsibleTrigger,
4173
+ } from "@vercel/geistdocs/components/collapsible";
4174
+ ```
4175
+
4176
+ Use the native [Details](/docs/components/details) component when browser-native disclosure behavior is sufficient.
4177
+
4178
+
4179
+ ---
4180
+
4181
+ ---
4182
+ title: Command Prompt
4183
+ description: Render copyable commands and selectable command alternatives
4184
+ type: reference
4185
+ summary: Compose the CommandPrompt primitives for application-owned install and setup commands.
4186
+ url: /docs/components/command-prompt
4187
+ source: apps/template/content/docs/components/command-prompt.mdx
4188
+ related:
4189
+ - /docs/components
4190
+ - /docs/components/copy-prompt
4191
+ ---
4192
+
4193
+ # Command Prompt
4194
+
4195
+ import {
4196
+ CommandPromptContent,
4197
+ CommandPromptCopy,
4198
+ CommandPromptList,
4199
+ CommandPromptPrefix,
4200
+ CommandPromptRoot,
4201
+ CommandPromptSurface,
4202
+ CommandPromptTrigger,
4203
+ CommandPromptTriggerDivider,
4204
+ CommandPromptViewport,
4205
+ } from "@vercel/geistdocs/components/command-prompt";
4206
+
4207
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
4208
+ <CommandPromptRoot defaultValue="pnpm">
4209
+ <CommandPromptList>
4210
+ <CommandPromptTrigger value="pnpm">pnpm</CommandPromptTrigger>
4211
+ <CommandPromptTriggerDivider />
4212
+ <CommandPromptTrigger value="npm">npm</CommandPromptTrigger>
4213
+ </CommandPromptList>
4214
+ <CommandPromptSurface>
4215
+ <CommandPromptPrefix>$</CommandPromptPrefix>
4216
+ <CommandPromptViewport>
4217
+ <CommandPromptContent value="pnpm">pnpm add @vercel/geistdocs</CommandPromptContent>
4218
+ <CommandPromptContent value="npm">npm install @vercel/geistdocs</CommandPromptContent>
4219
+ </CommandPromptViewport>
4220
+ <CommandPromptCopy aria-label="Copy command" />
4221
+ </CommandPromptSurface>
4222
+ </CommandPromptRoot>
4223
+ </div>
4224
+
4225
+ ```tsx
4226
+ import {
4227
+ CommandPromptContent,
4228
+ CommandPromptCopy,
4229
+ CommandPromptList,
4230
+ CommandPromptPrefix,
4231
+ CommandPromptRoot,
4232
+ CommandPromptSurface,
4233
+ CommandPromptTrigger,
4234
+ CommandPromptTriggerDivider,
4235
+ CommandPromptViewport,
4236
+ } from "@vercel/geistdocs/components/command-prompt";
4237
+ ```
4238
+
4239
+ `CommandPromptRoot` owns the active command and copy state. Compose the remaining primitives within it to build a single command or a selectable package-manager list.
4240
+
4241
+
4242
+ ---
4243
+
4244
+ ---
4245
+ title: Components
4246
+ description: Importable React components exposed by Geistdocs for application UI and documentation experiences
4247
+ type: overview
4248
+ summary: Browse every component subpath exported by Geistdocs. These components can be imported into application code without relying on the default MDX component map.
4249
+ url: /docs/components/index
4250
+ source: apps/template/content/docs/components/index.mdx
4251
+ related:
4252
+ - /docs/syntax
4253
+ - /docs/packages
4254
+ ---
4255
+
4256
+ # Components
4257
+
4258
+ Geistdocs exports reusable React components for application UI, custom documentation layouts, and authored content. Import from the package variant selected by your project:
4259
+
4260
+ ```tsx
4261
+ import { Button } from "@vercel/geistdocs/components/button";
4262
+ ```
4263
+
4264
+ Internal projects using `@vercel/geistdocs-private` use the same component subpaths. The private package resolves primitives through Geistcn; the public package provides public equivalents.
4265
+
4266
+ | Component | Import subpath | Purpose |
4267
+ | --- | --- | --- |
4268
+ | [Badge](/docs/components/badge) | `components/badge` | Compact status and category labels |
4269
+ | [Button](/docs/components/button) | `components/button` | Buttons and link-style actions |
4270
+ | [Input](/docs/components/input) | `components/input` | Text input fields with provider-backed styling |
4271
+ | [Toggle](/docs/components/toggle) | `components/toggle` | Controlled boolean controls |
4272
+ | [Tooltip](/docs/components/tooltip) | `components/tooltip` | Contextual hover and focus labels |
4273
+ | [Toast](/docs/components/toast) | `components/toasts` | Global success, warning, and error notifications |
4274
+ | [Theme Switcher](/docs/components/theme-switcher) | `components/theme-switcher` | System, light, and dark theme selection |
4275
+ | [Tabs](/docs/components/tabs) | `components/tabs`, `components/tabs-with-children` | Tab navigation and mounted content panels |
4276
+ | [Collapsible](/docs/components/collapsible) | `components/collapsible` | Expandable content regions |
4277
+ | [Details](/docs/components/details) | `components/details` | Styled native disclosure elements |
4278
+ | [Callout](/docs/components/callout) | `components/callout` | Notices with optional titles and descriptions |
4279
+ | [Code Block](/docs/components/code-block) | `components/code-block`, `components/code-block-tabs` | Highlighted code and tabbed code groups |
4280
+ | [Command Prompt](/docs/components/command-prompt) | `components/command-prompt` | Command surfaces with copy support and alternatives |
4281
+ | [Copy Prompt](/docs/components/copy-prompt) | `components/copy-prompt` | Copyable prompts for agents and language models |
4282
+ | [Dropdown Menu](/docs/components/dropdown-menu) | `components/dropdown-menu` | Accessible action menus |
4283
+ | [Navigation Menu](/docs/components/navigation-menu) | `components/navigation-menu` | Accessible navigation flyouts |
4284
+ | [Popover](/docs/components/popover) | `components/popover` | Anchored floating content |
4285
+ | [Scroll Area](/docs/components/scroll-area) | `components/scroll-area` | Styled overflow regions and scrollbars |
4286
+ | [Image](/docs/components/image) | `components/image` | Next.js images with optional light and dark sources |
4287
+ | [Native Link](/docs/components/link) | `components/link` | Styled anchors using browser-native navigation |
4288
+ | [Mermaid](/docs/components/mermaid) | `components/mermaid` | Mermaid diagram rendering |
4289
+ | [Video](/docs/components/video) | `components/video` | Responsive video playback |
4290
+ | [Steps](/docs/components/steps) | `components/steps` | Numbered procedural content |
4291
+
4292
+ Components such as `Button`, `Callout`, `CodeBlock`, and `Steps` are also included in the default MDX component map. Importing them directly is useful in React components, layouts, and custom page renderers.
4293
+
4294
+
3942
4295
  ---
3943
4296
 
3944
4297
  ---
@@ -4178,6 +4531,123 @@ Check these rules when a page or folder does not appear where expected:
4178
4531
  - Keep separator labels between three hyphens on each side, such as `---Internals---`.
4179
4532
 
4180
4533
 
4534
+ ---
4535
+
4536
+ ---
4537
+ title: Copy Prompt
4538
+ description: Render copyable prompts for agents and language models
4539
+ type: reference
4540
+ summary: Use CopyPrompt for reusable instructions that readers can send to an AI assistant.
4541
+ url: /docs/components/copy-prompt
4542
+ source: apps/template/content/docs/components/copy-prompt.mdx
4543
+ related:
4544
+ - /docs/components
4545
+ - /docs/components/command-prompt
4546
+ ---
4547
+
4548
+ # Copy Prompt
4549
+
4550
+ import { CopyPrompt } from "@vercel/geistdocs/components/copy-prompt";
4551
+
4552
+ ```tsx
4553
+ import { CopyPrompt } from "@vercel/geistdocs/components/copy-prompt";
4554
+
4555
+ export function ReviewPrompt() {
4556
+ return <CopyPrompt text="Review this project and propose the safest migration plan." />;
4557
+ }
4558
+ ```
4559
+
4560
+ `CopyPrompt` is also included in the default MDX component map.
4561
+
4562
+
4563
+ ---
4564
+
4565
+ ---
4566
+ title: Details
4567
+ description: Render styled native disclosure elements
4568
+ type: reference
4569
+ summary: Compose Details and Summary for accessible browser-native disclosures.
4570
+ url: /docs/components/details
4571
+ source: apps/template/content/docs/components/details.mdx
4572
+ related:
4573
+ - /docs/components
4574
+ - /docs/components/collapsible
4575
+ ---
4576
+
4577
+ # Details
4578
+
4579
+ import { Details, Summary } from "@vercel/geistdocs/components/details";
4580
+
4581
+ <div className="not-prose my-6 min-h-32 rounded-lg border border-gray-400 bg-background-100 p-6">
4582
+ <Details open>
4583
+ <Summary>Advanced options</Summary>
4584
+ Configure optional behavior here.
4585
+ </Details>
4586
+ </div>
4587
+
4588
+ ```tsx
4589
+ import { Details, Summary } from "@vercel/geistdocs/components/details";
4590
+
4591
+ export function Disclosure() {
4592
+ return (
4593
+ <Details>
4594
+ <Summary>Advanced options</Summary>
4595
+ Configure optional behavior here.
4596
+ </Details>
4597
+ );
4598
+ }
4599
+ ```
4600
+
4601
+ `Details` and `Summary` are also included in the default MDX component map.
4602
+
4603
+
4604
+ ---
4605
+
4606
+ ---
4607
+ title: Dropdown Menu
4608
+ description: Render accessible action and selection menus
4609
+ type: reference
4610
+ summary: Compose DropdownMenu primitives for application-owned menus outside MDX.
4611
+ url: /docs/components/dropdown-menu
4612
+ source: apps/template/content/docs/components/dropdown-menu.mdx
4613
+ related:
4614
+ - /docs/components
4615
+ - /docs/components/popover
4616
+ ---
4617
+
4618
+ # Dropdown Menu
4619
+
4620
+ import {
4621
+ DropdownMenu,
4622
+ DropdownMenuContent,
4623
+ DropdownMenuItem,
4624
+ DropdownMenuTrigger,
4625
+ } from "@vercel/geistdocs/components/dropdown-menu";
4626
+
4627
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
4628
+ <DropdownMenu>
4629
+ <DropdownMenuTrigger className="h-8 rounded-md border border-gray-400 bg-background-100 px-3">
4630
+ Open menu
4631
+ </DropdownMenuTrigger>
4632
+ <DropdownMenuContent>
4633
+ <DropdownMenuItem>Edit</DropdownMenuItem>
4634
+ <DropdownMenuItem>Duplicate</DropdownMenuItem>
4635
+ </DropdownMenuContent>
4636
+ </DropdownMenu>
4637
+ </div>
4638
+
4639
+ ```tsx
4640
+ import {
4641
+ DropdownMenu,
4642
+ DropdownMenuContent,
4643
+ DropdownMenuItem,
4644
+ DropdownMenuTrigger,
4645
+ } from "@vercel/geistdocs/components/dropdown-menu";
4646
+ ```
4647
+
4648
+ The subpath also exports label, separator, checkbox, radio, and nested submenu primitives.
4649
+
4650
+
4181
4651
  ---
4182
4652
 
4183
4653
  ---
@@ -4330,6 +4800,46 @@ Pass any additional fields in the request body, and they are captured as metadat
4330
4800
  - Custom tracking data
4331
4801
 
4332
4802
 
4803
+ ---
4804
+
4805
+ ---
4806
+ title: Image
4807
+ description: Render optimized images with optional light and dark sources
4808
+ type: reference
4809
+ summary: Use the Geistdocs Image wrapper for documentation-aware Next.js images.
4810
+ url: /docs/components/image
4811
+ source: apps/template/content/docs/components/image.mdx
4812
+ related:
4813
+ - /docs/components
4814
+ - /docs/syntax
4815
+ ---
4816
+
4817
+ # Image
4818
+
4819
+ import { Image } from "@vercel/geistdocs/components/image";
4820
+
4821
+ <div className="not-prose my-6 flex min-h-40 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
4822
+ <Image
4823
+ alt="Geistdocs preview favicon"
4824
+ className="size-16"
4825
+ figureClassName="my-0 w-auto"
4826
+ height={64}
4827
+ src="/favicon.preview.ico"
4828
+ width={64}
4829
+ />
4830
+ </div>
4831
+
4832
+ ```tsx
4833
+ import { Image } from "@vercel/geistdocs/components/image";
4834
+
4835
+ export function Screenshot() {
4836
+ return <Image alt="Project dashboard" src="/dashboard.png" />;
4837
+ }
4838
+ ```
4839
+
4840
+ Pass `srcLight` and `srcDark` for theme-aware artwork. `Image` is also included in the default MDX component map.
4841
+
4842
+
4333
4843
  ---
4334
4844
 
4335
4845
  ---
@@ -4478,6 +4988,45 @@ vercel integration open mixedbread
4478
4988
  Ask a question that uses different words from the page title. Ask AI should cite the relevant page and answer from the matching section. If Mixedbread returns an error or exceeds the request timeout, Geistdocs logs a warning and retries the question with local Orama retrieval.
4479
4989
 
4480
4990
 
4991
+ ---
4992
+
4993
+ ---
4994
+ title: Input
4995
+ description: Render accessible provider-backed text inputs
4996
+ type: reference
4997
+ summary: Use Input for text entry in custom documentation and application interfaces.
4998
+ url: /docs/components/input
4999
+ source: apps/template/content/docs/components/input.mdx
5000
+ related:
5001
+ - /docs/components
5002
+ - /docs/components/toggle
5003
+ ---
5004
+
5005
+ # Input
5006
+
5007
+ import { Input } from "@vercel/geistdocs/components/input";
5008
+
5009
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5010
+ <Input
5011
+ aria-label="Project domain"
5012
+ defaultValue="geistdocs"
5013
+ prefix="https://"
5014
+ suffix=".dev"
5015
+ width={320}
5016
+ />
5017
+ </div>
5018
+
5019
+ ```tsx
5020
+ import { Input } from "@vercel/geistdocs/components/input";
5021
+
5022
+ export function SearchField() {
5023
+ return <Input aria-label="Search documentation" placeholder="Search" />;
5024
+ }
5025
+ ```
5026
+
5027
+ Use `typeName` for the native input type. Labels, prefix and suffix adornments, error content, sizes, and rounded fields are supported by the public provider; the private package resolves the component through Geistcn.
5028
+
5029
+
4481
5030
  ---
4482
5031
 
4483
5032
  ---
@@ -4701,6 +5250,125 @@ The llms.txt standard is a simple convention that makes documentation more acces
4701
5250
  Learn more at [llmstxt.org](https://llmstxt.org/)
4702
5251
 
4703
5252
 
5253
+ ---
5254
+
5255
+ ---
5256
+ title: Mermaid
5257
+ description: Render Mermaid diagrams from chart source
5258
+ type: reference
5259
+ summary: Use Mermaid directly when diagram source is assembled outside an MDX Mermaid fence.
5260
+ url: /docs/components/mermaid
5261
+ source: apps/template/content/docs/components/mermaid.mdx
5262
+ related:
5263
+ - /docs/components
5264
+ - /docs/syntax
5265
+ ---
5266
+
5267
+ # Mermaid
5268
+
5269
+ import { Mermaid } from "@vercel/geistdocs/components/mermaid";
5270
+
5271
+ <div className="not-prose my-6 rounded-lg border border-gray-400 bg-background-100 p-6">
5272
+ <Mermaid chart={'graph LR; A["Start"] --> B["Finish"]'} />
5273
+ </div>
5274
+
5275
+ ```tsx
5276
+ import { Mermaid } from "@vercel/geistdocs/components/mermaid";
5277
+
5278
+ export function Flow() {
5279
+ return <Mermaid chart={'graph LR; A["Start"] --> B["Finish"]'} />;
5280
+ }
5281
+ ```
5282
+
5283
+ Mermaid code fences render this component automatically in authored MDX.
5284
+
5285
+
5286
+ ---
5287
+
5288
+ ---
5289
+ title: Native Link
5290
+ description: Render styled anchors with browser-native navigation
5291
+ type: reference
5292
+ summary: Use NativeDocsLink where Next.js client navigation is not appropriate.
5293
+ url: /docs/components/link
5294
+ source: apps/template/content/docs/components/link.mdx
5295
+ related:
5296
+ - /docs/components
5297
+ ---
5298
+
5299
+ # Native Link
5300
+
5301
+ import { NativeDocsLink } from "@vercel/geistdocs/components/link";
5302
+
5303
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5304
+ <NativeDocsLink href="/docs/getting-started">Read the getting started guide</NativeDocsLink>
5305
+ </div>
5306
+
5307
+ ```tsx
5308
+ import { NativeDocsLink } from "@vercel/geistdocs/components/link";
5309
+
5310
+ export function DownloadLink() {
5311
+ return <NativeDocsLink href="/download">Download</NativeDocsLink>;
5312
+ }
5313
+ ```
5314
+
5315
+ Use this component for links that must retain native document navigation. The default MDX link resolver already handles internal and external authored links.
5316
+
5317
+
5318
+ ---
5319
+
5320
+ ---
5321
+ title: Navigation Menu
5322
+ description: Render accessible navigation links and flyout content
5323
+ type: reference
5324
+ summary: Compose NavigationMenu primitives for custom product and documentation navigation.
5325
+ url: /docs/components/navigation-menu
5326
+ source: apps/template/content/docs/components/navigation-menu.mdx
5327
+ related:
5328
+ - /docs/components
5329
+ - /docs/components/dropdown-menu
5330
+ ---
5331
+
5332
+ # Navigation Menu
5333
+
5334
+ import {
5335
+ NavigationMenu,
5336
+ NavigationMenuContent,
5337
+ NavigationMenuItem,
5338
+ NavigationMenuLink,
5339
+ NavigationMenuList,
5340
+ NavigationMenuTrigger,
5341
+ } from "@vercel/geistdocs/components/navigation-menu";
5342
+
5343
+ <div className="not-prose my-6 flex min-h-40 items-start justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5344
+ <NavigationMenu>
5345
+ <NavigationMenuList>
5346
+ <NavigationMenuItem>
5347
+ <NavigationMenuTrigger>Guides</NavigationMenuTrigger>
5348
+ <NavigationMenuContent>
5349
+ <NavigationMenuLink className="block w-56 p-3" href="/docs/getting-started">
5350
+ Getting started
5351
+ </NavigationMenuLink>
5352
+ </NavigationMenuContent>
5353
+ </NavigationMenuItem>
5354
+ </NavigationMenuList>
5355
+ </NavigationMenu>
5356
+ </div>
5357
+
5358
+ ```tsx
5359
+ import {
5360
+ NavigationMenu,
5361
+ NavigationMenuContent,
5362
+ NavigationMenuItem,
5363
+ NavigationMenuLink,
5364
+ NavigationMenuList,
5365
+ NavigationMenuTrigger,
5366
+ } from "@vercel/geistdocs/components/navigation-menu";
5367
+ ```
5368
+
5369
+ The subpath also exports `NavigationMenuIndicator`, `NavigationMenuViewport`, and `navigationMenuTriggerStyle`.
5370
+
5371
+
4704
5372
  ---
4705
5373
 
4706
5374
  ---
@@ -4787,6 +5455,48 @@ Each platform has its own integration:
4787
5455
  3. **Platform flexibility**: Teams can support different AI preferences.
4788
5456
 
4789
5457
 
5458
+ ---
5459
+
5460
+ ---
5461
+ title: Popover
5462
+ description: Render anchored floating content
5463
+ type: reference
5464
+ summary: Compose Popover, PopoverTrigger, and PopoverContent outside MDX.
5465
+ url: /docs/components/popover
5466
+ source: apps/template/content/docs/components/popover.mdx
5467
+ related:
5468
+ - /docs/components
5469
+ - /docs/components/tooltip
5470
+ ---
5471
+
5472
+ # Popover
5473
+
5474
+ import {
5475
+ Popover,
5476
+ PopoverContent,
5477
+ PopoverTrigger,
5478
+ } from "@vercel/geistdocs/components/popover";
5479
+
5480
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5481
+ <Popover>
5482
+ <PopoverTrigger className="h-8 rounded-md border border-gray-400 bg-background-100 px-3">
5483
+ Open popover
5484
+ </PopoverTrigger>
5485
+ <PopoverContent>Additional context for this setting.</PopoverContent>
5486
+ </Popover>
5487
+ </div>
5488
+
5489
+ ```tsx
5490
+ import {
5491
+ Popover,
5492
+ PopoverContent,
5493
+ PopoverTrigger,
5494
+ } from "@vercel/geistdocs/components/popover";
5495
+ ```
5496
+
5497
+ Use a tooltip for short contextual labels and a popover for interactive or structured content.
5498
+
5499
+
4790
5500
  ---
4791
5501
 
4792
5502
  ---
@@ -4905,6 +5615,50 @@ lastModified: 2025-11-12
4905
5615
  Git commit dates require full git history at build time. On Vercel, set the `VERCEL_DEEP_CLONE=true` environment variable so builds clone the full history. Read [Last modified dates](/docs/configuration#last-modified-dates) for the full resolution order.
4906
5616
 
4907
5617
 
5618
+ ---
5619
+
5620
+ ---
5621
+ title: Scroll Area
5622
+ description: Render styled overflow regions and scrollbars
5623
+ type: reference
5624
+ summary: Compose ScrollArea and ScrollBar for constrained custom interfaces.
5625
+ url: /docs/components/scroll-area
5626
+ source: apps/template/content/docs/components/scroll-area.mdx
5627
+ related:
5628
+ - /docs/components
5629
+ ---
5630
+
5631
+ # Scroll Area
5632
+
5633
+ import {
5634
+ ScrollArea,
5635
+ ScrollBar,
5636
+ } from "@vercel/geistdocs/components/scroll-area";
5637
+
5638
+ <div className="not-prose my-6 flex min-h-48 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5639
+ <ScrollArea className="h-32 w-full max-w-sm rounded-md border border-gray-400 p-4">
5640
+ <div className="space-y-3">
5641
+ <p>Overview</p>
5642
+ <p>Installation</p>
5643
+ <p>Configuration</p>
5644
+ <p>Deployment</p>
5645
+ <p>Troubleshooting</p>
5646
+ <p>Reference</p>
5647
+ </div>
5648
+ <ScrollBar />
5649
+ </ScrollArea>
5650
+ </div>
5651
+
5652
+ ```tsx
5653
+ import {
5654
+ ScrollArea,
5655
+ ScrollBar,
5656
+ } from "@vercel/geistdocs/components/scroll-area";
5657
+ ```
5658
+
5659
+ Keep keyboard and native scrolling available; use the component to style overflow rather than to replace browser scrolling behavior.
5660
+
5661
+
4908
5662
  ---
4909
5663
 
4910
5664
  ---
@@ -5103,6 +5857,257 @@ On mobile, Geistdocs replaces the sidebar outline with a compact menu in the pag
5103
5857
  Keep headings short and descriptive so the outline reads like a summary of the page. Name each heading after the goal of its section, and avoid stacking two headings with no content between them.
5104
5858
 
5105
5859
 
5860
+ ---
5861
+
5862
+ ---
5863
+ title: Tabs
5864
+ description: Render provider-backed tab navigation and content panels
5865
+ type: reference
5866
+ summary: Use Tabs for navigation-only controls or TabsWithChildren and TabContent for mounted content panels.
5867
+ url: /docs/components/tabs
5868
+ source: apps/template/content/docs/components/tabs.mdx
5869
+ related:
5870
+ - /docs/components
5871
+ - /docs/syntax
5872
+ ---
5873
+
5874
+ # Tabs
5875
+
5876
+ import {
5877
+ TabContent,
5878
+ TabsWithChildren,
5879
+ } from "@vercel/geistdocs/components/tabs-with-children";
5880
+
5881
+ <TabsWithChildren ariaLabel="Setup method" tabs={["Dashboard", "CLI"]}>
5882
+ <TabContent className="mt-4 text-copy-14" order={1}>
5883
+ Configure the project in the dashboard.
5884
+ </TabContent>
5885
+ <TabContent className="mt-4 text-copy-14" order={2}>
5886
+ Run the setup command in your terminal.
5887
+ </TabContent>
5888
+ </TabsWithChildren>
5889
+
5890
+ ```tsx
5891
+ import {
5892
+ TabContent,
5893
+ TabsWithChildren,
5894
+ } from "@vercel/geistdocs/components/tabs-with-children";
5895
+
5896
+ <TabsWithChildren ariaLabel="Setup method" tabs={["Dashboard", "CLI"]}>
5897
+ <TabContent className="mt-4 text-copy-14" order={1}>
5898
+ Configure the project in the dashboard.
5899
+ </TabContent>
5900
+ <TabContent className="mt-4 text-copy-14" order={2}>
5901
+ Run the setup command in your terminal.
5902
+ </TabContent>
5903
+ </TabsWithChildren>;
5904
+ ```
5905
+
5906
+ `TabsWithChildren` associates labels with `TabContent` panels by order. Inactive content remains mounted so Markdown and search exports preserve every panel.
5907
+
5908
+ For a navigation-only tab list without panels, import the lower-level `Tabs` component from `@vercel/geistdocs/components/tabs`. Both forms are available in the default MDX component map.
5909
+
5910
+
5911
+ ---
5912
+
5913
+ ---
5914
+ title: Theme Switcher
5915
+ description: Select the system, light, or dark display theme
5916
+ type: reference
5917
+ summary: Use ThemeSwitcher in custom navigation, settings, and footer UI.
5918
+ url: /docs/components/theme-switcher
5919
+ source: apps/template/content/docs/components/theme-switcher.mdx
5920
+ related:
5921
+ - /docs/components
5922
+ ---
5923
+
5924
+ # Theme Switcher
5925
+
5926
+ import { ThemeSwitcher } from "@vercel/geistdocs/components/theme-switcher";
5927
+
5928
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5929
+ <ThemeSwitcher />
5930
+ </div>
5931
+
5932
+ ```tsx
5933
+ import { ThemeSwitcher } from "@vercel/geistdocs/components/theme-switcher";
5934
+
5935
+ export function DisplaySettings() {
5936
+ return <ThemeSwitcher />;
5937
+ }
5938
+ ```
5939
+
5940
+ Use the compact variant where space is limited:
5941
+
5942
+ ```tsx
5943
+ <ThemeSwitcher small />
5944
+ ```
5945
+
5946
+
5947
+ ---
5948
+
5949
+ ---
5950
+ title: Toast
5951
+ description: Show global status notifications
5952
+ type: reference
5953
+ summary: Trigger provider-backed success, warning, and error notifications.
5954
+ url: /docs/components/toast
5955
+ source: apps/template/content/docs/components/toast.mdx
5956
+ related:
5957
+ - /docs/components
5958
+ - /docs/provider
5959
+ ---
5960
+
5961
+ # Toast
5962
+
5963
+ import { ToastDemo } from "@/components/geistdocs/toast-demo";
5964
+
5965
+ Use the buttons to preview every status variant:
5966
+
5967
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
5968
+ <ToastDemo />
5969
+ </div>
5970
+
5971
+ ```tsx
5972
+ "use client";
5973
+
5974
+ import { useToasts } from "@vercel/geistdocs/components/toasts";
5975
+
5976
+ export function StatusButtons() {
5977
+ const toast = useToasts();
5978
+
5979
+ return (
5980
+ <div>
5981
+ <button onClick={() => toast.success({ text: "Changes saved" })}>
5982
+ Success
5983
+ </button>
5984
+ <button
5985
+ onClick={() => toast.warning({ text: "Review these changes" })}
5986
+ >
5987
+ Warning
5988
+ </button>
5989
+ <button onClick={() => toast.error({ text: "Something went wrong" })}>
5990
+ Error
5991
+ </button>
5992
+ </div>
5993
+ );
5994
+ }
5995
+ ```
5996
+
5997
+ `GeistdocsProvider` mounts the global toast area. Use `success`, `warning`, or `error` with a `{ text }` message from any client component below the provider.
5998
+
5999
+
6000
+ ---
6001
+
6002
+ ---
6003
+ title: Toggle
6004
+ description: Render controlled boolean controls
6005
+ type: reference
6006
+ summary: Toggle is the provider-backed replacement for the former Switch export.
6007
+ url: /docs/components/toggle
6008
+ source: apps/template/content/docs/components/toggle.mdx
6009
+ related:
6010
+ - /docs/components
6011
+ - /docs/components/input
6012
+ ---
6013
+
6014
+ # Toggle
6015
+
6016
+ import { ToggleDemo } from "@/components/geistdocs/toggle-demo";
6017
+
6018
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
6019
+ <ToggleDemo />
6020
+ </div>
6021
+
6022
+ ```tsx
6023
+ "use client";
6024
+
6025
+ import { Toggle } from "@vercel/geistdocs/components/toggle";
6026
+ import { useState } from "react";
6027
+
6028
+ export function Setting() {
6029
+ const [enabled, setEnabled] = useState(false);
6030
+ return (
6031
+ <Toggle checked={enabled} onChange={setEnabled}>
6032
+ Enable previews
6033
+ </Toggle>
6034
+ );
6035
+ }
6036
+ ```
6037
+
6038
+ Use `Toggle` and `onChange`; the v1 `Switch` and `onCheckedChange` names are not exported in Geistdocs v2.
6039
+
6040
+
6041
+ ---
6042
+
6043
+ ---
6044
+ title: Tooltip
6045
+ description: Add contextual labels on hover and focus
6046
+ type: reference
6047
+ summary: Wrap controls with provider-backed Tooltip content outside MDX.
6048
+ url: /docs/components/tooltip
6049
+ source: apps/template/content/docs/components/tooltip.mdx
6050
+ related:
6051
+ - /docs/components
6052
+ ---
6053
+
6054
+ # Tooltip
6055
+
6056
+ import { Tooltip } from "@vercel/geistdocs/components/tooltip";
6057
+
6058
+ <div className="not-prose my-6 flex min-h-32 items-center justify-center rounded-lg border border-gray-400 bg-background-100 p-6">
6059
+ <Tooltip position="top" text="Copy to clipboard">
6060
+ <button className="h-8 rounded-md border border-gray-400 bg-background-100 px-3" type="button">
6061
+ Hover or focus
6062
+ </button>
6063
+ </Tooltip>
6064
+ </div>
6065
+
6066
+ ```tsx
6067
+ import { Tooltip } from "@vercel/geistdocs/components/tooltip";
6068
+
6069
+ export function Help() {
6070
+ return (
6071
+ <Tooltip position="top" text="Copy to clipboard">
6072
+ <button type="button">Copy</button>
6073
+ </Tooltip>
6074
+ );
6075
+ }
6076
+ ```
6077
+
6078
+ Provide an accessible name on icon-only triggers independently of the tooltip text.
6079
+
6080
+
6081
+ ---
6082
+
6083
+ ---
6084
+ title: Video
6085
+ description: Render responsive video playback in documentation content
6086
+ type: reference
6087
+ summary: Use Video for embedded video sources inside React UI or authored MDX.
6088
+ url: /docs/components/video
6089
+ source: apps/template/content/docs/components/video.mdx
6090
+ related:
6091
+ - /docs/components
6092
+ ---
6093
+
6094
+ # Video
6095
+
6096
+ import { Video } from "@vercel/geistdocs/components/video";
6097
+
6098
+ <Video src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4" />
6099
+
6100
+ ```tsx
6101
+ import { Video } from "@vercel/geistdocs/components/video";
6102
+
6103
+ export function Demo() {
6104
+ return <Video src="https://example.com/demo.mp4" />;
6105
+ }
6106
+ ```
6107
+
6108
+ `Video` is also included in the default MDX component map.
6109
+
6110
+
5106
6111
  ---
5107
6112
 
5108
6113
  ---