App shell
The frame of a tool: navigation, top bar, search and the user, around whatever page you put in it.
Overview
When to use
- Internal tools and consoles with more than a handful of pages.
- A site or tool that only needs a top bar.
- A page that leads to one next step, such as a batch to review or a model to train: the action rail.
Use something else
- A single screen with no navigation: start from a Solutions block.
Blocks
App shell
The frame of an internal tool: collapsible sidebar (a drawer on phones), top bar with title, environment, search and user, and the page.
npx shadcn add @syncrobotic/app-shell 1280px
Top-bar shell
The frame for a tool or site without a sidebar: links, search and user in a top bar that starts on the content's edge and gathers into a floating panel as wide as the content column on scroll, then the content and a footer.
npx shadcn add @syncrobotic/top-bar-shell 1280px
Action-rail shell
A page whose right column holds only the next step: its title, what it does, one large primary button and a few small actions. A bar fixed to the bottom on phones; ← or Esc goes back up a level.
npx shadcn add @syncrobotic/action-rail-shell 1280px
Phone shell with tabs
A phone frame: the page title on top and up to four sections as tabs in a floating dock, in thumb reach.
npx shadcn add @syncrobotic/app-shell-mobile-tabs 390px
Usage rules
- One shell per product. Pages change inside it; the shell does not.
- The current page is marked in the navigation and named in the top bar.
- On phones the sidebar becomes a drawer; nothing is hidden for good. The drawer floats 8 px from the edges, the shell's gutter.
- A top bar over plain content starts on the content's edge and, on scroll, gathers into a floating panel as wide as the content column.
- The action rail holds only the next step: one large primary button and a few small actions, never filters or facts. On phones it is a bar fixed above the safe area, and the page is padded so it never covers content.
- ← and Esc go back up a level wherever there is a back button, except while typing or when an overlay is open.