Available · v0.3.1

Task progress

Show real work and verification as separate, honest progress stages.

Interactive example

Loading Polaris components…

Usage

<TaskProgress stages={[{id:"import",label:"Import profiles",completed:6,total:6},{id:"verify",label:"Verify access",completed:0,total:2}]} />

Properties

PropertyTypeDefaultDescription
stages{id,label,completed,total}[]RequiredActual saved operation and verification counts.
labelstringTask progressAccessible region description.

Design and interaction

Native s-progress adapter with separate actual saved-operation and native-verification stages. Runtime and installed Polaris 2 types verify these native controls. Do not estimate time or advance with a timer; completed operations do not imply access verification. Native atoms own track, fill, semantics and tone.

Accessibility

Each native progress exposes a label and actual numeric counts. Completion includes a native check icon. Native reduced-motion behavior is retained.

Implementation and ownership

Source: Kaupvik Website, packages/polaris. React client component; controlled host data. No API credentials or merchant transport are included. Host applications own authentication, validation, localization, errors and persisted preferences. Graph nodes use native Shopify identities; diagram positions are presentation only.

Tokens and states

Native controls use Shopify attributes and inherit the host’s design system. Kaupvik layout tokens: --kp-surface, --kp-surface-subdued, --kp-ink, --kp-ink-subdued, --kp-border, --kp-accent, --kp-focus, --kp-radius, --kp-space. Override only within the product surface. Loading, error and empty states are distinct; host data is never invented to fill a preview.

Verification

Test keyboard and pointer operation, focus visibility, 375px and desktop layouts, reduced motion and server hydration. Test every product adapter independently before release. QO remains on its reviewed implementation until its own adoption release.

Related product patterns