Interface tour

A tour of the DS Manager editor for your shadcn/ui design system: left navigation, live canvas with zoom and measuring, the Style, Agent, Utilities and Lint tabs, comments, and shortcuts.

Last updated 16 Nov 2026DS Manager

The DS Manager editor has four areas: the navigation on the left, the canvas in the middle, the right rail with its tabs, and the top bar. Both side rails can be resized by dragging their edge.

The DS Manager editor on the Button page with numbered callouts: 1 the left navigation, 2 the canvas with the zoom menu and the Canvas color swatch in its header, 3 the right rail tabs Style, Agent, Utilities and Lint, 4 the top bar with the system switcher, Comments, Share and Get code

1. Left navigation

The Search field at the top filters the list by page or component name. It also matches the export names a component carries, so typing AccordionTrigger finds the Accordion page.

Below it, the list has four parts:

  • Foundation pages: Overview, Style, Color, Typography, Radius, Shadow, Spacing, Controls, Icons and Brand. Two pages sit under Brand: Pro Blocks, which holds the classes every block shares, and Lint, the policy page for Lint locks.
  • Custom components: the components you added with the agent, with your groups as folders and an Archived folder at the bottom. On Pro, the + button next to the heading (Add new component) opens the agent to start one. See Custom components.
  • Default Components: All components (a table of every component and whether you edited it), then one page for each of the 62 kit components: the 60 shadcn/ui components plus Trace and Code Block.
  • Pro Blocks: four folders, Landing page, Application, E-commerce and AI, with one page per block category. See Pro Blocks.

The groups fold. Click a heading to collapse it, and the search field opens a folded group when it finds a match there.

A page with open comments shows a small comment icon and the number of open threads next to its name.

When an import is waiting for you, a Pending reviews group sits above the list, with one row per review and the number of changes it holds. See Start from your globals.css.

Component Layers is pinned to the bottom of the rail. On a component page it shows the component's parts as a tree, with the icons inside each part under it, and a dot marks the parts you edited. Click a row to select that part. When you select a part another way, by ⌘-clicking it on the canvas or picking it in the Lint tab, the panel opens its folded groups and scrolls so the row is in view. Drag the line above the panel to make it taller or shorter.

2. Canvas

The canvas renders your system live with real shadcn/ui components. Every edit shows there as you make it.

The canvas has no Select or Interact mode to switch between:

  • A plain click uses the component, so you can open a menu or type in an input.
  • ⌘-click (Ctrl-click on Windows) selects the part under the pointer. The part lights up in Component Layers, and the right rail shows its styles.
  • With a part selected, hold ⌥ (Alt on Windows) and point at another part to see the distances between them in px. Hold it over the selected part to see its padding and the gaps between its children.

Selection works on pages that show editable components: component pages, custom components and Pro Blocks.

A component page has two views at the top right of the canvas:

  • Demo shows the component in a designed composition, as shadcn/ui's create flow shows it.
  • Matrix shows every value of every variant axis side by side.

A few components have no composition. For those, Demo is turned off and the matrix shows instead.

Pro Blocks pages replace that switch with a preview size control: Desktop (1280px), Tablet (768px) and Mobile (390px). Desktop is the base. A style you set at Tablet or Mobile overrides the Desktop value at that size; see Breakpoints.

Measure with Option

On the pages where selection works, select a part, then hold ⌥ (Alt on Windows) and point at another part. Red lines show the distances in px:

  • Next to a neighbor, the gap between them.
  • Over the parent, the four distances to its edges. Over a child, its insets.
  • Over empty canvas, the distances to the demo frame, such as the example panel, the matrix cell or the block.
  • Over the selected part itself, its padding and the gaps between its children, hatched.

A badge under the selection shows its width and height. The values are in design pixels at any zoom. ⌥ works even while focus is in the right rail. With nothing selected, it does nothing.

The Action button selected on a Card in DS Manager, with a red line showing 24px to the paragraph above

Zoom and pan

Every canvas page zooms from 25% to 400%, the way a frame does in Figma. Zoom doesn't change the page's width or its breakpoint.

  • Pinch, or hold ⌘ and scroll, to zoom toward the pointer.
  • Scroll, drag with Space held down, or drag with the middle mouse button to pan.

The percentage button at the right of the page header opens the Zoom menu:

ItemShortcut
Zoom in⌘+
Zoom out⌘−
Zoom to fit⇧1
Zoom to 50%
Zoom to 100%⇧0
Zoom to 200%
The Zoom menu open under the zoom level button in the page header, with Zoom in, Zoom out, Zoom to fit, Zoom to 50%, Zoom to 100% and Zoom to 200% and their shortcuts

