Horizontal flow funnel: every stage is a column sized to its share of the first, easing into the next, with a percentage pill and stage tiles.
Proposal funnel
Each column is its share of the first stage and eases into the next. Hover or focus a stage (arrow keys move) to dim the rest and read its step conversion; the menu swaps the period.
Proposals
64
+8.3% vs previous period| Stage | Count | Share of Sent | From previous step |
|---|---|---|---|
| Sent | 64 | 100% | – |
| Viewed | 52 | 81% | 81% |
| Replied | 31 | 48% | 60% |
| Accepted | 18 | 28% | 58% |
- Sent64
- Viewed52
- Replied31
- Accepted18
Installation
Copies the component into src/design-system/ as your own source, with only the files it needs.
npx avesk-ui@latest add funnel-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/funnel-chart-card.tsx.
import { FunnelChartCard } from "@/design-system/components/funnel-chart-card";Usage
<FunnelChartCard
title="Proposals"
stages={[
{ label: "Sent", value: 64 },
{ label: "Viewed", value: 52 },
{ label: "Replied", value: 31 },
{ label: "Accepted", value: 18 },
]}
change={0.083}
/>Examples
Sharp shape and a legend
shape="sharp" draws plain trapezoids; stage colours can be set one by one; footer="legend" keeps the card short.
New business
120
| Stage | Count | Share of Enquiries | From previous step |
|---|---|---|---|
| Enquiries | 120 | 100% | – |
| Calls | 54 | 45% | 45% |
| Proposals | 30 | 25% | 56% |
| Won | 12 | 10% | 40% |
- Enquiries120
- Calls54
- Proposals30
- Won12
When to use
Use it when
- Steps people or items drop out of: proposals sent → viewed → replied → accepted
- New-business pipeline: enquiries → calls → proposals → won
Don’t use it when
- Parts of a whole with no order → Radial chart card
- A ranking → Bar list card
Rules
- 3–6 stages, top of the funnel first; labels of one or two words
- The pill shows each stage's share of the first; the tooltip adds the step conversion
- shape="sharp" for a plainer look; colours cycle the chart order unless a stage sets one
Properties
FunnelChartCard
| Prop | Type | Default |
|---|---|---|
title * | string | – |
stages * | FunnelStage[] | – |
shape | "smooth" | "sharp" | "smooth" |
value | string | – |
change | number | – |
changeLabel | string | "vs previous period" |
invertChange | boolean | false |
period | ChartPeriod | – |
format | NumberFormat | formatNumber |
footer | "tiles" | "legend" | "none" | "tiles" |
height | number | 160 |
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
- Every period or item is a focusable target with one Tab stop: arrows move, Home/End jump, Escape hides the tooltip; its aria-label reads the values
- The tooltip and headline follow hover and focus alike; meaning never relies on colour (labels and values sit next to every swatch)
- The draw-in animation only runs without prefers-reduced-motion