Skip to content
ArcadiaDesign
RequestsToday
9,100up 12% from Sep 8
LatencyToday
111msdown 14% from Sep 8
ErrorsToday
39up 22% from Sep 8
SessionsToday
1,388up 12% from Sep 8
A dashboard's head: four tiles, each today against the same day four weeks before. Point at a sparkline and its tile reads the day.

TSX

A stat is a number and what it is: a label, the period it covers, the value, its change and, if the shape matters, a sparkline of the values behind it. It is the lightest way to show data, so try it first: two or three values are stats side by side, never a chart. Reach for a meter for how much of a limit is left, a table for values a person compares or copies, and a plot when the scale itself must be read.

The change is a Delta, measured against a period of the same length that it names; give it a polarity only where one direction is plainly good. A sparkline's ends are the two values its change compares, so the line and the words agree.

Anatomy

Label
What it counts, with its unit where the value has none: Caption in --text-2. One too long for its tile fades at its end.
Period
What the value covers, at the end of the label's line in Caption and --text-3, tabular.
Value
The largest thing in the tile, in full: Title 3, 20/23 at 600, tabular, in --text-1. It never wraps and is never cut.
Delta
A Delta in Caption on its own line under the value, starting where the value starts. It never sits beside the value, however much room there is, so tiles in a row keep the same lines.
Sparkline
Optional, 32px tall across the tile at its foot, 12px under the change, or under the value in a tile with no change. Its reading writes the value and the period.
Frame
None. Tiles in a row part by space or hairlines; one that stands alone may sit in a Card.

Examples

Alone in a card

A tile that stands on its own may sit in a Card. The sparkline's read dot is ringed with the card's surface.

Storage usedToday
441 GBup 7.0% from Sep 8

Without a sparkline or a delta

A missing part drops out and leaves nothing in its place: a count of seats with its change and no shape, deploys a day with no change worth naming.

SeatsThis month
34up 6 from last month
DeploysToday
9

Long values and narrow tiles

The value keeps its width and never wraps, and the change keeps its own line under it, so a narrow tile reads as a wide one does.

Requests2026
184,203,991up 31% from 2025
CachedToday
4,610up 12% from Sep 8

Reading

With a Sparkline inside, the tile is its sparkline's host: the value and the period read the row.

Point at the sparkline, tap it or step it with the arrow keys, and the tile's value and period become the read row's, in the same frame as the sparkline's dot: no rolling digits, nothing sliding. The change belongs to the newest value: while another row is read it steps out of sight and keeps its line, so nothing under it moves. When the reading ends the newest value and its period come back at once.

The value and the period hold the width of their widest reading from the first frame, so nothing in the tile, or around it, moves while a person reads.

A tile is a group (role="group") named by its label. Inside it a screen reader meets the period, the value and the change in words, "up 12% from Sep 8", then the sparkline, named from its data.

Its sparkline is a slider over its rows whose value text is the read row's: one key back from the newest, the first tile's reads "Mon, Oct 5: 9,070". That is what is heard as the keys step it; the tile's own value changes for the eye, so the tile needs no status region.

Stat

labelrequired
string
What it counts: "Requests", "Spend in USD".
period
string
What the value covers: "Today".
valuerequired
string
In full: "12,480".
delta
ReactNode
A Delta.
rootStyle
RootStyle
A component's typed override prop: Layout and its documented knobs, each the references it takes or another kit knob of its kind; anything else is a type error at the call site (STYLEX.md).
children
ReactNode
A Sparkline, whose reading writes the value and the period.

Rest props go to HTMLAttributes<HTMLDivElement>.