Progress

Displays an indicator showing the completion progress of a task, typically displayed as a progress bar.

Installation

CLI

Install the component using the StarUI CLI:

star add progress

Examples

With Label

Progress bar with a label and reactive percentage readout

Upload progress

Sizes

Height variants using Tailwind classes via cls

h-1
h-2
h-3
h-4

Reactive

Signal-driven progress bar with controls to update the value

Multi-Step Loading

Sequenced deployment pipeline with step labels [seq(), set_timeout, switch()]

API Reference

Props

Prop Type Default Description
value float | None None Initial value in the range [0, max_value]. When omitted with Signal object, uses Signal's initial value.
max_value float 100 Maximum value that represents 100%
signal str | Signal auto-generated Signal name or Signal object for reactive updates
cls str '' Additional CSS classes (e.g., 'h-1', 'h-3', 'h-4')