App shell
The frame of an app. A sidebar with the workspaces and the person signed in, a header with the breadcrumb, search and notifications, and the page with its title and actions. The page sits as a card, on one plane, or under a bar across the top.
Preview
The page is a card on the sidebar’s tint, its header inside it. The toggle collapses the sidebar to its icons, and on a phone the sidebar is a sheet. In your app, ⌘B and ⌘K do the same as the toggle and the search.
Examples
Flat
The sidebar and the page share one plane, split by a line, for an app whose pages are dense tables and lists.
Top bar
A bar across the top holds the workspaces, the search, the notifications and the person, and the sidebar under it holds only the pages.
Installation
npx shadcn@latest add https://kinoui.com/r/app-shell.json- Files
lib/reduce-motion.tslib/scroll.tslib/refs.tslib/resize.tslib/swap.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/cut.tsxlib/run-progress.tslib/highlight.tslib/flow.tslib/roll.tsxcomponents/kino/avatar.tsxcomponents/kino/separator.tsxlib/menu.tsxcomponents/kino/dropdown-menu.tsxcomponents/kino/breadcrumb.tsxcomponents/kino/spinner.tsxcomponents/kino/button.tsxcomponents/kino/input.tsxcomponents/kino/select.tsxlib/filter-list.tsxlib/panel.tsxcomponents/kino/dialog.tsxcomponents/kino/command.tsxlib/keys.tsxcomponents/kino/kbd.tsxlib/number-format.tscomponents/kino/animated-number.tsxcomponents/kino/badge.tsxcomponents/kino/empty.tsxlib/pill.tscomponents/kino/tabs.tsxlib/announce.tsxlib/controllable.tslib/dates.tslib/grip.tscomponents/kino/sheet.tsxcomponents/kino/drawer.tsxcomponents/kino/popover.tsxlib/roomy.tslib/popover-sheet.tsxlib/settle.tscomponents/kino/notification-center/notification-center.tsxcomponents/kino/notification-center/notification-parts.tsxcomponents/kino/notification-center/notification-bell.tsxcomponents/kino/notification-center/notification-list.tscomponents/kino/collapsible.tsxcomponents/kino/scroll-area.tsxcomponents/kino/sidebar.tsxlib/placeholder.tscomponents/kino/skeleton.tsxlib/menu-sheet.tsxcomponents/kino/preferences.tsxcomponents/kino/segmented-control.tsxcomponents/kino/theme-switcher.tsxcomponents/kino/user-menu.tsxcomponents/kino/app-shell/app-shell.tsx- Packages
@base-ui/reactclass-variance-authority
New to Kino? Installation covers what your project needs first and the @kino namespace.
API reference
AppShell
AppShellHeader
AppShellSearch
AppShellWorkspaces
AppShellUser
AppShellPageHeader
Accessibility
- A skip link is the first tab stop: it shows when focused and takes focus past the header and the sidebar to the page.
- The header is the page’s banner, the sidebar a navigation landmark named by its
aria-label, and the page itsmain. Each row marks the current page witharia-current. - The toggle says what it does, “Collapse sidebar” or “Open sidebar”, with
aria-expanded, and names its shortcut. In the rail each row is named by its tooltip. - The search button’s keys are read as
aria-keyshortcuts, not as its name. ⌘K is left alone while another dialog covers the page. - The header stays put as the page scrolls, and what takes focus stops below it. On a phone the sidebar is a sheet that holds focus, and a link inside closes it.