UI Components

Progress

Animated progress bar with label, value display, four color variants, and three size options

Quick Preview

Uploading...72%

Installation

// Copy the Progress component from
src/components/ui/Progress.tsx

Usage

import { Progress } from '@/components/ui/Progress'

// Basic
<Progress value={50} />

// With label and value display
<Progress
  value={75}
  label="Profile completion"
  showValue
  variant="success"
/>

Examples

Color Variants

Default (primary)80%

Success65%

Warning45%

Danger30%

Sizes

Small60%

Medium60%

Large60%

Skill Bars — Real-world Usage

TypeScript90%

React85%

Node.js70%

Python55%

Animated (Loading State)

Processing...

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a ui component named Progress in React/Next.js.
Goal: recreate the same overall UI and behavior as the Progress reference from a component gallery.
What it needs to communicate: Animated progress bar with label, value display, four color variants, and three size options.

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- value: number — required — Current progress value
- max: number — default 100 — Maximum value
- variant: "default" | "success" | "warning" | "danger" — default "default" — Color variant
- size: "sm" | "md" | "lg" — default "md" — Bar height
- label: string — Label text shown above the bar
- showValue: boolean — Show percentage value above the bar
- animated: boolean — Adds pulse animation to the fill

Reference usage patterns:
- Basic

```tsx
<Progress value={65} />
```

- With label

```tsx
<Progress value={75} label="Upload" showValue variant="success" />
```

Feature expectations:
- Four color variants: default (primary), success, warning, danger
- Three size options (sm, md, lg)
- Optional label and percentage display
- Animated pulse option
- Clamps value between 0 and max
- role="progressbar" + aria attributes
- Server Component

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`value`*	`number`	-	Current progress value
`max`	`number`	`100`	Maximum value
`variant`	`"default" \| "success" \| "warning" \| "danger"`	`"default"`	Color variant
`size`	`"sm" \| "md" \| "lg"`	`"md"`	Bar height
`label`	`string`	-	Label text shown above the bar
`showValue`	`boolean`	-	Show percentage value above the bar
`animated`	`boolean`	-	Adds pulse animation to the fill

Features

✓Four color variants: default (primary), success, warning, danger
✓Three size options (sm, md, lg)
✓Optional label and percentage display
✓Animated pulse option
✓Clamps value between 0 and max
✓role="progressbar" + aria attributes
✓Server Component