# Progress bar

> The Progress Ring component is a modern, animated circular progress indicator designed for professional dashboards, SaaS products, and data visualization interfaces. Built with React, TypeScript, TailwindCSS, shadcn/ui, and Framer Motion, it combines accessibility, smooth motion, and theme adaptability into a single, production-ready UI element.  It features a background track and a foreground animated stroke that dynamically reflects percentage-based progress values (0–100). Using Framer Motion’s animation engine, the progress ring animates smoothly, giving users a visually intuitive representation of completion, utilization, or performance metrics.  The component is highly configurable—you can adjust size, stroke width, text styles, and labels—making it suitable for use across small inline widgets, large dashboard cards, or compact mobile layouts. The percentage value is displayed inside the ring with a bold numeric readout, and an optional label can be placed underneath for context (e.g., “Used Capacity,” “Project Completion,” or “Current Load”).  The design integrates seamlessly with light and dark themes, relying on shadcn’s CSS variables (--primary, --muted, --foreground) to ensure brand consistency and accessibility. It also includes ARIA attributes (role="progressbar", aria-valuenow, aria-label) for screen readers, making it fully inclusive.  Typical use cases include:  Storage Utilization (e.g., “75% of capacity used”)  Task or Project Completion (e.g., “92% completed”)  Performance Metrics (e.g., network load, CPU usage, sales goals)  Gamification / Achievements (e.g., progress toward a reward)  This component balances enterprise-level polish with developer-friendly flexibility, ensuring it can be reused and adapted in complex web applications where clarity and performance matter most.

- Author: [Sonu](https://21st.dev/@uniquesonu)
- License: unknown
- npm dependencies: framer-motion
- Live preview: https://21st.dev/@uniquesonu/components/progress-bar

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/uniquesonu/progress-bar?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