Quickstart
Create a shadcn design system in DS Manager, change a color and a font, publish it as a registry and install it in your project with one command.
This guide takes you from an empty browser tab to your own shadcn/ui design system installed in a project. It takes five steps. You need a GitHub or Google account for the publish step and a Next.js project with Tailwind v4 for the install.
1. Open the app
Go to manager.shadcndesign.com in a desktop browser. On your first visit the app opens the Create your first design system dialog. You don't need an account yet.
2. Create a system

The dialog has two tabs. Pick one:
- New starts from a shadcn/ui style. Type a Name, pick a Base style (one of the eight shadcn/ui styles, Nova by default) and a Base color (Neutral, Stone, Zinc, Mauve, Olive, Mist or Taupe).
- Preset starts from a preset code made on ui.shadcn.com/create. Paste the code into Preset code. When the code is valid, a line under the field lists what it sets: style, base color, accent, font, radius and icon library.
Click Create system. The Overview page opens with your system on the canvas. Everything you picked here stays editable later.
To make more systems later, open the system switcher in the top bar and choose New system… or Import preset…. Once you're signed in, the dialog has a third tab, CSS, which builds a system from your project's globals.css. See Start from your globals.css below.
3. Change a color and a font
Start with the brand color:
- Open Color in the left navigation.
- Under Editing in the right rail, pick Light or Dark. Your color edits land in that palette.
- In the Primary, secondary, muted, accent section, click the swatch next to
primaryand choose a new color.
The components that use primary update on the canvas while you pick. Switch Editing to the other palette to set its value as well. Colors and tokens covers the full picker.
Then change a font:
- Open Typography in the left navigation.
- Under Fonts, click the Heading dropdown.
- Search for a Google font and click it.
The headings on the canvas switch to the new font right away. You can also upload a font file or add one from a URL; see Typography.
Made a change you don't like? Press ⌘Z (Ctrl+Z on Windows) to undo it.
4. Publish
- Click Get code at the top right and open the Publish tab.
- If you are signed out, log in with GitHub or Google. If you created systems before signing in, DS Manager offers to bring them into your account. Import the one you just made.
- Click Publish.
DS Manager compiles your system and serves it as a shadcn/ui registry under your account. The Free plan includes one published registry.
5. Install it in your project

Open the Install tab of the same dialog. Pick your package manager (pnpm, npm, yarn or bun) and copy the command. With pnpm it looks like this:
pnpm dlx shadcn@latest init --preset https://manager.shadcndesign.com/u/<your-id>/r/<system>/<system>.json --force --no-reinstall
Copy the real command from the dialog, since the link contains your account id and the system's name. Run it in the root of your project. The command sets up components.json, writes your tokens into globals.css and installs every component with your edits.
The same command works in a project that already uses shadcn/ui. There it replaces the shadcn/ui components already in the project with your versions and leaves your own files alone.
In an existing project, commit your work before you run the command. It overwrites components.json and the shadcn/ui component files, and it writes your tokens into globals.css.
After the next round of edits, click Publish again in the Publish tab and run the same command to update the project. Publish and install covers unpublishing, installing single Pro Blocks and the other tabs of the dialog.
Start from your globals.css
If your project already has a shadcn/ui theme, you can turn it into a system instead of starting from a style. You need to be signed in.
- Open the system switcher in the top bar and choose New system….
- Pick the CSS tab.
- Type a Name and paste your project's
globals.cssinto the globals.css box. - Click Review import.
DS Manager reads the theme from the file, such as the color tokens in light and dark, the radius and the fonts. It only reads the file: it runs nothing and fetches no URL the file names. Nothing is created yet. A review page opens first.

The review page shows:
- A Summary of how many changes the import makes and how long the review waits (30 days).
- A Preview of the system with the imported values. Switch between Before and After, and between Light and Dark.
- Every value grouped by section, such as Colors and Radius, each marked New, Changed or Unchanged. Every change starts ticked. Untick a row to leave that value out.
- Not carried over, when the file has values the import can't use, with the reason for each.
Click Apply to create the system. The button names the count, for example Apply 59 changes. Discard drops the import and creates nothing.
A review you haven't applied or discarded waits in Pending reviews at the top of the left nav, so you can come back to it later. The new system counts toward the systems your plan holds, three on Free. See Plans and limits.