# Docs Site Shell

Frame shared by every page of a developer documentation site: header with search, version switcher and theme, footer.

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

## Install

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

## Metadata

- **Level:** layout
- **Category:** layout
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** sticky-header, active-section-link, mobile-menu-sheet, command-palette-search, version-switcher, theme-switch, dismissible-announcement, skip-link, footer-link-columns
- **Intents:** navigate, communicate
- **Suits domains:** devtools, knowledge, saas
- **Interaction:** click, dialog, keyboard-shortcut, select
- **Screen role:** overview
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** frame shared by every page of a developer documentation site: header with search, version switcher and theme, footer, docs site shell with command palette search opened by Ctrl K
- **Avoid when:** authenticated app screens (use an app shell with a sidebar)
- **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, sheet
- **npm dependencies:** next, lucide-react, next-themes, cmdk
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** Documentation Site (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0, next-themes@0.4.6
- **Registry dependencies:** lib-primitives, marketing-announcement-bar, marketing-footer, search-global-palette