# Docs Site Versions

Api versions page with a version switcher and migration notes between major versions.

- id: `docs-site-versions`
- Page: https://agentic-ui-kit.com/components/docs-site-versions
- Live preview: https://agentic-ui-kit.com/docs-site/docs/versions?piece=docs-site-versions

## Install

```bash
agentic-ui add docs-site-versions
npx shadcn@4.17.0 add @agentic-ui/docs-site-versions
```

## Metadata

- **Level:** page
- **Category:** page
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** version-cards, support-status, docs-version-switch, migration-notes, before-after-code, upgrade-checklist, empty-state
- **Intents:** configure, explore-detail
- **Suits domains:** devtools, knowledge, saas
- **Interaction:** select, click, checkbox
- **Screen role:** detail
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** api versions page with a version switcher and migration notes between major versions, migration guide page with breaking changes before and after code and an upgrade checklist
- **Avoid when:** in-app plan upgrades
- **Preserve when adapting:** single-h1-per-page, section-order, link-integrity
- **Replace when adapting:** brand-copy, content-data, links
- **Adaptation effort:** low
- **Coupling:** medium
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, tabs
- **npm dependencies:** next, lucide-react, next-themes
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** Documentation Site (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives, util-copy-block