[](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)
[](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)
[](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)
---
[ ❤️ If this component has been useful to you or your team, please consider becoming a sponsor ](https://github.com/sponsors/gfazioli?o=esc)
## Overview
This component is created on top of the [Mantine](https://mantine.dev/) library.
It requires **Mantine 9.x** and **React 19**.
The [Mantine SelectStepper](https://gfazioli.github.io/mantine-select-stepper/) is a Mantine-based React component that provides an elegant way to select from a list of options through a stepper interface. Users can navigate forward and backward through items using action buttons, with support for keyboard navigation, infinite looping, disabled items, and smooth animations. Built with TypeScript and fully integrated with Mantine's Styles API, it offers extensive customization options including custom icons, animation timing, viewport width, and border styling.
> [!note]
>
> → [Demo and Documentation](https://gfazioli.github.io/mantine-select-stepper/) → [Youtube Video](https://www.youtube.com/playlist?list=PL85tTROKkZrWyqCcmNCdWajpx05-cTal4) → [More Mantine Components](https://mantine-extensions.vercel.app/)
## Key Features
- **Swipe/Touch gestures** — native pointer events for mobile navigation
- **Vertical orientation** — render as a vertical stepper with up/down arrows
- **Imperative API** — `controlRef` with `next()`, `prev()`, `reset()`, `navigateTo()` methods
- **Size prop** — control ActionIcon size (`xs` through `xl`)
- **Animation callbacks** — `onStepStart` and `onStepEnd` for transition synchronization
- **Gradient variant** — gradient-styled navigation buttons
- **Full keyboard navigation** — Arrow keys with automatic disabled item skipping
- **Loop mode** — infinite cycling through options
- **Styles API** — full Mantine Styles API integration with 10 style targets
- **Responsive props** — `viewWidth`, `viewHeight`, `size`, `orientation` adapt to breakpoints via Mantine's `StyleProp`
- **Accessible** — ARIA `spinbutton` role, live regions, labeled buttons
## Installation
```sh
npm install @gfazioli/mantine-select-stepper
```
or
```sh
yarn add @gfazioli/mantine-select-stepper
```
After installation import package styles at the root of your application:
```tsx
import '@gfazioli/mantine-select-stepper/styles.css';
```
You can also import styles within a CSS layer:
```tsx
import '@gfazioli/mantine-select-stepper/styles.layer.css';
```
## Usage
```tsx
import { SelectStepper } from '@gfazioli/mantine-select-stepper';
function Demo() {
return ;
}
```
## Imperative API
```tsx
import { useRef } from 'react';
import { SelectStepper, type SelectStepperRef } from '@gfazioli/mantine-select-stepper';
function Demo() {
const controlRef = useRef(null);
return (
<>
);
}
```
## Sponsor
