https://github.com/gfazioli/mantine-select-stepper
Mantine SelectStepper is a React component that allows users to navigate through a list of options using increment and decrement buttons, providing an intuitive alternative to traditional dropdown selects for cycling through predefined values.
https://github.com/gfazioli/mantine-select-stepper
component form mantine mantine-ui nextjs reactjs reactjs-components select select-stepper stepper typescript
Last synced: 3 months ago
JSON representation
Mantine SelectStepper is a React component that allows users to navigate through a list of options using increment and decrement buttons, providing an intuitive alternative to traditional dropdown selects for cycling through predefined values.
- Host: GitHub
- URL: https://github.com/gfazioli/mantine-select-stepper
- Owner: gfazioli
- License: mit
- Created: 2026-01-14T16:54:41.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-03-17T18:28:32.000Z (3 months ago)
- Last Synced: 2026-03-24T12:46:17.254Z (3 months ago)
- Topics: component, form, mantine, mantine-ui, nextjs, reactjs, reactjs-components, select, select-stepper, stepper, typescript
- Language: TypeScript
- Homepage: https://gfazioli.github.io/mantine-select-stepper/
- Size: 15.9 MB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Mantine SelectStepper Component
[](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 (
<>
controlRef.current?.next()}>Next
controlRef.current?.reset()}>Reset
>
);
}
```
## Sponsor
[
❤️ If this component has been useful to you or your team, please consider becoming a sponsor
](https://github.com/sponsors/gfazioli?o=esc)
Your support helps me:
- Keep the project actively maintained with timely bug fixes and security updates
- Add new features, improve performance, and refine the developer experience
- Expand test coverage and documentation for smoother adoption
- Ensure long‑term sustainability without relying on ad hoc free time
- Prioritize community requests and roadmap items that matter most
Open source thrives when those who benefit can give back—even a small monthly contribution makes a real difference. Sponsorships help cover maintenance time, infrastructure, and the countless invisible tasks that keep a project healthy.
Your help truly matters.
💚 [Become a sponsor](https://github.com/sponsors/gfazioli?o=esc) today and help me keep this project reliable, up‑to‑date, and growing for everyone.
---
[](https://www.star-history.com/#gfazioli/mantine-select-stepper&Timeline)
---
https://github.com/user-attachments/assets/d430dd46-2da5-46e3-8dcd-73f666f8c6fe