# Shadcn Workspace Switcher

> Application shell with a workspace switcher

- Type: example, free and open source (MIT)
- Component: [Sidebar](https://web.dev.reui.io/components/sidebar.md)
- Page: https://web.dev.reui.io/components/sidebar/c-sidebar-1
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/sidebar.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/sidebar.md
- MCP: `get_example("c-sidebar-1")`
- Registry item: https://web.dev.reui.io/r/styles/base-nova/c-sidebar-1.json
- Uses: Avatar, Breadcrumb, Button, Card, Dropdown Menu, Sidebar

## Best for

An inset variant layout whose header dropdown switches the workspace named in the page breadcrumb, beside stat cards and a deploy list

## Agent notes

- Replace `WORKSPACES`, `NAV`, `PROJECTS`, `DEPLOYMENTS` and `STATS` with your data; the active Deployments row is hard coded through `isActive`
- New workspace, the New project `SidebarGroupAction` and every project row and account `DropdownMenuItem` have no handler yet

## When not to use

- A nav that narrows to a column of icons with hover names when collapsed: use [Icon Rail](https://web.dev.reui.io/components/sidebar/c-sidebar-2.md) (`get_example("c-sidebar-2")`)

## Install

```bash
npx shadcn@latest add @reui/c-sidebar-1
```

## About Shadcn Sidebar

### When to use

- The persistent navigation column of an app, which can narrow to an icon rail or slide off screen
- Documentation trees with collapsible sections and sub-pages, or project lists narrowed by a search field
- A right side inspector that shows the details of the record open beside it

### When not to use

- A complete multi page product layout with header, nav and content area already built: use the [App Shell blocks](https://web.dev.reui.io/blocks/application/app-shell.md)
- Account settings pages that switch between personal details, billing and team panels: use the [Profile blocks](https://web.dev.reui.io/blocks/application/profile.md)
- A shop catalog facet panel with price range, brand counts, color swatches and sizes: use the [Filter Sidebar blocks](https://web.dev.reui.io/blocks/ecommerce/filter-sidebar.md)

### Agent notes

- Menu links are anchors passed through `render` on the base twin and `asChild` on radix; point each # `href` at your route
- `SidebarProvider` listens for Cmd or Ctrl+B on the whole window, so pressing it in a text editor on the page toggles its `open` state too

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.