Badge

A small label for status, category, or count indicators.

SubtleOutlineSolidBrandBrand OutlineBrand SolidAccentAccent OutlineAccent SolidDangerDanger OutlineDanger SolidSuccessSuccess OutlineSuccess SolidWarningWarning OutlineWarning Solid

Installation

pnpm dlx stera-ui add badge

Usage

import { Badge } from "@/components/ui/badge"
<Badge variant="brand">New</Badge>

Variants

Each color has three style levels: subtle (default), outline, and solid.

SubtleOutlineSolidBrandBrand OutlineBrand SolidAccentAccent OutlineAccent SolidDangerDanger OutlineDanger SolidSuccessSuccess OutlineSuccess SolidWarningWarning OutlineWarning Solid
VariantDescription
defaultSubtle neutral background
outlineBordered, no background
solidStrong neutral inverse background
brandBrand-colored subtle
brand-outlineBrand-colored bordered
brand-solidBrand-colored filled
accentAccent-colored subtle
accent-outlineAccent-colored bordered
accent-solidAccent-colored filled
dangerDanger-colored subtle
danger-outlineDanger-colored bordered
danger-solidDanger-colored filled
successSuccess-colored subtle
success-outlineSuccess-colored bordered
success-solidSuccess-colored filled
warningWarning-colored subtle
warning-outlineWarning-colored bordered
warning-solidWarning-colored filled

Sizes

SmallDefaultLarge
SizeDescription
smSmall (default)
mdMedium
lgLarge

With Icon

Use data-icon="inline-start" or data-icon="inline-end" on an icon to adjust spacing.

ActiveActiveActiveOfflineOfflineOffline
<Badge variant="success">
  <SiCircleFill data-icon="inline-start" />
  Active
</Badge>

API Reference

PropTypeDefault
variant"default" | "outline" | "solid" | "brand" | "brand-outline" | "brand-solid" | "accent" | "accent-outline" | "accent-solid" | "danger" | "danger-outline" | "danger-solid" | "success" | "success-outline" | "success-solid" | "warning" | "warning-outline" | "warning-solid""default"
size"sm" | "md" | "lg""sm"
renderReact.ReactElement

Accepts all standard <span> props. Supports render prop for polymorphic rendering via Base UI's useRender.