Override any component with utilities, and use the design tokens as Tailwind classes.
On this page
Kivu UI was designed to sit next to Tailwind CSS v4. There's nothing to configure in JavaScript; it's all CSS imports.
@import "tailwindcss";
@import "kivu-ui/styles.css";
@import "kivu-ui/tailwind.css"; /* optional preset */Component styles are declared in @layer components, the same layer order Tailwind uses. Utilities live in a later layer, so any utility you pass wins:
<Button className="rounded-full bg-emerald-600 px-10 hover:bg-emerald-700">
Custom
</Button>You don't need tailwind-merge or !important. Your own unlayered CSS beats the library too.
kivu-ui/tailwind.css maps the design tokens into Tailwind's theme, so your own markup can match the components. These utilities follow theming and dark mode automatically.
<div className="rounded-kivu-xl bg-surface p-6 shadow-kivu-md">
<h2 className="font-display text-ink-800 dark:text-fg">Hello</h2>
<p className="text-fg-muted">Muted text</p>
<span className="bg-primary-50 text-primary-700">Brand</span>
<span className="text-accent">Accent</span>
<hr className="border-line" />
</div>primary-50…900, accent-50…700, ink-50…900, surface, canvas, canvas-subtle, fg, fg-muted, fg-subtle, line, line-strong, success, dangerfont-display, font-bodyrounded-kivu-sm…2xl. Shadows: shadow-kivu-sm…xldark: follows the same .dark / data-theme switch as the library.Just import kivu-ui/styles.css. Everything works the same; you style the rest with your own CSS.