Ballmac UI home

Status Badge RowPRO

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

  1. Get a Pro licence key.

    The source is part of Ballmac UI Pro.

    Log in with your licence key to read and copy it here, or install it through the shadcn CLI or the MCP server. You own the code once it is in your project.

    $49 once regular price $99for this and every other Pro item. Tax included.Money back if it does not work.

  2. Once per project: add the Pro registry and your licence key.

    components.json
    {
      "registries": {
        "@ballmac": "https://ui.ballmac.com/r/{name}.json",
        "@ballmac-pro": {
          "url": "https://ui.ballmac.com/r/pro/{name}.json",
          "headers": { "Authorization": "Bearer ${BALLMAC_LICENSE_KEY}" }
        }
      }
    }
    .env.local
    BALLMAC_LICENSE_KEY=your-licence-key
  3. Add it.

    $ pnpm dlx shadcn@latest add @ballmac-pro/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

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    7 tab stops, each showing a visible change when it takes focus. 3 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by status-badge-row.test.tsx.

  • For information: Footprint

    3.3 KB of source (gzip) in 1 file. Installs lucide-react.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

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-pro/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 (needs your licence key): https://ui.ballmac.com/r/pro/status-badge-row.json

Credits

Covered by the Ballmac UI Pro license.