Sextant
← Catalog
Block · dynamic

Pulse Gauge

Concentric activity rings showing progress to goal, each with a softly breathing tip. Endless, calm motion that always renders its true value — a live read on how today is tracking.

State
Size
Mode

Acme · Q2 2026 KPI pulse

98%

1 of 3 goals hit

  • ARR 98%
  • Onboarding 104%
  • Sales pipeline 65%

ARR at 98% of goal — 1 of 3 rings closed; Sales pipeline trails at 65%.

Acme · Q2 2026 KPI pulse — progress to goal
RingValueGoal%
ARR4.84.998%
Onboarding104100104%
Sales pipeline6510065%

Acme analytics · updated hourly

Demo data is illustrative. Replace with your own typed data prop.

Use it with your data

Data contract

Passed via the data prop — an object: validated at runtime, so a bad shape degrades to the error state rather than crashing.

FieldTypeRequired
ringsarrayyes

Static props

import { ChartPulseGauge } from "@/components/blocks/chart-pulse-gauge/chart-pulse-gauge";

<ChartPulseGauge data={myData} />

Client fetch (SWR)

const { data, isLoading, error } = useSWR("/api/metric", fetcher);
// route isLoading/error through <ChartStates>, then:
<ChartPulseGauge data={data} />

Server component (RSC)

const data = await fetch(url, {
  next: { revalidate: 3600 },
}).then((r) => r.json());

<ChartPulseGauge data={data} />

Map arbitrary rows

import { mapRows } from "@/lib/sextant/column-map";

const out = mapRows(rows, { /* contractKey: "yourColumn" */ }, dataSchema);
if (out.ok) <ChartPulseGauge data={out.data} />;

Make it yours

Every customization below is an optional prop — omit them all and you get the defaults shown above. Recolor, reformat, restyle, or drop the card chrome without forking the component.

Recolor or rename a series (ring)

<ChartPulseGauge
  series={{ ring: { color: "var(--chart-3)", label: "…" } }}
/>

Format numbers (currency / locale)

const eur = new Intl.NumberFormat("de-DE", {
  style: "currency",
  currency: "EUR",
  notation: "compact",
});

<ChartPulseGauge valueFormatter={(n) => eur.format(n)} />

Replace or hide the narrative

<ChartPulseGauge narrative="Your own one-liner." />

// …or hide it entirely:
<ChartPulseGauge narrative={false} />

Restyle any region

<ChartPulseGauge
  className="max-w-xl"
  classNames={{ body: "bg-muted/20" }}
/>

Drop the card chrome (headless plot)

import { ChartPulseGaugePlot } from "@/components/blocks/chart-pulse-gauge/chart-pulse-gauge";

// Just the chart body — bring your own card/layout:
<ChartPulseGaugePlot data={data} config={config} />