Zoom in and Zoom out move through 25, 50, 75, 100, 150, 200, 300 and 400%. A new tab opens at 100%, or fitted on Pro Blocks pages, and each tab remembers the zoom you pick.

Canvas color

The swatch just left of the zoom button, Canvas color, sets the background the canvas is drawn on. Pick a color for the mode on screen: the picker reads Light canvas or Dark canvas, and each mode keeps its own color. The color saves with the system, and the reset dot next to the picker's title goes back to the default.

The Light canvas picker open from the Canvas color swatch next to the zoom button, with a light blue picked, and the canvas behind it drawn in that blue

Text drawn straight on the canvas, such as section titles, turns light on a dark canvas color. The panels, the sidebars and the top bar keep their colors, and the canvas color is not part of what you publish or install.

3. Right rail

The right rail has four tabs. Press 1 to 4 to switch between them, as long as you are not typing in a field. The keys also work while focus is inside the canvas.

In comment mode, the Comments panel takes the place of the tabs until you leave it. See Comments.

KeyTabWhat it holds
1StyleOn a foundation page, that page's controls (for example the color tokens on Color). On a component page, the styles of the selected part, in Layout, Typography, Appearance, Effects and Transform sections, or one Icon section when you pick an icon. Select, Popover, Dropdown Menu, Tooltip, Combobox, Dialog and Sheet also have a Behaviour section.
2AgentThe design agent. The conversation stays open as you move between pages.
3UtilitiesEvery Tailwind class of the current component, rule by rule and grouped by state. You can edit, add and remove classes here directly.
4LintThe lint locks for the selected part of the current component. Lock a property so agents can't change it.

Utilities and Lint are per component, so they have content on component pages. Utilities also covers custom components and Pro Blocks. Lint covers the built-in components only. Editing components explains the Style and Utilities tabs in detail.

4. Top bar

The middle of the bar acts on the open system:

  • System switcher: shows the open system's name. Open it to switch systems or to choose New system…, Import preset…, Duplicate system or Manage systems…. With teams, Manage systems… opens the Systems dialog, where you can also move a system between Personal and a team. A system you can't edit shows View only next to its name. See Teams.
  • Undo and Redo: every edit, including the agent's, is one step in the history.

The right side holds:

  • A save note. It reads Saving… or Unsaved while a change is on its way, and nothing once it is stored. Unsaved also shows while a system you switched away from still has edits on their way. If a save fails, Not saved appears next to the system's name, with the reason on hover, and DS Manager keeps sending the edit until it lands.
  • Comments: turn comment mode on or off, also with C. A blue dot on it means a thread has comments you haven't read. See Comments.
  • Share: create a link to the system that others can view, comment on and, if you allow it, fork. See Share links and forks.
  • Get code: publish the system and copy the install command. See Publish and install.
  • The account menu: the Workspace row, Search…, the light or dark theme switch, Settings…, Help, Changelog and Sign out. The Workspace row at the top names the workspace you are in, Personal or a team with your role, and opens the Workspaces dialog to switch. Changelog opens the DS Manager updates on the shadcndesign.com blog. Signed out, the menu offers to log in with GitHub or Google in place of Sign out.

Light and dark preview

DS Manager has one light/dark switch for the editor and the canvas together. Press D, or use Switch to dark theme in the account menu. On the Color page, the Light and Dark control under Editing moves the same switch, and your color edits land in the palette that is showing.

Command menu

Press ⌘K (Ctrl+K on Windows) to open the command menu. It lists every page, every component and the actions of the page you are on. Type to filter, then press Enter.

Keyboard shortcuts

Press ? or ⌘/ to see the list inside the app. All of these also work while focus is in the canvas.

ShortcutAction
⌘ZUndo
⇧⌘ZRedo
⌘KCommand menu
DSwitch between light and dark
CComment mode on or off
EscLeave comment mode
? or ⌘/Keyboard shortcuts
1 to 4Style, Agent, Utilities and Lint tabs
⌘-clickSelect a part on the canvas
⌥ while pointingMeasure distances from the selected part
⌘+ and ⌘−Zoom in and out
⇧1Zoom to fit
⇧0 or ⌘0Zoom to 100%

On Windows, use Ctrl in place of ⌘ and Alt in place of ⌥. The in-app list does not show the ⌥ row yet.