10Shipped

StatusBadge

Agent workflow state summary: scanning, queued, posted, error.

Import

import { StatusBadge } from "@charply/design"

Variants

Agent states

Scanning

Finding relevant posts

Queued

Waiting for review

Posted

History updated

Props

PropTypeDefaultDescription
labelstringMain status label
descriptionstringSupporting detail text
tone"info" | "active" | "success" | "warning" | "error" | "neutral"Visual tone
iconReactNodeIcon element (use size-5)

Guidelines

docs/design/components/statusbadge.md

Do

  • Use `StatusBadge` for agent workflow state only (not for generic category tagging — use `Badge` instead).
  • Pair with a relevant Lucide icon at `size-5`.

Don't

  • Use `StatusBadge` for metadata labels — use the regular `Badge`.
  • Stack multiple `StatusBadge` instances unless showing a timeline of states.

See all variants and interactive states in Storybook. Run npm run storybook to open the workbench.