# Meter

> A HeroUI meter for visualizing a value within a range — storage, usage, progress toward a goal. Built on react-aria with an accessible label and formatted output. Supports accent/success/warning/danger colors, sm/md/lg sizes, an optional label, custom min/max, currency and percent formatting, and threshold-driven colors.

- Author: [Hero Ui](https://21st.dev/@hero_ui)
- License: mit
- Tags: Meter, Progress, Gauge
- npm dependencies: @heroui/react, @heroui/styles
- Live preview: https://21st.dev/@hero_ui/components/heroui-meter

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/hero_ui/heroui-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/meter.md