Blocks / KPI row

KPI row

Key figures side by side: label, figure, change and trend, in glued cells.

import { KpiRow } from "@forgeron/ui";
/01 → Default
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>
  );
}
/02 → Dashboard
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>
  );
}
/03 → Absolute change
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
PropTypeDefaultDescription
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) => stringsigned percentWrites a delta, for a change that is not a ratio: +3 tickets.
classNamestring—Extra classes.