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

Select

A native select styled to match Input. It is accessible, mobile-friendly and has no JS overhead.

import { Select } from "@kivu-ui/react"

On this page

UsageProps

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 { Select } from "@kivu-ui/react";
import { Select } from "@kivu-ui/react";

export default function Demo() {
  return (
    <div className="grid w-full max-w-xl gap-4 sm:grid-cols-2">
      <Select label="Role" options={["Editor", "Viewer", "Admin"]} defaultValue="Editor" />
      <Select
        label="Status"
        placeholder="Choose one"
        defaultValue=""
        options={[
          { value: "todo", label: "To do" },
          { value: "doing", label: "In progress" },
          { value: "done", label: "Done" },
          { value: "archived", label: "Archived", disabled: true },
        ]}
      />
    </div>
  );
}

Props

Select

Extends all <select> attributes except size. You can also pass <option> children.

PropTypeDefaultDescription
options(string | { value, label, disabled? })[]-Shorthand for <option> elements.
placeholderstring-Disabled first option with an empty value; pair it with defaultValue="".
labelReactNode-Field label, wired to the control with htmlFor.
labelPosition"inside" | "outside""inside"Small label inside the box, or a regular label above it.
descriptionReactNode-Helper text; linked via aria-describedby.
errorReactNode | boolean-Error message (or true for just a red border). Sets aria-invalid.
variant"default" | "filled" | "glass""default"Visual style. Glass is for brand or image backgrounds.
wrapperClassNamestring-Class for the outer wrapper. className goes to the control itself.
leftSectionReactNode-Content before the value: an icon, prefix or URL stem.
rightSectionReactNodechevronReplaces the chevron.
size"sm" | "md" | "lg""md"Controls the size.

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

PreviousTextareaNextCheckbox