KPI row
Key figures side by side: label, figure, change and trend, in glued cells.
import { KpiRow } from "@forgeron/ui";- Revenue
- €48.2k
- up +12.4%
- Open tickets
- 37
- up +9%
import { KpiRow } from "@forgeron/ui";
export default function Default() {
return (
<div style={{ width: 380 }}>
<KpiRow
items={[
{
label: "Revenue",
value: "€48.2k",
delta: 0.124,
trend: [31, 33, 32, 36, 35, 39, 41, 40, 44, 48],
},
{
label: "Open tickets",
value: "37",
delta: 0.09,
better: "down",
trend: [30, 28, 31, 29, 33, 34, 32, 37],
},
]}
/>
</div>
);
}- Revenue
- €48,210
- up +12.4%vs last month
- New leads
- 212
- down −6%vs last month
- Win rate
- 31.4%
- unchanged ±0%vs last month
- Days to close
- 18
- down −14%median
import { KpiRow } from "@forgeron/ui";
export default function Dashboard() {
return (
<div style={{ width: "100%" }}>
<KpiRow
items={[
{
label: "Revenue",
value: "€48,210",
delta: 0.124,
hint: "vs last month",
trend: [31, 33, 32, 36, 35, 39, 41, 40, 44, 48],
},
{
label: "New leads",
value: "212",
delta: -0.06,
hint: "vs last month",
trend: [240, 236, 228, 231, 219, 224, 215, 212],
},
{
label: "Win rate",
value: "31.4%",
delta: 0,
hint: "vs last month",
},
{
label: "Days to close",
value: "18",
delta: -0.14,
better: "down",
hint: "median",
trend: [24, 23, 23, 21, 22, 20, 19, 18],
},
]}
/>
</div>
);
}- Deploys
- 64
- up +12this week
- Failed runs
- 3
- up +2this week
- Tools
- 21
- unchanged ±0installed
import { KpiRow } from "@forgeron/ui";
// A change that is not a ratio: formatDelta writes it.
export default function AbsoluteChange() {
return (
<div style={{ width: "100%", maxWidth: 560 }}>
<KpiRow
formatDelta={(d) => `${d > 0 ? "+" : d < 0 ? "−" : "±"}${Math.abs(d)}`}
items={[
{ label: "Deploys", value: "64", delta: 12, hint: "this week" },
{ label: "Failed runs", value: "3", delta: 2, better: "down", hint: "this week" },
{ label: "Tools", value: "21", delta: 0, hint: "installed" },
]}
/>
</div>
);
}API → Props
| Prop | Type | Default | Description |
|---|---|---|---|
items | { label, value, delta?, better?, hint?, trend? }[] | — | One cell each. delta is a ratio (0.12 reads +12%); better says which way is good news. |
formatDelta | (delta: number) => string | signed percent | Writes a delta, for a change that is not a ratio: +3 tickets. |
className | string | — | Extra classes. |