Progress

Usage

import { Progress } from "@devvy-ui/react";

<Progress label="Uploading files" value={42} />
<Progress label="Connecting" />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
label	string	required	Accessible name of the task.
value	number	omitted	Finite values clamp to 0..max. Omit for indeterminate progress.
max	number	100	Positive finite maximum; invalid values fall back to 100.
size	sm \| md \| lg	md	Track thickness.
tone	brand \| neutral	brand	Fill color.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add progress

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Progress.tsxREACT / TSX

import { forwardRef, type ProgressHTMLAttributes } from 'react';
import { cx } from '../lib/cx';

export interface ProgressProps
  extends Omit<ProgressHTMLAttributes<HTMLProgressElement>, 'value' | 'max'> {
  /** Accessible name for the task being measured. */
  label: string;
  /** Omit for indeterminate progress. Finite values are clamped to 0..max. */
  value?: number;
  max?: number;
  size?: 'sm' | 'md' | 'lg';
  tone?: 'brand' | 'neutral';
}

export const Progress = forwardRef<HTMLProgressElement, ProgressProps>(function Progress(
  { className, label, value, max = 100, size = 'md', tone = 'brand', ...props },
  ref,
) {
  const limit = Number.isFinite(max) && max > 0 ? max : 100;
  const current =
    value !== undefined && Number.isFinite(value) ? Math.min(limit, Math.max(0, value)) : undefined;
  return (
    <progress
      aria-label={label}
      {...props}
      ref={ref}
      className={cx('dvy-progress', className)}
      max={limit}
      value={current}
      data-size={size}
      data-tone={tone}
    />
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.