Ballmac UI home

Log StreamPRO

A live log viewer with level filters and counts, search with highlighted matches, wrap, pause with a new-lines counter, follow-the-tail scrolling and copy.

Deployment logs

Waiting for output…

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/log-stream

Usage

import { LogStream, clock } from "@/components/ballmac/log-stream"

The full example is in the Code tab above.

Examples

Filtered build output

Last hour

INFOGET /v1/projects 200 in 38 ms
INFOPOST /v1/customers 201 in 112 ms
WARNSlow query on customers.by_email took 1.4 s
ERRORJob invoice.send failed: connect ETIMEDOUT 10.0.4.12:587
DEBUGRetry scheduled for job invoice.send in 30 s (attempt 2 of 5)
INFOGET /v1/customers/cus_91 200 in 21 ms
ERRORPOST /v1/subscriptions 500: unique constraint violated
INFOJob invoice.send succeeded after 2 attempts

API reference

PropTypeDefault
lines*

All lines so far, oldest first. Append to this array as the stream delivers.

LogLine[]—
title

Heading in the toolbar.

string—
maxLines

Most lines kept on screen; older ones are dropped from view.

number1000
follow

Stick to the newest line while at the bottom.

booleantrue
height

Height of the log area.

string"20rem"
wrap

Wrap long messages instead of scrolling sideways.

boolean—
hideSource

Hide the source column.

booleanfalse
onClear

Adds a Clear button that calls this.

() => void—
emptyText

Shown when there are no lines yet.

string—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabReaches filters, search, wrap, pause, copy, then the scrollable log (role=log)
Screen readersThe log is not announced line by line; pause state is announced; levels are words
ColorLevel is a word and a bar

Quality scorecard

6/6

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.

  • Not applicable: Right to left

    Not mirrored by design: Log lines are left-to-right inside by design.

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    18 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 log-stream.test.tsx.

  • For information: Footprint

    3.8 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

lines is [{ id, time, level, message, source? }], oldest first; append as lines arrive. Follows the tail while you are at the bottom, shows 'N new lines' when paused or scrolled up. maxLines limits what is rendered. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Log Stream (@ballmac-pro/log-stream) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Deploy, build and server logs
  • Streaming output from background jobs

Not for

  • A terminal with input (terminal)
  • Millions of lines (use a virtualized list)

Registry JSON (needs your licence key): https://ui.ballmac.com/r/pro/log-stream.json

Credits

Covered by the Ballmac UI Pro license.