Status
Show where a run stands, with a mark and a word.
Use a status badge beside a run, a job or a tool call to show whether it's waiting, running, needs input or is done. Its mark and its text both say the status, so it never depends on color alone.
- BuildComplete
- Deploy to stagingRunning
- Approve releaseNeeds input
Installation
npx shadcn@latest add @kind-ui/statusComposition
Status
├── StatusIcon
└── StatusLabelStatus renders both parts when you pass no children; any children you pass replace them. StatusIcon draws the mark and is hidden from screen readers, and StatusLabel shows the label, or its own children.
Usage
Status and Label
Set status as the work moves along: pending, running, awaiting-input, complete, error or cancelled. The label follows it: "Pending", "Running", "Needs input", "Complete", "Failed" or "Cancelled". Pass label for your own words, like "Deployed".
A new label can change the badge's width, so put it at the end of a row, where nothing comes after it. Its height stays the same for every status.
Announcements
When the status changes to awaiting-input, complete, error or cancelled, the badge tells screen readers its label, politely. Other changes, and label changes while the status stays the same, are quiet. The badge takes no focus and has no keys.
Motion
The mark morphs from one status to the next. Under prefers-reduced-motion, or with motion="reduced", it fades over 120 ms instead, and with motion="none" it changes at once.
API Reference
Prop
Type
Agent
An agent connected with createAgent sees each badge as a kind-status and reads its status. It has no actions.
Runs in React and Web Components. On <kind-status>, status, label and motion are attributes of the same name, and the element fills in its mark and label when it has no children. It writes the label into an empty <kind-status-label>, and leaves text you wrote there alone.