Data Point
Gives users an at-a-glance view of an important piece of information. Useful for overview pages or as a summary of what’s in a larger dataset like a table. A title and value are always shown together — title first. An optional visual indicator (badge or progress bar) can be added to communicate change or progress.
preview
props
| Prop | Type | Default | Description |
|---|---|---|---|
title | string | required | Label displayed above the value. Always shown first — do not reverse the order. |
value | string | required | The primary data value shown prominently. Accepts any string — numbers, currency, percentages, or short text. |
visualIndicator | ReactNode | — | Optional visual indicator rendered below the value. Pass a Badge or ProgressBar component. Omit to hide. |
usage
Data points work best in groups of two or more on overview or dashboard pages. They provide a scannable summary at a glance — if the user needs more detail, the data point should live on a surface that reveals it rather than navigating away.
When to use
- On overview or dashboard pages to give users a headline view of key metrics
- As a summary alongside a larger dataset — e.g. totals above a table
- When the value updates over time and the trend matters to the user
- Inside an interactive card that reveals a tooltip or drawer with more detail
Do not use
- With value before title — title must always precede the value
- As a navigation link that takes the user to a separate screen
- In isolation for a value that needs a chart, table, or full breakdown to be meaningful
- For binary states — use a badge or status indicator on its own instead
content
The title should always be a single word. It acts as a label for the value — keep it short and direct so the value stays the focal point. When you need more precision, put that detail in the value itself or in the visual indicator rather than stretching the title into a phrase.
visual indicators
An optional visual indicator sits below the value and adds context about trend or progress. Use a badge when the value has a directional change; use a progress bar when the value represents a portion of a whole.
placement
Data points can be arranged in their own individual cards or grouped inside a single card and separated by vertical dividers. Placement is flexible — match the layout to the density and hierarchy of the surrounding screen.