# Billing Usage Meter

Control panel for resource and quota consumption on multi-tenant SaaS platforms.

- id: `billing-usage-meter`
- Page: https://agentic-ui-kit.com/components/billing-usage-meter
- Live preview: https://agentic-ui-kit.com/live/component/billing-usage-meter

## Install

```bash
agentic-ui add billing-usage-meter
npx shadcn@4.17.0 add @agentic-ui/billing-usage-meter
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** consumption-vs-limit, threshold-alerts, resource-meters, billing-cycle-tracking, spend-budget-progress, timeframe-switching, capacity-limit-adjustment, overage-policy-display, empty-state, error-recovery, keyboard-navigation
- **Intents:** track-status, monitor-live, explore-detail, configure
- **Suits domains:** billing, saas, finance, analytics, devtools
- **Interaction:** timeframe-switch, capacity-limit-adjustment, view-mode-toggle, alert-dismissal, notification-preferences-toggle, keyboard-navigation
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** control panel for resource and quota consumption on multi-tenant SaaS platforms, monitoring API usage limits, team seats and database storage, billing section and budget alerts with overage policies, subscription cycle summary and accumulated spend for developer consoles
- **Avoid when:** fixed flat-price billing with no volumetric metrics or quotas, purely statistical business metrics that do not determine limits or costs
- **Preserve when adapting:** meter-aria-contract, threshold-status-color-logic, billing-spend-budget-hierarchy, resource-metric-breakdown-layout
- **Replace when adapting:** billing-metrics-data, currency-and-quota-formatting, plan-tier-descriptions
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** alert, badge, button, card, progress, switch, tabs
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives