Usage MeterProv1.0.0
Usage against a limit as a strip of dots, each a share of the plan, filled by whoever used it; changes ripple across, a projection marker turns signal past the limit, and every number rolls.
Live preview
Installation
pnpm dlx shadcn@latest add @beautiful-ui-pro/usage-meterNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
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.
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.
Source
components/ui/notchset/usage-meter.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
