Status
System state as icon plus label plus colour — never colour alone.
Live preview
Source
The exact file rendered in the preview above.
components/demos/status.tsx
components/ui/status.tsx
Demo source — adapt to your project. Foundry is not published as a package.
Usage
For the state of a thing: a service, a deployment, an invoice. Deliberately separate from Badge so that the "always pair an icon with the label" rule can be enforced by the component rather than by review.
- Dot appearance suits dense tables; pill suits a standalone header; inline suits detail views.
- Keep the label a real word ("Degraded performance"), not a code.
- Pending is a state, not a failure — give it its own kind rather than reusing warning.
Variants and states
Every entry below is a genuine difference in behaviour or layout, and every one of them is visible in the preview above.
- Inline
- Pill
- Dot
- Six kinds — operational, degraded, down, pending, info, idle
Accessibility
- Colour independence
- Every appearance includes the label text, so the meaning survives greyscale and colour vision deficiency.
- Icons
- Icons are decorative; the text is the content.
Foundry implements published ARIA patterns and is tested against them. No WCAG certification is claimed — see the accessibility documentation for what is and is not covered.
Related
All componentsBadge
Compact labelling with seven tones, three appearances and an optional second, colour-independent signal.
starter6 variantsAlert
A block-level message attached to a region, with tone-appropriate live-region politeness.
starterFeatured6 variantsTable
A semantic table with two responsive strategies, a focusable scroll region and a built-in empty state.
intermediateFeatured5 variants