Skip to content

Badge

A compact status indicator with semantic variants, optional dot mode, and a removable option.

Preview

DraftActivePendingFailedInfo

With dot indicator

OnlineAwayOffline

Sizes

SmallMedium

Variants

VariantBackgroundText colourUse case
defaultgrey.800grey.300Neutral labels and tags
successrgba(34, 197, 94, 0.12)#22C55EActive, complete, online
warningrgba(234, 179, 8, 0.12)#EAB308Pending, needs attention
errorrgba(239, 68, 68, 0.12)#EF4444Failed, offline, blocked
inforgba(59, 130, 246, 0.12)#3B82F6Informational, in progress

Sizes

SizeFont sizePadding
sm11 px1px 6px
md13 px2px 10px

Features

  • Dot mode -- prepends a small coloured dot before the label for extra visual weight.
  • Removable -- shows a close icon. Fires onRemove when clicked.

Props

PropTypeDefaultDescription
variant'default' | 'success' | 'warning' | 'error' | 'info''default'Colour variant
size'sm' | 'md''sm'Badge size
dotbooleanfalseShow a coloured dot before the label
removablebooleanfalseShow a close/remove icon
onRemove() => void--Called when the remove icon is clicked
classNamestring--Additional CSS classes
childrenReact.ReactNode--Badge label

Code example

React

tsx
import { Badge } from '@thepace/lexicon/components';

function StatusList() {
  return (
    <div style={{ display: 'flex', gap: 'var(--space-2)' }}>
      <Badge variant="success" dot>Active</Badge>
      <Badge variant="warning">Pending</Badge>
      <Badge variant="error" removable onRemove={() => {}}>Failed</Badge>
      <Badge variant="info" size="md">v1.0.0</Badge>
      <Badge>Draft</Badge>
    </div>
  );
}

Vanilla HTML

html
<span class="lex-badge lex-badge--success lex-badge--dot">Active</span>
<span class="lex-badge lex-badge--warning">Pending</span>
<span class="lex-badge lex-badge--error lex-badge--removable">
  Failed
  <button class="lex-badge__remove" aria-label="Remove">&times;</button>
</span>
<span class="lex-badge lex-badge--info lex-badge--md">v1.0.0</span>
<span class="lex-badge">Draft</span>

CSS class reference

ClassPurpose
.lex-badgeBase badge styles
.lex-badge--defaultDefault variant
.lex-badge--successSuccess variant
.lex-badge--warningWarning variant
.lex-badge--errorError variant
.lex-badge--infoInfo variant
.lex-badge--smSmall size
.lex-badge--mdMedium size
.lex-badge--dotDot mode
.lex-badge--removableRemovable mode
.lex-badge__removeRemove button

Released under the MIT License. A product by the pace.