Rounded arcs over a grey track: one ring per item, a single gauge against a goal, or parts stacked along a half circle.
Rings
One ring per item against max, first item innermost. Hover a ring, or focus its tile and use the arrow keys, to highlight it and swap the headline.
Hours logged this month
490 h
+5.2% vs previous period| Item | Value | Of full ring |
|---|---|---|
| Fernway | 64 h | 32% |
| Northwind | 98 h | 49% |
| Halo Coffee | 142 h | 71% |
| Denzing | 186 h | 93% |
Installation
Copies the component into src/design-system/ as your own source, with only the files it needs.
npx avesk-ui@latest add radial-chart-cardBrings the 8 files it builds on (chart.tsx, badge.tsx, dropdown-menu.tsx, button.tsx, glyph.tsx, icon.tsx, floating.tsx, segmented-control.tsx). The first time, it also adds the tokens and the cn() helper, imports the tokens in globals.css and installs clsx and tailwind-merge. Files already in your project are kept unless you add --force.
Import
Lives in src/design-system/components/radial-chart-card.tsx.
import { RadialChartCard } from "@/design-system/components/radial-chart-card";Usage
<RadialChartCard
title="Revenue goal 2026"
variant="gauge"
max={600000}
format={(n) => formatMoney(n)}
centerLabel="of $600K goal"
data={[{ label: "Invoiced", value: 497800, color: "green" }]}
/>Examples
Gauge
variant="gauge" shows one value against a goal with the percentage in the centre.
Revenue goal 2026
$497,800
+18.2% vs this time last year| Item | Value | Of full ring |
|---|---|---|
| Invoiced | $497,800 | 83% |
Half gauge of parts
variant="half" stacks the items along a half circle; the centre shows the first item's share, or the hovered one's. invertChange makes a fall read as good news.
Invoices
57
-4% overdue vs last month| Item | Value | Share |
|---|---|---|
| Paid | 42 | 74% |
| Due | 11 | 19% |
| Overdue | 4 | 7% |
When to use
Use it when
- Progress against a goal: revenue against this year's target (variant="gauge")
- A few items against the same ceiling: hours logged per project out of 200 (rings)
- Parts of a small whole: invoices paid, due and overdue (variant="half")
Don’t use it when
- More than 5 items → Bar list card
- A trend over time → Area chart card
Rules
- Rings: 2–5 items, first innermost; set `max` to the shared ceiling
- Gauge: one item and a `max`; say what the percentage is of in `centerLabel`
- Half: 2–4 parts in a meaningful order (paid, due, overdue); the centre shows the first part's share
- Tiles are the keyboard path to the rings and segments; keep footer="tiles" unless the card is purely decorative
Properties
RadialChartCard
| Prop | Type | Default |
|---|---|---|
title * | string | – |
data * | RadialItem[] | – |
max | number | – |
variant | "rings" | "gauge" | "half" | "rings" |
value | string | – |
change | number | – |
changeLabel | string | "vs previous period" |
invertChange | boolean | false |
period | ChartPeriod | – |
format | NumberFormat | formatNumber |
centerLabel | string | – |
footer | "tiles" | "none" | "tiles" |
height | number | – |
headingLevel | 2 | 3 | 4 | 3 |
className | string | – |
* required
Accessibility
- The SVG has role="img" and an aria-label summary; a visually hidden table lists every value
- The tiles are the keyboard path: one Tab stop, arrows move, Home/End jump, Escape clears; focusing a tile highlights its ring or segment and swaps the headline
- Every swatch sits next to a label and a value, so colour is never the only key
- The sweep animation only runs without prefers-reduced-motion