Usage Meter
Freev1.0.0Usage against a plan limit, split by who used it, with a projection.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { UsageMeter } from "@/components/ui/notchset/usage-meter";
const byAgent = [
{ label: "Planner", value: 6.4, tone: "ink" as const },
{ label: "Triage", value: 3.1, tone: "muted" as const },
{ label: "Verifier", value: 2.2, tone: "edge" as const },
];
export function TokenBudget() {
return <UsageMeter label="TOKENS · SEP" segments={byAgent} limit={15} projection={15.5} />;
}Props
segments–{ label, value, tone }[]Who used what; tone is ink, muted or edge.
limit / unit–number / stringThe plan and its unit.
dots–numberDefault 60; each is limit / dots.
projection–numberThe end-of-cycle estimate: draws the marker.
note / noteSignal–ReactNode / booleanThe line under the legend.
Anatomy
- No primitive needed: one file serves both builds.
- Each dot takes the tone of the segment holding its midpoint.
- Free capacity shows as rule rings.
UsageMeterdata-slot="usage-meter"The meter.
Source
components/ui/notchset/usage-meter.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/usage-meter.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/usage-meter.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/usage-meter.tsx
- lib/beautiful-ui/notchset/calendar.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- A plan's usage by contributor, with where it's heading
Use something else when
- One value with no breakdown: use Progress
Mistakes to avoid
- Keep segments to three: tones must stay distinct
Agents find it by
- usage meter, quota, plan usage, token usage, billing meter, limit, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/usage-meter.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- —
- Not focusable: it reports state; your controls take focus
Accessibility
- A meter with value text (used of limit, and the projection)
- The note is announced when it changes
Motion
- Change
- Dots refill in a ripple: 220ms each, 9ms apart
- Projection
- The marker moves (620ms glide) and turns signal over the limit
- Numbers
- The total and legend roll, ones digit first
Responsive
- The strip scales to its container (SVG viewBox).
Performance
- One SVG of 60 circles; CSS transitions.
Changelog
v1.0.0 · 2026-10-02
First release
