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

Tabs

Switch between related panels. Supports arrow keys, Home and End.

import { Tabs, TabsList, TabsTrigger, TabsPanel } from "kivu-ui"

On this page

UsagePillsControlledProps

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

Usage

import { Tabs, TabsList, TabsTrigger, TabsPanel } from "kivu-ui";
12 open tasks, 3 due this week.
import { Tabs, TabsList, TabsPanel, TabsTrigger } from "kivu-ui";

export default function Demo() {
  return (
    <Tabs defaultValue="overview" className="w-full">
      <TabsList grow>
        <TabsTrigger value="overview">Overview</TabsTrigger>
        <TabsTrigger value="activity">Activity</TabsTrigger>
        <TabsTrigger value="files">Files</TabsTrigger>
      </TabsList>
      <TabsPanel value="overview">12 open tasks, 3 due this week.</TabsPanel>
      <TabsPanel value="activity">Mei moved “Logo sketches” to Done.</TabsPanel>
      <TabsPanel value="files">48 files · 1.2 GB</TabsPanel>
    </Tabs>
  );
}

Examples

Pills

A compact segmented style.

Tasks grouped by status.
import { Tabs, TabsList, TabsPanel, TabsTrigger } from "kivu-ui";

export default function Demo() {
  return (
    <Tabs defaultValue="board" variant="pills">
      <TabsList>
        <TabsTrigger value="board">Board</TabsTrigger>
        <TabsTrigger value="list">List</TabsTrigger>
      </TabsList>
      <TabsPanel value="board" className="pt-4">Tasks grouped by status.</TabsPanel>
      <TabsPanel value="list" className="pt-4">Every task in one sortable list.</TabsPanel>
    </Tabs>
  );
}

Controlled

Pass value and onValueChange to own the state.

31 hours tracked.

value: week

import { useState } from "react";
import { Tabs, TabsList, TabsPanel, TabsTrigger } from "kivu-ui";

export default function Demo() {
  const [tab, setTab] = useState("week");
  return (
    <div className="w-full max-w-sm">
      <Tabs value={tab} onValueChange={setTab}>
        <TabsList grow>
          <TabsTrigger value="week">This week</TabsTrigger>
          <TabsTrigger value="month">This month</TabsTrigger>
        </TabsList>
        <TabsPanel value="week">31 hours tracked.</TabsPanel>
        <TabsPanel value="month">142 hours tracked.</TabsPanel>
      </Tabs>
      <p className="mt-4 font-mono text-xs text-fg-muted">value: {tab}</p>
    </div>
  );
}

Props

Tabs

PropTypeDefaultDescription
defaultValuestring-Initially selected tab (uncontrolled).
valuestring-Selected tab (controlled).
onValueChange(value: string) => void-Called when the selection changes.
variant"underline" | "pills""underline"Visual style.
keepMountedbooleanfalseKeep inactive panels in the DOM (hidden).

TabsList

PropTypeDefaultDescription
growbooleanfalseTriggers share the full width equally.

TabsTrigger

Extends <button> attributes.

PropTypeDefaultDescription
valuestring-Required. Matches a TabsPanel.

TabsPanel

PropTypeDefaultDescription
valuestring-Required. Matches a TabsTrigger.

Every component also accepts className and forwards its ref. Root CSS class: .kivu-tabs

PreviousDatePicker & DateRangePickerNextAccordion