Badge
A React component in Beamline's Content & display category, in the free sample.
A short status, category or count label: six tones, an icon or a status dot, two sizes.
Use it for
- Short status, category or count labels next to content: Paid, Trial · 5 days, Beta, 12.
Not for
- Actions (button).
- Removable values (tag-input or chip-group).
- A number that changes live (slot-text inside your own label).
Anatomy
- root (span)
- leading icon or status dot
- text
Variants
- tone: neutral, accent, success, warning, danger, info
- size: sm, md
States
- static
Keyboard
- Not focusable; it labels, it does not act.
Motion
None: badges sit in dense tables and must cost nothing.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
tone | "neutral" | "accent" | "success" | "warning" | "danger" | "info" | "neutral" | Semantic colour; pair it with a word or icon (colour is never the only signal). |
size | "sm" | "md" | "md" | Height 20 / 22 px. |
icon | ReactNode | — | A leading icon element. |
dot | boolean | — | A leading status dot in the tone colour (instead of an icon). |
style / ref | CSSProperties / native Ref | — | native span |
classNames | BadgeClassNames | — |
Dependencies
motion
Import
import { Badge } from "@/components/badge/badge";
Get it
Badge is part of Beamline: 190 React components and screens your coding agent (Claude Code, Codex, Cursor or any MCP client) installs into your app through Beamline's MCP server, as a ready-built package or as plain React source you can change. $49 one payment (regular $200), no subscription, a year of updates, one licence for your whole team. Badge is in the free sample, which costs nothing. Get Beamline · Connect your agent
More in Content & display
- Advertisement: A sponsor or promo slot that turns through its ads on a hairline that fills; hovering or focusing holds the current ad.
- Avatar: A person or account in a small space: a photo, or initials on the hue their name always gets; presence dot; circle for people, square for companies.
- Avatar group: A team in a small space: overlapping faces that name themselves on hover or focus, and “+N” naming the rest.
- Code block: Code to read and copy: highlighted in the system's colours, numbered, marked lines, long files folded behind “Show all”.
- Comment thread: A discussion attached to something: replies, reactions, @mentions, editing and deleting your own, resolve that folds the thread.
- File diff: A change to one file as a unified diff: line numbers, tinted lines, only the changed words marked, long unchanged stretches folded; give rows or just…
- Image compare: Two images in one frame with a divider: drag anywhere, or arrow keys on the handle; horizontal or vertical, with captions.
- Item: The generic list row: media, title, description, meta and trailing actions; becomes a link or button when interactive.
- Kbd: Keyboard keys as keycaps; `mod` resolves to ⌘ or Ctrl per platform, symbols are spoken as words.
- Lightbox: A full-screen image viewer: a thumbnail grows into it and shrinks back, arrows and ←/→ step through the set, Esc or a downward drag closes it.
- Logo Carousel: A wall of logos shown a few at a time: every few seconds the slots turn left to right, each logo leaving upward as the next rises in.
- Marker: A labelled point in a stream: a status event with an icon between messages, or a label such as "Today" between two hairlines.
- QR Code: A scannable code set as gradient dots with rounded finder rings and an optional centre mark; a new value ripples out from the centre.
- Slot text: Text and numbers that roll into their new value on reels, digit by digit from the right; other characters fade. Read as plain text by assistive tech.
- Text morph: A short label that becomes its next state letter by letter: shared letters glide into place, new ones arrive, old ones leave.
- Text reveal: A headline whose words rise into place once, the first time it scrolls into view; never repeats.
- Text shimmer: Ongoing work said in words (“Thinking…”) with a calm band of light passing across them; stops when inactive.
- Timeline: What happened, newest first and grouped by day: people with avatars, systems with toned icons, relative times with the exact time on hover, details in…
- Video player: A video player on the native <video> element: title bar with an external link and close, centre play with ±10 s, scrub, time, volume, speed, captions…