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.
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.

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
⌥(Alton 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.

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:
| Item | Shortcut |
|---|---|
| Zoom in | ⌘+ |
| Zoom out | ⌘− |
| Zoom to fit | ⇧1 |
| Zoom to 50% | |
| Zoom to 100% | ⇧0 |
| Zoom to 200% |

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.

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.
| Key | Tab | What it holds |
|---|---|---|
1 | Style | On 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. |
2 | Agent | The design agent. The conversation stays open as you move between pages. |
3 | Utilities | Every Tailwind class of the current component, rule by rule and grouped by state. You can edit, add and remove classes here directly. |
4 | Lint | The 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.
| Shortcut | Action |
|---|---|
⌘Z | Undo |
⇧⌘Z | Redo |
⌘K | Command menu |
D | Switch between light and dark |
C | Comment mode on or off |
Esc | Leave comment mode |
? or ⌘/ | Keyboard shortcuts |
1 to 4 | Style, Agent, Utilities and Lint tabs |
⌘-click | Select a part on the canvas |
⌥ while pointing | Measure distances from the selected part |
⌘+ and ⌘− | Zoom in and out |
⇧1 | Zoom to fit |
⇧0 or ⌘0 | Zoom to 100% |
On Windows, use Ctrl in place of ⌘ and Alt in place of ⌥. The in-app list does not show the ⌥ row yet.