Badge
Freev1.0.0The shadcn Badge with status tones and live state changes.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { Badge } from "@/components/ui/notchset/badge";
export function BadgeExample() {
return (
<Badge tone="ready">READY</Badge>
);
}Props
tone–"ready" | "review" | "running" | "attention" | "tag" | "count"The look; signal only for attention.
count–numberThe count tone's rolling number.
LiveBadge states / value–{ label, tone }[] / numberA badge that moves through states.
Anatomy
- Same name as shadcn's Badge, with tones instead of variants.
- No primitive needed: one file serves both builds.
- Signal is reserved for attention.
Badgedata-slot="badge"A badge.
LiveBadgedata-slot="live-badge"A badge that changes state.
badgeVariantsdata-slot="—"The cva tones.
Source
components/ui/notchset/badge.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/badge.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/badge.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. Add the packages
pnpm add class-variance-authority@^0.7 - 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/badge.tsx
- lib/beautiful-ui/notchset/live-badge.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- lib/beautiful-ui/notchset/calendar.tsx
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Status, tags and counts beside names and titles
Use something else when
- Actions: use Button
Mistakes to avoid
- Keep labels short; use tag for metadata, status tones for state
Agents find it by
- badge, status badge, tag, pill, count badge, label, live status, shadcn badge, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/badge.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- —
- Not interactive
Accessibility
- Text first: tones never carry meaning alone
- LiveBadge is a polite live status labelled with its state
Motion
- Live width
- Glides to fit the new label (420ms)
- Live label
- Rolls past the old one (420ms, +60ms)
- Live node
- Ring and scanner cross-fade; the filled node pops in (340ms, +160ms)
Responsive
- Never wraps.
Performance
- CSS transitions; LiveBadge measures its labels once.
Changelog
v1.0.0 · 2026-10-02
First release
