Ballmac UI home

Status Badge Row

A status page block: an overall banner and one row per service with a status chip, uptime and a 90-day bar history you can explore with the pointer or arrow keys.

All systems operational

Updated a minute ago

  • API

    REST and GraphQL

    Operational
  • Dashboard

    app.example.com

    Operational
  • Webhooks

    Outgoing deliveries

    Operational
  • Background jobs

    Operational
60 days agoToday

Installation

$ pnpm dlx shadcn@latest add @ballmac/status-badge-row

Usage

import { StatusBadgeRow } from "@/components/ballmac/status-badge-row"

The full example is in the Code tab above.

Examples

During an incident

Some systems are down

Incident opened 14 minutes ago

  • API

    Returning errors for some requests

    Outage
  • Dashboard

    Data may be out of date

    Degraded performance
  • Billing

    Scheduled until 18:00 UTC

    Maintenance
45 days agoToday

API reference

PropTypeDefault
services*

The services to list.

ServiceItem[]—
title

Heading above the list.

string—
endDate

ISO date of the newest day in each `days` array, for example "2026-09-30". Used to label the bars.

string—
updated

Text under the heading, such as "Updated 2 minutes ago".

string—
summary

Replaces the computed banner message.

string—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
ArrowLeft / ArrowRightMoves through days; Shift moves by a week; Home and End jump to the ends
Screen readersEach history is a slider whose value text reads 'Sep 21: Outage'
ColorStatus is also shown by icon, word and bar height

Use with AI

services is [{ name, status, description?, uptime?, days? }]; days holds one status (or { status, note }) per day, oldest first. endDate labels the bars. The banner shows the worst status. Bar height as well as color encodes status. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Status Badge Row (@ballmac/status-badge-row) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Public or internal status pages
  • Admin dashboards listing service health

Not for

  • A single presence dot (status-dot)
  • Charting numeric metrics (chart)

Registry JSON: https://ui.ballmac.com/r/status-badge-row.json

Credits

Free to use in personal and commercial projects.