A small label for status, counts and highlights like “New”.
import { Badge } from "@kivu-ui/react"On this page
import { Badge } from "@kivu-ui/react";import { Badge } from "@kivu-ui/react";
export default function Demo() {
return (
<div className="flex flex-wrap items-center gap-2">
<Badge variant="soft">Soft</Badge>
<Badge variant="solid">Solid</Badge>
<Badge variant="outline">Outline</Badge>
</div>
);
}import { Badge } from "@kivu-ui/react";
export default function Demo() {
return (
<div className="flex flex-wrap items-center gap-2">
<Badge tone="primary">Primary</Badge>
<Badge tone="accent" variant="solid">New</Badge>
<Badge tone="success">Paid</Badge>
<Badge tone="danger">Overdue</Badge>
<Badge tone="neutral">Archived</Badge>
</div>
);
}caps renders an uppercase, letter-spaced label.
import { Badge } from "@kivu-ui/react";
export default function Demo() {
return (
<div className="flex flex-wrap items-center gap-2">
<Badge caps>Built for small studios</Badge>
<Badge caps size="sm" tone="neutral">Beta</Badge>
</div>
);
}Pass onRemove to add a × button, e.g. for active filters.
import { useState } from "react";
import { Badge, Button } from "@kivu-ui/react";
const initial = ["Status: Active", "Plan: Growth", "Country: Rwanda"];
export default function Demo() {
const [filters, setFilters] = useState(initial);
return (
<div className="flex flex-wrap items-center gap-2">
{filters.map((f) => (
<Badge key={f} variant="outline" tone="neutral" onRemove={() => setFilters(filters.filter((x) => x !== f))}>
{f}
</Badge>
))}
{filters.length === 0 ? (
<Button size="sm" variant="link" onClick={() => setFilters(initial)}>Reset filters</Button>
) : (
<Button size="sm" variant="ghost" onClick={() => setFilters([])}>Clear all</Button>
)}
</div>
);
}Extends <span> attributes.
| Prop | Type | Default | Description |
|---|---|---|---|
variant | "solid" | "soft" | "outline" | "soft" | Visual style. |
tone | "primary" | "accent" | "neutral" | "success" | "danger" | "primary" | Colour family. |
size | "sm" | "md" | "md" | Controls the size. |
caps | boolean | false | Uppercase eyebrow style. |
leftSection | ReactNode | - | Icon before the text. |
onRemove | () => void | - | Adds a × button that calls this. |
removeLabel | string | "Remove {text}" | Accessible name of the × button. |
Every component also accepts className and forwards its ref. Root CSS class: .kivu-badge