KPI counter
A row of KPI cards whose numbers spring into view, with delta badges and self-drawing sparklines.
Preview
Resize it, switch the theme, replay the entrance — or read the source.
Installation
Add the block to a project that already uses shadcn/ui.
npx shadcn@latest add https://prequelui.terravidhal.me/r/kpi-counter.jsonRequires a project that already uses shadcn/ui on React and Tailwind CSS v4. The block is copied into your project as a single file you own and can edit.
Usage
Import the named export and render it with your own data.
Every prop is optional and ships with deterministic demo data, so a bare render shows the block at its default. Pass props to plug in your own data and formatters.
import { KpiCounter } from "@/components/prequel/kpi-counter/kpi-counter";
export default function DashboardPage() {
return <KpiCounter />;
}import { KpiCounter } from "@/components/prequel/kpi-counter/kpi-counter";
export default function DashboardPage() {
return <KpiCounter />;
}Props
Every prop is optional and ships with demo-data defaults.
| Prop | Type | Description |
|---|---|---|
className | string | Extra classes merged onto the root element. |
items | KpiCounterItem[] | — |
formatValue | (value: number, item: KpiCounterItem) => string | — |
Accessibility
The rules every PrequelUI block follows, verified against this block's source.
Charts and graphics expose a text summary via role="img" and an aria-label describing the data.
Interactive charts respond to arrow keys, Home and End, and show tooltips on keyboard focus.
Every button carries a visible focus ring so keyboard users can always see where they are.
The block honours prefers-reduced-motion: animations are skipped and content is fully visible.
Live updates run on timers inside effects and pause when the block is off-screen or hovered.