For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
/
144
Sponsor

Progress

A progress bar whose fill is a pure function of a numeric value.

0%
Customize

Installation

$ pnpm dlx shadcn@latest add @framecn/progress

Usage

import { Progress } from "@/components/ui/progress";
<Progress value={62} showLabel width={320} />

Smooth transitions

The docs preview fills the bar from 0 → 62, stalls as if waiting on a slow operation, then resumes to 100 via useProgressTransition:

import { Progress } from "@/components/framecn/progress";
import { useProgressTransition } from "@/components/framecn/use-progress-transition";
 
const progressStyle = useProgressTransition([
  { at: 0, value: 0 },
  { at: 40, value: 62, duration: 36 },
  { at: 130, value: 100, duration: 30 },
]);
 
<Progress style={progressStyle} showLabel width={320} />;

style takes precedence over value when both are provided.

API Reference

Progress

PropTypeDefault
valuenumber0
styleProgressStyle- (takes precedence over value)
widthnumber320
showLabelbooleanfalse
themePartial<FramecnTheme>-
classNamestring-