v0.1.0
Get started
Components
Theming
Search docs…
⌘K
Introduction
A lightweight, accessible React component library that plays nicely with Tailwind CSS.
Getting started
Installation
Add Kivu UI to any React 18+ project in four steps.
Getting started
Tailwind CSS
Override any component with utilities, and use the design tokens as Tailwind classes.
Getting started
Next.js
Use Kivu UI with the App Router, Server Components and next/font.
Getting started
Design tokens
Colours, typography, radius and shadows, all as CSS variables you can override.
Theming
Dark mode
Switch themes with a class, avoid the flash, and customise dark colours.
Theming
Customization
className, tokens, component classes, wrappers and asChild.
Theming
Button
Triggers an action. Comes in six variants and three tones, and can render as a link.
Actions
IconButton
A square or round button that holds just an icon. Requires an aria-label.
Actions
Input
Text input with a built-in label, helper text, validation and side sections.
Forms
Textarea
A multi-line text field with the same label and validation API as Input.
Forms
Select
A native select styled to match Input. It is accessible, mobile-friendly and has no JS overhead.
Forms
Checkbox
A native checkbox with label, description and indeterminate support.
Forms
Switch
An on/off toggle built on a native checkbox with role="switch".
Forms
Tabs
Switch between related panels. Supports arrow keys, Home and End.
Disclosure
Accordion
Stacked sections that expand and collapse. Good for FAQs.
Disclosure
Modal
A dialog built on native <dialog>, with focus trap, Escape and top-layer rendering built in.
Overlay
Badge
A small label for status, counts and highlights like “New”.
Data display
Avatar
A profile picture with an automatic initials fallback, plus overlapping groups.
Data display
Card
A surface for grouping content: elevated, outlined, glass or brand.
Data display
Banner
A full-width announcement bar for promotions and notices.
Feedback
Spinner
A loading indicator in the current text colour, announced to screen readers.
Feedback
SectionHeader
Section intro: icon tile, display heading, description and actions.
Layout
Container & Divider
A centred max-width wrapper with responsive gutters, and a simple divider.
Layout
AppShell
The dashboard frame: a collapsible sidebar, a top bar and scrolling content. Below 1024px the sidebar becomes a drawer.
Layout
PageHeader
The top of a dashboard page: breadcrumbs, title, description and actions on the right.
Layout
Drawer
A side panel for record details, edit forms and filters. Built on native <dialog>, like Modal.
Overlay
Tooltip
A short label on hover and keyboard focus, for icon buttons and cut-off text.
Overlay
Popover
A floating panel anchored to a button, for filters and quick edits.
Overlay
DropdownMenu
A menu of actions for rows, the user menu and bulk actions, with full keyboard support.
Overlay
StatCard
A KPI tile: label, big number, change since last period and an optional small chart.
Data display
Table & DataTable
Styled table parts for full control, and DataTable for sorting, row selection, loading and empty states.
Data display
Pagination
Page links for tables and lists, with a compact Previous / Next form for narrow spaces.
Data display
Sparkline & chart colours
A tiny trend chart for KPI cards and table cells, plus a colour palette and themes for Recharts and ECharts.
Data display
Skeleton
Loading placeholders for text, avatars, cards and rows. The shimmer stops for people who prefer reduced motion.
Feedback
EmptyState
What to show when a table, list or search has nothing in it, with a way forward.
Feedback
Toast
Short notices like “Saved” or “Deleted, undo?”. Call toast() from anywhere; render <Toaster /> once.
Feedback
Progress
A bar for quotas, goals and uploads. Leave out value for a busy bar.
Feedback
SegmentedControl
Pick one of a few options, like 7d / 30d / 90d or Chart / Table.
Forms
RadioGroup
Pick one option from a short list, with labels and descriptions. Uses native radio inputs.
Forms
Combobox
A searchable select, for one value or several. Shares the field styles of Input and Select.
Forms
DatePicker & DateRangePicker
Pick a date or a range, with quick presets like “Last 30 days”. Full keyboard support in the calendar.
Forms
Install
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