Design System

Tags & badges

Compact labels for categories, metadata and status. The treatments use Centrim semantic tokens in both light and dark themes.

Tag

A static category, keyword or filter label. Choose an outlined, subtle or solid semantic treatment to match the required emphasis.

import { Tag } from "@/design-system";

When to use

  • Categories, skills and keywords
  • Metadata that benefits from quick visual grouping

When not to use

  • Status that needs semantic meaning — use Badge
  • Clickable filters — use Chip

Outlined

Low-emphasis labels matching the light treatment in the reference.

NeutralRetirement VillageAccentSuccessWarningErrorInfo

Solid

High-emphasis labels for short, scannable metadata.

NeutralResidential CareAccentSuccessWarningErrorInfo

Subtle

Soft fills for dense groups without competing with primary actions.

NeutralBrandAccentSuccessWarningErrorInfo

Sizes and removable

Small tagMedium tagCare planning

Accessibility

  • Tag text always carries the meaning; colour is supplementary.
  • The optional remove affordance is keyboard reachable and has an accessible name.
  • Semantic treatments use the system's light and dark theme tokens.

Badge

A compact, non-interactive status or metadata label. Use subtle by default, outline for light emphasis, and solid for the strongest status treatment.

import { Badge } from "@/design-system";

When to use

  • Statuses, counts and concise system metadata
  • Icon-supported information labels

When not to use

  • Categories and keywords — use Tag
  • Actions — use Button or IconButton

Outlined status badges

NeutralBrandAccentSuccessWarningErrorInfo

Subtle and solid

In progressActiveReview dueOverdueNew

Dot indicators

A tonal dot for quiet status lists; the label still carries the meaning.

NeutralBrandAccentSuccessWarningErrorInfo

Leading icons

Pair the tone with an icon so status is never colour-only.

ApprovedDeclinedExpiringAwaiting reviewFeaturedDraftHighlighted

With avatar

Compose Avatar at the matching size to attribute a status to a person.

ApprovedOwnerMWReviewer

Sizes

Small (24px), medium (28px) and large (32px) badges.

SmallMediumLarge

Dismissible

The optional remove control is keyboard reachable and needs an accessible name.

LabelSarah ChenOverdue

Icon-only

Circular icon badges for dense rows; each carries an aria-label.

Counts

Rounded counts for overflow and aggregate metadata.

+1 others+312