# Route Search Sidebar block

> Searchable route sidebar shell with a 48px icon rail fold and a Security, Assets, Events scope tree

Robot fleet security console with no top bar: Cmd+F focuses route search, grip-handle sub-scope reordering, Add buttons that append draft rows, count and status badges. ReUI Sortable, Badge; shadcn Sidebar, Tabs, Sheet. SOC, IoT admin console.

- Type: Pro block
- Category: [App Shell](https://web.dev.reui.io/blocks/application/app-shell.md)
- Page: https://web.dev.reui.io/blocks/application/app-shell/app-shell-27
- 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_block("app-shell-27")`
- Built with: Avatar, Badge, Button, Card, Collapsible, Dropdown Menu, Empty, Icon Tile, Input Group, Kbd, Sheet, Sidebar, Skeleton, Sortable, Tabs, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A layout with no top bar, whose sidebar filters routes as you type and folds to a 48px rail, beside a docked scope panel with Add buttons

## Agent notes

- Replace the `NAV_GROUPS` routes and the `SCOPES` trees in data.tsx with your own fleet routes and inventory
- `onAdd` appends a draft row and bumps its count in local state only, so wire it to your create flow
- The Upgrade button in `SidebarPromo` has no click handler, so point it at your billing route

## When not to use

- A console that needs a top bar with section pills, alerts and a scan action: use [Security Scope Console](https://web.dev.reui.io/blocks/application/app-shell/app-shell-26.md) (`get_block("app-shell-26")`)
- A drag to reorder navigation menu alone, with no routes, search or scope tabs: use [Sortable](https://web.dev.reui.io/components/sortable.md) (`get_component("sortable")`)

## Third-party libraries

- Headless Tree v1: [API reference](https://headless-tree.lukasbach.com/api/core/), [docs](https://headless-tree.lukasbach.com/getstarted/)
- next-themes: [API reference](https://github.com/pacocoursey/next-themes#api), [docs](https://github.com/pacocoursey/next-themes)
- dnd kit v6: [API reference](https://dndkit.com/legacy/api-documentation/context-provider/dnd-context/), [docs](https://dndkit.com/legacy/introduction/getting-started/), through ReUI Sortable (these are the Legacy docs; dndkit.com's default docs cover the newer @dnd-kit/react, a different API)

## Install

```bash
npx shadcn@latest add @reui/app-shell-27
```

## About App Shell blocks

### When to use

- The outer layout of a multi page product: the navigation around its content area
- Dashboards and admin consoles that switch between workspaces or projects

### When not to use

- One overview page of stats, charts and tables inside your own layout: use the [Dashboard blocks](https://web.dev.reui.io/blocks/application/dashboard.md)
- A top bar on its own, above a page layout you already have: use the [Navbar blocks](https://web.dev.reui.io/blocks/application/navbar.md)

### Agent notes

- Shells that switch themes call `useTheme` from next-themes, so the app must mount the next-themes ThemeProvider

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.