# Usage Meter

> An animated allowance gauge that breaks total usage into categories against a plan limit, with a rolling number counter and a segmented progress bar that warns when nearing or over the limit.

- Author: [kuratlielia](https://21st.dev/@kuratlielia)
- Library: kuratlielia
- License: MIT
- Tags: Progress Bar, Storage, Quota, Billing
- npm dependencies: motion, lucide-react
- Live preview: https://21st.dev/@kuratlielia/components/usage-meter

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/kuratlielia/usage-meter?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/progress-bar.md