Theming
Notchset components read your shadcn tokens, so they look right in any shadcn app with nothing extra installed. Keep your palette, point the signal at your brand colour, or install the Notchset theme for the full paper-and-ink look. Brand names, logos and sample text are props, so nothing of ours ends up in your product.
Your palette
Out of the box, surfaces, text and rules come from your --background, --foreground, --border, --muted and the rest. Notchset's own --notchset-* tokens refine them where the theme is installed; without it, each one falls back to the shadcn token it stands in for.
- The signal colour (live nodes, the run accent, destructive actions):
--notchset-signal. Without it, Notchset uses your--destructive. Set--notchset-signal-textfor the signal as text on your background, and--notchset-on-signalfor text on a signal fill. - Rules and edges:
--notchset-rule(falls back to--border) and--notchset-control-edge. - One part of a page: set the tokens on its container. They are plain custom properties, so everything inside follows and nothing outside changes.
/* Your brand as the signal, light and dark. */
:root {
--notchset-signal: #0e9f8e;
--notchset-signal-text: #0b7a6d;
--notchset-on-signal: #ffffff;
}
.dark {
--notchset-signal: #2dd4bf;
--notchset-signal-text: #5eead4;
--notchset-on-signal: #0b0c10;
}
/* Only one area: */
.billing { --notchset-signal: #db3f74; }Keep overrides in your own CSS. Each add (and every --overwrite update) writes the registry's CSS into your global stylesheet again, so edits inside the installed Notchset rules are lost. Put your overrides in rules of your own, after them or in a separate file.
Dark and light
Notchset is designed in both, with its own dark values rather than inverted colours. It follows a .dark class on an ancestor (the shadcn and next-themes convention). Set that class before the first paint (next-themes does) and there is no flash on load. The Notchset theme also sets its dark tokens under [data-theme="dark"], but Tailwind's dark: variant, as shadcn sets it up, follows .dark only, so set the class as well.
The Notchset theme (optional)
The theme is global. It replaces your app's shadcn tokens (--background, --primary, --border and the rest, in light and dark) with Notchset's paper, ink and one signal colour, adds the --notchset-* motif tokens, and adds Archivo and Martian Mono. Every shadcn component in the app changes, not just Notchset ones. Skip it to keep your palette. Commit first so you can review the diff.
npx shadcn@latest add https://beautiful-ui.dev/r/notchset.jsonNext: Motion, to switch animation off.