Skip to content
DocsChartsBulletLast updated Nov 2, 2026

Bullet

Each number against its target. Sample data: four quarter-to-date measures, revenue $428K of $500K, orders 6,120 of 7,000.

Open in
Q3 goalsQ3 goals, actual against target: revenue $428K of $500K, orders 6,120 of 7,000, avg order $70 of $68, repeat buyers 31% of 35%.RevenueUSD$428KOF $500KOrdersCOUNT6,120OF 7,000Avg orderUSD$70OF $68Repeat buyersSHARE31%OF 35%ACTUALTARGETRANGES
Q3 goals
GoalUnitActualTarget
RevenueUsd$428K$500K
OrdersCount6,1207,000
Avg orderUsd$70$68
Repeat buyersShare31%35%
Q3 goalsQ3 goals, actual against target: revenue $428K of $500K, orders 6,120 of 7,000, avg order $70 of $68, repeat buyers 31% of 35%.RevenueUSD$428KOF $500KOrdersCOUNT6,120OF 7,000Avg orderUSD$70OF $68Repeat buyersSHARE31%OF 35%ACTUALTARGETRANGES
Q3 goals
GoalUnitActualTarget
RevenueUsd$428K$500K
OrdersCount6,1207,000
Avg orderUsd$70$68
Repeat buyersShare31%35%

Installation

  1. 1

    Set up the registry once

    This chart is free in Hearth and MIT licensed: no token. Add @chartory to components.json once (the URL alone, no headers), or skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Bullet component to your project.

    npx shadcn add @chartory/bullet
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { Bullet }  from "@/components/chartory/bullet"<Bullet  data={quarterKpis}  size="m"  legend/>

Props

<Bullet>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.BulletDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
legend: Shows the legend row under the plot.booleantrue
color: The data colour of the primary marks (data/primary)."cat-1" | "cat-2" | "cat-3" | "cat-4""cat-1"

BulletData

The data prop: one object for the whole chart.

PropTypeDefault
rows: One entry per row.BulletRow[]Required
labelW?: The width of the label column, in px.number112
valueW?: The width of the value column, in px.number56

BulletRow

One object per entry in rows.

PropTypeDefault
label: The name shown on the chart.stringRequired
sub: The second line under the label.stringRequired
v: The value.numberRequired
target: The target value.numberRequired
max: The top of the value scale.numberRequired
bands: The range ends, low to high.number[]Required
text: The label as shown.stringRequired
ttext: The target's label.stringRequired

The data as a JSON Schema: schemas/bullet.json

Bullet chart: a React and Figma chart in four sizes

What does a bullet chart show?

A bullet chart shows a measure as a bar, its target as a tick and poor-to-good ranges as bands behind. Several bullets stack into one compact card. Use it for revenue, orders and rates you track against a plan.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Bullet component?

It is one <Bullet> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is actual, target and ranges per measure.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Does each measure have a target? Yes means the bullet fits.
  • Are there several measures? Yes means the bullet fits.
  • Do the ranges matter? Yes means the bullet fits.

When does another type fit better?

  • No target, just amounts. Use Horizontal bars instead.
  • One measure, one ring. Use Progress ring instead.
  • Only the share of a limit. Use Limit tracks instead.

Bullet chart questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.