Meridianby Commenda
Components

Badge

A status, colored by meaning.

A status, colored by meaning: New, Live, Coming soon, Sold out. Read-only, never removable. On the site it marks new products, live webinars and changelog entries, and the statuses in product shots. A value someone chose is a Tag.

Coming soonneutral
Newinfo
Livesuccess
Few seats leftwarning
Closederror

Usage

Example.tsx
import { Badge } from "@commenda/meridian/ui/badge";

<Badge label="Live" tone="success" />;

Tones

Five tones, each a meaning. Neutral is the most common: a state that needs nothing from anyone.

Coming soonneutral
Newinfo
Livesuccess
Few seats leftwarning
Closederror

With a dot or a status icon

A dot when color alone would be too quiet, as in a dense list. A status icon when the badge belongs to a lifecycle, so it matches the row’s status icon in a product shot.

DotDraftIn reviewFiledDue soonOverdue
Status iconTo doIn progressIn reviewCompletedRejected

Sizes

sm 20 with Label/12 Strong is the default, in lists, cards and product shots. md 24 with Label/13 Strong sits next to page and section titles.

sm 20LiveNew
md 24LiveNew

Badge and Tag

Same height and corner, different jobs. A Tag is a value someone chose: neutral, has a hairline, can be removed. A Badge is a status: colored by meaning, no border, read-only.

TagSales taxUnited States
BadgeLiveFew seats left

Anatomy

Height 20 (sm) or 24 (md), radius 4 (sm) or 6 (md), padding 6 (sm) or 8 (md), gap 6 between the dot or icon and the label. The tone’s 100 fill with its 800 or 900 text (soft-pearl 200 and 900 for neutral). Every pair passes AA contrast.

API reference

PropTypeDescription
labelRequiredstringFrom Pathfinder.
tone"neutral" | "info" | "success" | "warning" | "error"From Pathfinder.
size"md" | "sm"From Pathfinder.
indicatorConfigObjectView fields · 2 shapesFrom Pathfinder.
classNamestringFrom Pathfinder.
idstringFrom Pathfinder.
indicatorConfigObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
typeRequired"dot"

Option 2

FieldTypeDescription
typeRequired"status"
statusRequired"to-do" | "scheduled" | "in-progress" | "in-review" | "completed" | "canceled" | "blocking" | "blocked-by" | "failed" | "needs-attention"

Best practices

  • Use a Badge for a status; use a Tag for a value someone picked, and a Button or link for anything clickable. Badges are never interactive.
  • Keep labels to one or two words in sentence case: "New", not "NEW" or "This is a new product".
  • One tone per meaning across the site. New is always info, Live is always success.
  • Never rely on color alone: the label carries the meaning. Add a dot or status icon in dense lists.
  • Use one Badge per card. Two badges compete and neither reads.
  • Source: Pathfinder Badge. Meridian keeps it as is.

On this page