BarList

Markdown

Ranked rows with a bar behind each name, for tokens by tool, spend by agent or calls by model.

Use it for
Ranked totals: tokens by tool, spend by agent, calls by model.
Not for
Values over time. Try Chart.

BarList preview

Loading example…

Installation

npm install @stackunseen/ui
import { BarList } from '@stackunseen/ui';
Styles: @stackunseen/ui/styles.css

Usage and props

Sort the rows and format each value in your app; the bar repeats the printed value and never replaces it.

Supported inputs

This is the public signature used by this example. Open Code to see how the values and callbacks fit together.

label · items: { id, label, value, display? }[] · max? · headings?: [name, value]
How state and callbacks work
All props

Loading…

For your coding agent

Give the agent this page instead of a screenshot. The prompt wraps the page with the install and import lines and the rule that your server, not a click, completes an action.

Contract
label · items: { id, label, value, display? }[] · max? · headings?: [name, value]
Keeps honest
Sort the rows and format each value in your app; the bar repeats the printed value and never replaces it.
MCP
read_component "BarList" on the docs endpoint
Open the Markdown file

Keyboard and customization

Keyboard

Inert content; the list is read in order.

Customization

Change shared colors, spacing, corners and icons with the theme. Use the component's supported props to adapt its content and layout. Customization guide and Theme Studio