Badge Count

Numeric count badges for notifications, cart items, and unread indicators.

5
12
3
1import { BadgeCount } from "@/zeroui/components/badges";
2import { Bell, Mail, ShoppingCart } from "lucide-react";
3

Variants

5default
5destructive
5success
5warning
1<BadgeCount count={5} variant="default" />
2<BadgeCount count={5} variant="destructive" />
3<BadgeCount count={5} variant="success" />

Sizes

8sm
8md
8lg
1<BadgeCount count={8} size="sm" />
2<BadgeCount count={8} size="md" />
3<BadgeCount count={8} size="lg" />

Max Value Overflow

5050
9999
99+100 → 99+
999max=999
999+1000 → 999+
1<BadgeCount count={50} />
2<BadgeCount count={99} />
3<BadgeCount count={100} /> {/* Shows 99+ */}

Show Zero

(hidden)
count=0
0showZero
1<BadgeCount count={0} /> {/* Hidden by default */}
2<BadgeCount count={0} showZero /> {/* Visible with showZero */}

Use Cases

3
Notifications
28
Messages
99+
Email
2
Cart
42
Likes
1// Notifications
2<div className="relative">
3 <Bell className="h-6 w-6" />

Standalone Usage

Unread messages5
Items in cart3
Pending tasks12
1<div className="flex items-center gap-2">
2 <span>Unread messages</span>
3 <BadgeCount count={5} variant="destructive" />

Installation

npx zeroui@latest add badge-count

Props

nametypedefaultdescription
countnumber--
maxnumber99-
variant"default" | "destructive" | "success" | "warning""default"-
size"sm" | "md" | "lg""md"-
showZerobooleanfalse-