App components / Progress steps
Steps
Progress through a task done in order. Finished steps fill orange with a tick, the current step wears an orange ring with its number in mono, and the line between them fills as people move on. Horizontal for wizards, vertical for checklists with detail.
Code
The component itself, ready to drop into your project. Switch between React, Vue and plain HTML; every version uses the same Tailwind classes on Ochre's tokens.
- Account
- Workspace
- Invite team
- Done
Installation
Examples
Vertical
A getting-started checklist with a line of detail per step.
- Connect your dataPostgres connected 4 minutes ago.
- Build your first chartPick a table and a measure.
- Share a dashboardInvite people or post a link in Slack.
- Set an alertHear about changes before your customers do.
In a wizard
Back and Continue move the steps; finished steps are clickable.
Step 2 of 3
- BillingCard or invoice
- ReviewCheck and confirm
Wizard header
Steps 1 to 4 of a set-up flow; Continue fills the next segment.
Step 2 of 4
- Plan, done
- Workspace, current
- Invite team, to do
- Review, to do
Workspace
Name it and pick where your data lives.
Segment stepper
Compact bars above an editor. Click any segment to visit it.
Content
Campaign NW-118 · draft saved 2 minutes ago
Motion
Built on Ochre's ease-out curves. With reduced motion switched on, everything still works, it just doesn't move.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| steps | Step[] | – | { title, description? } in order. |
| current | number | – | Index of the step in progress; earlier steps show as done. Use steps.length when all are done. |
| orientation | "horizontal" | "vertical" | "horizontal" | Horizontal hides the titles on phones and keeps the markers. |
| onStepClick | (index: number) => void | – | Makes finished steps buttons so people can go back. |
| WizardHeader | { steps: ReactNode[], current, description?, action? } | – | Top of a multi-step flow: STEP 2 OF 4, a segment per step and the step title. In Vue: variant="wizard". |
| SegmentStepper | { steps: string[], current, onStepClick? } | – | Compact bars with mono numbers for forms and editors; onStepClick lets people visit any step. In Vue: variant="segments". |
| StepCount | { current, total } | – | STEP 2 OF 4 in mono capitals, on its own. |
Usage
Use it for
- Sign-up, onboarding and set-up flows of three to six steps.
- Vertical steps for a getting-started checklist where each step needs a line of explanation.
- Let people click back to finished steps; never skip ahead.
Avoid
- Steps for sections people can visit in any order: use Tabs.
- More than six steps in a row: group them or split the flow.