Skip to content
Mizen UI
Docs

IntroductionInstallationCLIStylingFoundationsThemingCompositionIntegrationsAccessibilityFor agents

useCopyToClipboard

AccordionAspect RatioCardCollapsibleFrameGridGroupInlineScroll AreaSectionSeparatorSpacerStack

BlockquoteCitationCodeHeadingKbdLabelLinkTextVisually Hidden

ButtonButton GroupToggleToggle groupToolbar

CalendarCheckboxCheckbox groupComboboxDate pickerDate range pickerDate-Time InputFieldFieldsetFile UploadFormInputInput groupNumber fieldOTP FieldRadio groupSelectSliderSwitchTextareaTime Input

BreadcrumbMenubarNavigation MenuPaginationSegmented ControlStepperTabs

Alert dialogCommandContext MenuDialogDrawerMenuPopoverPreview CardSheetTooltip

AlertBadgeEmptyError StateMeterProgressSkeletonSpinnerStatus dotToast

Activity FeedAvatarAvatar GroupData TableListMetricOverflow ListProperty ListTableTokenTree

Area ChartBar ListCalendar HeatmapCategory ComparisonChart FrameChart LegendChart TooltipDistributionFunnelHeatmapMetric TrendPart-to-WholeProgress RingsRadar ChartRadial BarsSankey ChartScatter ChartScore GaugeTime Series

Diagram

AttachmentCarouselCode BlockLightboxMarkdownThumbnailTimestamp

Agent ThinkingApproval CardComposerConversationInline CitationMessageMessage ScrollerQuestion CardSourcesStreaming TextSuggestionTask ListTerminalTool Call

On this page

  • Preview
  • Usage
  • Anatomy
  • Examples
  • Workspace export
  • Build processing
  • Archive transfer
  • Record sync
  • Recommendations
  • Usage boundaries
  • API reference

Feedback

Progress

Visualizes task completion progress or indeterminate background activity.

idle

Usage

import {
	Progress,
	ProgressIndicator,
	ProgressLabel,
	ProgressTrack,
	ProgressValue,
} from "@mizen-labs/ui";

Anatomy

The parts and how they nest, taken from the preview above.

<Progress>
	<ProgressLabel />
	<ProgressValue />
	<ProgressTrack>
		<ProgressIndicator />
	</ProgressTrack>
</Progress>

Examples

Workspace export

Build processing

Archive transfer

Record sync

Recommendations

GuidancePractice
Do

Name the operation and use actual completion data. Use an indeterminate state when progress cannot be measured.

Usage boundaries

GuidanceBoundary
Scope

Use Meter for bounded measurements. Do not invent percentages from elapsed time.

API reference

Public props from @mizen-labs/ui. Use exported prop types for the complete TypeScript contract.

PropTypeDefaultDescription
valuenumber | null—Current progress value between min and max, or null when indeterminate.
minnumber0Minimum value of the progress bar.
maxnumber100Maximum value of the progress bar.
formatIntl.NumberFormatOptions—Number format options passed to Intl.NumberFormat.
childrenReactNode—Optional children for composed anatomy; auto-renders track and indicator when omitted.
renderReactElement | RenderFunction—Composes progress behavior onto another element.
PreviousMeterNextSkeleton
Exporting workspace
65%
x

Northstar launch · Exporting documents and attachments

x

65 of 100 files prepared. Keep this workspace open until the export finishes.

Processing task
45%
x
Transfer volume
375 / 500 MB
x
Synchronizing records
x