Components Overview

Overview of available components in the documentation layer

Components Overview

The layer provides several pre-built components for documentation sites, organized into three categories: Layout, Content/MDC, and UI components.

Layout Components

AppHeader

The site header with navigation and dark mode toggle.

<AppHeader />

Features:

  • Site title/logo
  • Navigation links
  • Dark/light mode toggle
  • Mobile responsive

AppFooter

The site footer.

<AppFooter />

DocsSidebar

Navigation sidebar for documentation pages.

<DocsSidebar />

Features:

  • Hierarchical navigation
  • Active state highlighting
  • Collapsible sections

DocsTableOfContents

Table of contents for the current page.

<DocsTableOfContents :toc="toc" />

Features:

  • Auto-generated from headings
  • Scroll-aware active state
  • Depth-based indentation

DocsPageHeader

Page header with title and description.

<DocsPageHeader
  title="Page Title"
  description="Page description"
/>

DocsPageNav

Previous/Next navigation.

<DocsPageNav
  :prev="{ path: '/prev', title: 'Previous' }"
  :next="{ path: '/next', title: 'Next' }"
/>

Content Components (MDC)

These components are globally registered and can be used directly in Markdown files using MDC syntax.

ComponentDescription
CalloutAlert and notification boxes
StepsStep-by-step guides
TabsTabbed content sections
CodeTabsPackage manager code switcher
ComponentPreviewComponent demo previews
LinkedCardCard-style navigation links
CodeCollapsibleWrapperCollapsible code blocks
CopyButtonCopy to clipboard button
ButtonAButton-styled links
ProseMarkdown element styling

UI Components

The layer includes shadcn-vue components:

Button

<Button variant="default">
Click me
</Button>

<Button variant="outline">
Outline
</Button>

<Button variant="ghost">
Ghost
</Button>

Separator

<Separator />

<Separator orientation="vertical" />

Customization

All components can be overridden by creating a component with the same name in your project's components directory.