v0.1.0
Get startedComponentsTheming
Install

Getting started

  • Introduction
  • Installation
  • Tailwind CSS
  • Next.js

Theming

  • Design tokens
  • Dark mode
  • Customization

Layout

  • SectionHeader
  • Container & Divider
  • AppShell
  • PageHeader

Actions

  • Button
  • IconButton

Forms

  • Input
  • Textarea
  • Select
  • Checkbox
  • Switch
  • SegmentedControl
  • RadioGroup
  • Combobox
  • DatePicker & DateRangePicker

Disclosure

  • Tabs
  • Accordion

Overlay

  • Modal
  • Drawer
  • Tooltip
  • Popover
  • DropdownMenu

Data display

  • Badge
  • Avatar
  • Card
  • StatCard
  • Table & DataTable
  • Pagination
  • Sparkline & chart colours

Feedback

  • Banner
  • Spinner
  • Skeleton
  • EmptyState
  • Toast
  • Progress

A lightweight, Tailwind-friendly React component library.

Getting started

  • Introduction
  • Installation
  • Tailwind CSS
  • Next.js

Theming

  • Design tokens
  • Dark mode
  • Customization

Components

  • SectionHeader
  • Container & Divider
  • AppShell
  • PageHeader
  • Button
  • IconButton
  • Input

Released under the MIT License.kivu-ui on npm

Documentation

Getting started

  • Introduction
  • Installation
  • Tailwind CSS
  • Next.js

Theming

  • Design tokens
  • Dark mode
  • Customization

Layout

  • SectionHeader
  • Container & Divider
  • AppShell
  • PageHeader

Actions

  • Button
  • IconButton

Forms

  • Input
  • Textarea
  • Select
  • Checkbox
  • Switch
  • SegmentedControl
  • RadioGroup
  • Combobox
  • DatePicker & DateRangePicker

Disclosure

  • Tabs
  • Accordion

Overlay

  • Modal
  • Drawer
  • Tooltip
  • Popover
  • DropdownMenu

Data display

  • Badge
  • Avatar
  • Card
  • StatCard
  • Table & DataTable
  • Pagination
  • Sparkline & chart colours

Feedback

  • Banner
  • Spinner
  • Skeleton
  • EmptyState
  • Toast
  • Progress

Tailwind CSS

Override any component with utilities, and use the design tokens as Tailwind classes.

On this page

SetupOverridesThe presetWithout Tailwind

Getting started

  • Introduction
  • Installation
  • Tailwind CSS
  • Next.js

Theming

  • Design tokens
  • Dark mode
  • Customization

Layout

  • SectionHeader
  • Container & Divider
  • AppShell
  • PageHeader

Actions

  • Button
  • IconButton

Forms

  • Input
  • Textarea
  • Select
  • Checkbox
  • Switch
  • SegmentedControl
  • RadioGroup
  • Combobox
  • DatePicker & DateRangePicker

Disclosure

  • Tabs
  • Accordion

Overlay

  • Modal
  • Drawer
  • Tooltip
  • Popover
  • DropdownMenu

Data display

  • Badge
  • Avatar
  • Card
  • StatCard
  • Table & DataTable
  • Pagination
  • Sparkline & chart colours

Feedback

  • Banner
  • Spinner
  • Skeleton
  • EmptyState
  • Toast
  • Progress

Kivu UI was designed to sit next to Tailwind CSS v4. There's nothing to configure in JavaScript; it's all CSS imports.

Setup

app/globals.css
@import "tailwindcss";
@import "kivu-ui/styles.css";
@import "kivu-ui/tailwind.css"; /* optional preset */

Overriding styles

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.

The preset

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>
  • Colours: primary-50…900, accent-50…700, ink-50…900, surface, canvas, canvas-subtle, fg, fg-muted, fg-subtle, line, line-strong, success, danger
  • Fonts: font-display, font-body
  • Radius: rounded-kivu-sm…2xl. Shadows: shadow-kivu-sm…xl
  • Variant: dark: follows the same .dark / data-theme switch as the library.

Without Tailwind

Just import kivu-ui/styles.css. Everything works the same; you style the rest with your own CSS.

PreviousInstallationNextNext.js