shadcn Theme Editor
Live theme editor for shadcn CSS variables (OKLCH) in Storybook – tweak light & dark colours, radius and fonts, import from and export to app.css.
storybook-addon-shadcn-theme-editor
A live theme editor for shadcn themes, right inside Storybook.
Tweak the colours, radius and fonts of your real components in light and dark mode,
then copy the result back into your app.css.

- Reads your theme automatically: every
--variablein your:root { }and.dark { }blocks. - Light and Dark editing, each with its own values.
- OKLCH-native: colour picker plus lightness, chroma, hue and alpha sliders.
- Import a theme from shadcn studio, tweakcn or any
:root/.darkCSS. - Export the finished theme as CSS, ready to paste into
app.css. - Non-destructive: changes live in your browser only, until you export them.
- Framework-agnostic: works with shadcn-svelte, shadcn/ui (React), shadcn-vue, or any CSS-variable theme.
Requirements
- Storybook 10
- A theme defined as CSS custom properties in
:rootand.dark(the default for shadcn with Tailwind CSS v4)
Install
npm install --save-dev storybook-addon-shadcn-theme-editor
Add it to .storybook/main.ts:
const config: StorybookConfig = {
addons: [
// …your other addons
'storybook-addon-shadcn-theme-editor',
],
};
Make sure your global CSS is imported in .storybook/preview.ts (you probably do this already):
import '../src/app.css';
Restart Storybook and open the Theme tab in the addon panel.
CSF Next (definePreview)
import { definePreview } from '@storybook/svelte-vite';
import shadcnThemeEditor from 'storybook-addon-shadcn-theme-editor';
export default definePreview({
addons: [shadcnThemeEditor()],
});
Light / dark switching
The Light / Dark tabs pick which set of values you are editing. To see dark mode in the
preview, toggle the .dark class, for example with
@storybook/addon-themes:
import { withThemeByClassName } from '@storybook/addon-themes';
export const decorators = [
withThemeByClassName({
themes: { light: '', dark: 'dark' },
defaultTheme: 'light',
}),
];
Usage
| Action | How |
|---|---|
| Change a colour | Click the swatch, or type any CSS colour into the field |
| Fine-tune in OKLCH | Click LCH for lightness, chroma, hue and alpha sliders |
| Change the radius | Use the slider next to --radius |
| Find a variable | Type in Filter variables… |
| Try a generated theme | Import CSS → paste the :root / .dark blocks → Apply |
| Save your work | Export CSS → Copy to clipboard → replace the blocks in app.css |
| Undo | ↺ next to a variable, or Reset all |
Changed variables are shown in bold with a dot. Edits are saved in localStorage, so they
survive reloads and apply to every story until you reset them.
How it works
The addon reads the custom properties declared in your :root and .dark rules (including rules
inside @layer and @media). Your edits are written to a <style> tag in the preview iframe with
slightly higher specificity, so they win over your stylesheet without touching it. When you change a
light value, the matching dark value is written too, so dark mode keeps working as before.
Limitations
- Only
:rootand.darkselectors are detected. Themes that use other selectors (for example[data-theme="dark"]) are not picked up yet. - Font variables (
--font-sans, …) only take effect if your@theme inlineblock maps them and the font is loaded on the page. - The colour picker works in sRGB. Colours outside sRGB are clipped in the picker, but you can still type or slide to any OKLCH value.
Contributing
See CONTRIBUTING.md. In short: npm install, then npm run dev.
License
- ghudev