Stats

Prop

Type

Default

Description

Props

1 prop

items *

StatItem[]

–

The metrics to render, in order.

Surface

8 props

plain

boolean

false

Borderless metric stacks on a shared surface, for nesting inside a card.

compact

boolean

false

Dense value-first tile for a navigation rail: a 12px inset and a 20px headline.

large

boolean

false

Value-first dashboard tile with a 36px headline.

title

string

–

Optional heading shown above the metrics (mainly for the plain surface).

framed

boolean

false

Draw every metric's strip on a muted track, in one bounded band. For a ROW of metrics, where the strips are read against each other. Without it each strip draws only its marks, so a metric with a quiet series shows a near-empty band beside one with a full bar and the row's densities range from blank to solid with nothing tying them together; the eye lands on the fullest tile rather than scanning the row. The track gives every strip the same frame whatever its data, so a flat series reads as a chart sitting at zero and the fill is the only thing that varies.

onPressItem

(index: number) => void

–

Make each metric a tappable target (drill into the underlying detail). When set, every metric renders as a Pressable with a button role and a pressed affordance, so a tappable stat needs no hand-rolled Pressable.

testID

string

–

E2E hook forwarded to the root element.

style

LayoutStyle

–

Composition within a parent only, never a restyle hook and never a width: the parent layout container provides the bounds.