Badge Components
A complete badge library — variants, sizes, shapes, statuses, animated effects, tags and ribbons
Solid Variants
Filled badges with rich background colours. Use for labels,
categories and counts.
Primary
Accent
Success
Warning
Danger
Dark
Light
Purple
Pink
Orange
Teal
<span class="badge
badge-primary">Primary</span>
<span class="badge
badge-success">Success</span>
<span class="badge
badge-danger">Danger</span>
<!-- Also: badge-accent | badge-warning | badge-dark | badge-purple |
badge-pink | badge-orange | badge-teal -->
Soft / Ghost Variants
Translucent tinted badges — gentler on the eye, great inside
tables and cards.
Primary
Accent
Success
Warning
Danger
Dark
Purple
Pink
Orange
Teal
<span class="badge
badge-soft-primary">Primary</span>
<span class="badge
badge-soft-success">Success</span>
<!-- Also: soft-accent | soft-warning | soft-danger | soft-purple |
soft-pink | soft-orange | soft-teal -->
Outline Variants
Bordered badges with transparent fill. Pairs well with outline
buttons.
Primary
Accent
Success
Warning
Danger
Dark
Purple
Pink
<span class="badge
badge-outline-primary">Primary</span>
<span class="badge
badge-outline-danger">Danger</span>
Gradient Badges
Multi-stop gradient fills — use sparingly for premium labels and
featured content.
Indigo–Cyan
Green–Cyan
Amber–Red
Purple–Pink
Dark–Indigo
Teal–Green
Premium
Featured
New
Release
Verified
<span class="badge
badge-grad-1">Indigo–Cyan</span>
<span class="badge
badge-grad-4 badge-pill">Purple–Pink</span>
Sizes
Five scales from
xs to xl — use
contextually based on surrounding typography.
Extra Small
Small
Medium
Large
Extra Large
xs
sm
md
lg
xl
<span class="badge
badge-primary badge-xs">Extra Small</span>
<span class="badge
badge-primary badge-sm">Small</span>
<span class="badge
badge-primary badge-lg">Large</span>
<span class="badge
badge-primary badge-xl">Extra Large</span>
Shapes
Rounded (default), pill, square and circle badge shapes for
different contexts.
Rounded · Pill · Square
Rounded
Pill Shape
Square
Starred
Verified
Rejected
Circle counters
3
9
✓
!
★
<span class="badge
badge-primary badge-pill">Pill</span>
<span class="badge
badge-primary badge-square">Square</span>
<span class="badge
badge-danger badge-circle">9</span>
Icon Badges
Leading or solo icon inside a badge for rich visual context.
Admin
Verified
Pending
Blocked
Premium
Live
Open Source
Featured
Trending
Hot
<span class="badge
badge-primary badge-pill"><i
class="fas fa-user-shield"></i> Admin</span>
<span class="badge
badge-grad-4 badge-pill"><i
class="fas fa-crown"></i> Premium</span>
Status Badges
Semantic status indicators with icon + label for user states,
order states, task states, etc.
Active
Inactive
Pending
Blocked
In
Review
Draft
Archived
New
<span class="status-badge
status-active"><i class="fas
fa-circle"></i> Active</span>
<span class="status-badge
status-pending"><i class="fas
fa-clock"></i> Pending</span>
<span class="status-badge
status-blocked"><i class="fas
fa-ban"></i> Blocked</span>
Dot Indicators
Minimal dot + label pairs for inline status display. Also includes
animated pulse variants.
Static dots
Online
Active
Away
Offline
Streaming
Busy
Do Not Disturb
Unknown
Animated pulse dots
Live
Recording
Processing
Syncing
<!-- Static dot -->
<span class="badge-dot
dot-success">Active</span>
<!-- Animated pulse dot -->
<span class="badge-pulse
pulse-green">
<span class="pulse-ring"></span> Live
</span>
Counter & Notification Badges
Numeric counter badges overlaid on icons, avatars, nav items and
buttons.
Standalone counters
1
12
99+
7
✓
!
∞
Overlaid on icons
4
12
3
99+
!
<div class="icon-badge-wrap">
<div class="icon-box"><i class="fas
fa-bell"></i></div>
<span class="badge-counter">4</span>
</div>
Dismissible Badges
Click the × to remove a badge from the DOM — useful for filters,
tags, and selections.
Admin
Verified
Pending
Blocked
Featured
Trending
<span class="badge-dismissible badge-soft-primary">
Admin
<button class="badge-dismiss-btn" onclick="this.parentElement.remove()">✕</button>
</span>
Animated Effects
CSS animation effects: blink, bounce, shake, shimmer, spin-icon,
glow and scale-on-hover.
Blink
Bounce
Shake
✨ Shimmer
Glow
Scale
Hover
<span class="badge
badge-danger badge-blink">Blink</span>
<span class="badge
badge-primary badge-bounce">Bounce</span>
<span class="badge
badge-success badge-shimmer-anim">Shimmer</span>
<span class="badge
badge-primary badge-glow-anim">Glow</span>
Tags & Chips
Bordered tag/chip components for filtering, categories, skills and
keyword lists.
Static tags
React
Node.js
MySQL
Docker
Figma
Design
TypeScript
Open Source
Removable chips (click × to remove)
New York
Full-Time
Remote
$100k+
Senior
MBA
<span class="tag"><i class="fas
fa-code"></i> React</span>
<!-- Removable chip -->
<span class="tag
tag-green">
Full-Time
<button class="tag-x" onclick="this.parentElement.remove()">✕</button>
</span>
Ribbon Badges
Corner ribbon overlays for cards, product tiles, pricing plans and
featured items.
NEW
Basic Plan
$9 / month
SAVE
Pro
Plan
$29 / month
HOT
Enterprise
$99 / month
SALE
Starter
$4 / month
TOP
Premium
$49 / month
✦ BEST
Ultimate
$79 / month
<div class="ribbon-wrap">
<div class="ribbon
ribbon-primary">NEW</div>
Your card content here...
</div>
Real-World Usage
Badges used naturally inside text, user rows, and table contexts.
Inline in text
The v4.2.0 release includes several major improvements. This feature is Stable and ready for production. The old API is Deprecated and will be removed in v5.0. Check the GitHub repo for the full changelog.
User list rows
JD
James Davidson
james.davidson@vboard.io
SC
Sarah Chen
sarah.chen@vboard.io
RP
Ryan Park
ryan.park@vboard.io
EW
Emma Wilson
emma.wilson@vboard.io
ML
Mia Lee
mia.lee@vboard.io