# Avatar Status Ring – Presence Ring that Animates Speaking Level, Upload Progress and Status Changes

> Avatar Status Ring for React and Tailwind CSS (shadcn/ui): presence drawn as a ring instead of a dot — solid online, dashed away, red busy, thicker with the voice level while speaking, filling clockwise while uploading. It is built to show what a person is doing right now, animating every change in colour, dash pattern and thickness. Controlled status, level and progress props, tone overrides, silhouette fallback, aria-label, reduced motion, light and dark, and a stacked group. Use it for call grids, chat headers, team lists and voice agents. The included demo scripts a speaker and an upload and makes no network requests. Requires React and lucide-react only, with no animation library.

- Author: [DHxWhy](https://21st.dev/@dhxwhy)
- License: mit
- Tags: Avatar, Status, Profile
- npm dependencies: lucide-react
- Live preview: https://21st.dev/@dhxwhy/components/avatar-status-ring

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/dhxwhy/avatar-status-ring?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/avatar.md