Navigation
Stepper
Shows a person’s current position and progress through an ordered multi-step flow.
01
See it and copy it
Framework example
Choose Astro, React, or Elements to compare native usage against the shared visual output. Each example assumes the framework-level setup is already complete.
- 1AccountYour profile is ready
- 2WorkspaceChoose how your team works
- 3ReviewConfirm and finish setup
Framework usage
Switch targets to compare the adapter code. The preview stays visually stable because all three packages share the same tokens andui-* class contract.---
import { Stepper } from '@santi020k/lumen-astro'
---
<Stepper
steps={[
{ title: 'Account', description: 'Your profile is ready' },
{ title: 'Workspace', description: 'Choose how your team works' },
{ title: 'Review', description: 'Confirm and finish setup' }
]}
currentStep={1}
/>import { Stepper } from '@santi020k/lumen-react'
export const Example = () => (
<>
<Stepper
steps={[
{ title: 'Account', description: 'Your profile is ready' },
{ title: 'Workspace', description: 'Choose how your team works' },
{ title: 'Review', description: 'Confirm and finish setup' }
]}
currentStep={1}
/>
</>
)<script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<lumen-stepper
steps={[
{ title: 'Account', description: 'Your profile is ready' },
{ title: 'Workspace', description: 'Choose how your team works' },
{ title: 'Review', description: 'Confirm and finish setup' }
]}
currentStep="1"></lumen-stepper>02
Choose your target
Add this component
Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.
pnpm add @santi020k/lumen-astropnpm add @santi020k/lumen-astrolumen add Stepperlumen add Stepperpnpm add @santi020k/lumen-reactpnpm add @santi020k/lumen-reactlumen add Stepper --target reactlumen add Stepper --target reactpnpm add @santi020k/lumen-elementspnpm add @santi020k/lumen-elementslumen add Stepper --target elementslumen add Stepper --target elementsAPI reference
Lumen-specific props and runtime attributes for the Astro primitive. React props follow the same names; Elements use equivalent kebab-case attributes where custom elements expose them.
| Attribute | Values | Default | Description |
|---|---|---|---|
| steps | Array<string | { label, description? }> | [] | Defines the ordered steps. |
| currentStep | number | 0 | Sets the zero-based active step. |
| orientation | "horizontal" | "vertical" | "horizontal" | Controls the step layout direction. |
| class, className | string | "" | Merges custom classes with the generated ui-* root classes. |
| ...native attributes | HTML attributes | - | Forwards standard attributes to the root element unless the component consumes them. |