When to use it

Use CheckoutStepper when the purchase flow spans several distinct stages and the customer benefits from seeing progress and back-navigation context.

Composition notes

Pass a stable steps array with completed, active, and upcoming statuses. Only completed steps become clickable, so onStepClick should map back to safe earlier points in the flow.

Use durable step ids that match your router or checkout state machine so the click handler can send customers back to the exact stage you expect. The component is clearest with three to five steps. If your internal flow is more detailed than that, group smaller steps under broader customer-facing labels.

Behavior and theming guidance

Keep labels short so the stepper stays readable on smaller screens. The component already shifts emphasis across step states, so focus on feeding it accurate flow state rather than restyling the internal markers.

On smaller screens the labels are hidden and the numbered markers carry most of the context. Put the stepper close to the page heading or step title so customers do not lose orientation when only the markers remain visible.