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/react 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

Design tokens

Colours, typography, radius and shadows, all as CSS variables you can override.

On this page

RebrandPaletteSemantic tokensType & shape

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

All design decisions are CSS custom properties on :root. The library declares them in @layer theme, so overriding them from your own CSS always works.

Rebrand in one block

globals.css
:root {
  /* brand scale */
  --kivu-primary-50: #f3effe;
  --kivu-primary-500: #8b5cf6;
  --kivu-primary-600: #7c3aed;
  --kivu-primary-700: #6d28d9;

  /* shape */
  --kivu-radius-md: 10px;
  --kivu-radius-lg: 14px;
}

Components read semantic tokens such as --kivu-primary, which point at the scale. Changing the scale rebrands everything, including the Tailwind preset utilities.

Palette

primary

50

100

200

300

400

500

600

700

800

900

accent

50

100

400

500

600

700

ink

50

100

200

300

400

500

600

700

800

900

Semantic tokens

These change between light and dark mode.

--kivu-bgPage background
--kivu-bg-subtleSection background
--kivu-surfaceCards, inputs, menus
--kivu-fgMain text
--kivu-fg-mutedBody copy
--kivu-fg-subtleCaptions, placeholders
--kivu-borderDividers
--kivu-border-strongInput borders
--kivu-primaryBrand actions
--kivu-primary-softSoft buttons, chips
--kivu-accentHighlights, “New” badges
--kivu-ringFocus ring

Typography, radius & shadow

--kivu-font-display   --kivu-font-body
--kivu-text-xs … --kivu-text-3xl     --kivu-tracking-caps
--kivu-radius-sm (4px)  -md (6px)  -lg (8px)  -xl (12px)  -2xl (16px)  -full
--kivu-shadow-sm  -md  -lg  -xl
--kivu-duration (160ms)  --kivu-ease  --kivu-container (1280px)
PreviousNext.jsNextDark mode