Skip to content
Design System
GitHub

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.

Install
npx shadcn add @syncrobotic/app-shell

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.

Install
npx shadcn add @syncrobotic/top-bar-shell

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.

Install
npx shadcn add @syncrobotic/action-rail-shell

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.

Install
npx shadcn add @syncrobotic/app-shell-mobile-tabs

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.