{"id":40997561,"url":"https://github.com/gfazioli/mantine-select-stepper","last_synced_at":"2026-04-05T12:01:08.028Z","repository":{"id":333996738,"uuid":"1134393925","full_name":"gfazioli/mantine-select-stepper","owner":"gfazioli","description":"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.","archived":false,"fork":false,"pushed_at":"2026-03-17T18:28:32.000Z","size":16660,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-24T12:46:17.254Z","etag":null,"topics":["component","form","mantine","mantine-ui","nextjs","reactjs","reactjs-components","select","select-stepper","stepper","typescript"],"latest_commit_sha":null,"homepage":"https://gfazioli.github.io/mantine-select-stepper/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gfazioli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["gfazioli"]}},"created_at":"2026-01-14T16:54:41.000Z","updated_at":"2026-03-17T18:28:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gfazioli/mantine-select-stepper","commit_stats":null,"previous_names":["gfazioli/mantine-select-stepper"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/gfazioli/mantine-select-stepper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfazioli%2Fmantine-select-stepper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfazioli%2Fmantine-select-stepper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfazioli%2Fmantine-select-stepper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfazioli%2Fmantine-select-stepper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gfazioli","download_url":"https://codeload.github.com/gfazioli/mantine-select-stepper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfazioli%2Fmantine-select-stepper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31431454,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T08:13:15.228Z","status":"ssl_error","status_checked_at":"2026-04-05T08:13:11.839Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["component","form","mantine","mantine-ui","nextjs","reactjs","reactjs-components","select","select-stepper","stepper","typescript"],"created_at":"2026-01-22T08:15:10.661Z","updated_at":"2026-04-05T12:01:07.992Z","avatar_url":"https://github.com/gfazioli.png","language":"TypeScript","funding_links":["https://github.com/sponsors/gfazioli","https://github.com/sponsors/gfazioli?o=esc"],"categories":[],"sub_categories":[],"readme":"# Mantine SelectStepper Component\n\n\u003cimg alt=\"Mantine SelectStepper\" src=\"https://github.com/gfazioli/mantine-select-stepper/blob/master/logo.jpeg\" /\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n  [![NPM version](https://img.shields.io/npm/v/%40gfazioli%2Fmantine-select-stepper?style=for-the-badge)](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)\n  [![NPM Downloads](https://img.shields.io/npm/dm/%40gfazioli%2Fmantine-select-stepper?style=for-the-badge)](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)\n  [![NPM Downloads](https://img.shields.io/npm/dy/%40gfazioli%2Fmantine-select-stepper?style=for-the-badge\u0026label=%20\u0026color=f90)](https://www.npmjs.com/package/@gfazioli/mantine-select-stepper)\n  ![NPM License](https://img.shields.io/npm/l/%40gfazioli%2Fmantine-select-stepper?style=for-the-badge)\n\n---\n\n[\u003ckbd\u003e \u003cbr/\u003e ❤️ If this component has been useful to you or your team, please consider becoming a sponsor \u003cbr/\u003e \u003c/kbd\u003e](https://github.com/sponsors/gfazioli?o=esc)\n\n\u003c/div\u003e\n\n## Overview\n\nThis component is created on top of the [Mantine](https://mantine.dev/) library.\nIt requires **Mantine 9.x** and **React 19**.\n\nThe [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.\n\n\u003e [!note]\n\u003e\n\u003e → [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/)\n\n## Key Features\n\n- **Swipe/Touch gestures** — native pointer events for mobile navigation\n- **Vertical orientation** — render as a vertical stepper with up/down arrows\n- **Imperative API** — `controlRef` with `next()`, `prev()`, `reset()`, `navigateTo()` methods\n- **Size prop** — control ActionIcon size (`xs` through `xl`)\n- **Animation callbacks** — `onStepStart` and `onStepEnd` for transition synchronization\n- **Gradient variant** — gradient-styled navigation buttons\n- **Full keyboard navigation** — Arrow keys with automatic disabled item skipping\n- **Loop mode** — infinite cycling through options\n- **Styles API** — full Mantine Styles API integration with 10 style targets\n- **Responsive props** — `viewWidth`, `viewHeight`, `size`, `orientation` adapt to breakpoints via Mantine's `StyleProp`\n- **Accessible** — ARIA `spinbutton` role, live regions, labeled buttons\n\n## Installation\n\n```sh\nnpm install @gfazioli/mantine-select-stepper\n```\nor\n\n```sh\nyarn add @gfazioli/mantine-select-stepper\n```\n\nAfter installation import package styles at the root of your application:\n\n```tsx\nimport '@gfazioli/mantine-select-stepper/styles.css';\n```\n\nYou can also import styles within a CSS layer:\n\n```tsx\nimport '@gfazioli/mantine-select-stepper/styles.layer.css';\n```\n\n## Usage\n\n```tsx\nimport { SelectStepper } from '@gfazioli/mantine-select-stepper';\n\nfunction Demo() {\n  return \u003cSelectStepper data={['React', 'Vue', 'Angular']} /\u003e;\n}\n```\n\n## Imperative API\n\n```tsx\nimport { useRef } from 'react';\nimport { SelectStepper, type SelectStepperRef } from '@gfazioli/mantine-select-stepper';\n\nfunction Demo() {\n  const controlRef = useRef\u003cSelectStepperRef\u003e(null);\n\n  return (\n    \u003c\u003e\n      \u003cSelectStepper\n        controlRef={controlRef}\n        data={['React', 'Vue', 'Angular']}\n      /\u003e\n      \u003cbutton onClick={() =\u003e controlRef.current?.next()}\u003eNext\u003c/button\u003e\n      \u003cbutton onClick={() =\u003e controlRef.current?.reset()}\u003eReset\u003c/button\u003e\n    \u003c/\u003e\n  );\n}\n```\n\n## Sponsor\n\n\u003cdiv align=\"center\"\u003e\n\n[\u003ckbd\u003e \u003cbr/\u003e ❤️ If this component has been useful to you or your team, please consider becoming a sponsor \u003cbr/\u003e \u003c/kbd\u003e](https://github.com/sponsors/gfazioli?o=esc)\n\n\u003c/div\u003e\n\nYour support helps me:\n\n- Keep the project actively maintained with timely bug fixes and security updates\n- Add new features, improve performance, and refine the developer experience\n- Expand test coverage and documentation for smoother adoption\n- Ensure long‑term sustainability without relying on ad hoc free time\n- Prioritize community requests and roadmap items that matter most\n\nOpen 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.\n\nYour help truly matters.\n\n💚 [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.\n\n---\n\n[![Star History Chart](https://api.star-history.com/svg?repos=gfazioli/mantine-select-stepper\u0026type=Timeline)](https://www.star-history.com/#gfazioli/mantine-select-stepper\u0026Timeline)\n\n---\n\nhttps://github.com/user-attachments/assets/d430dd46-2da5-46e3-8dcd-73f666f8c6fe\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfazioli%2Fmantine-select-stepper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgfazioli%2Fmantine-select-stepper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfazioli%2Fmantine-select-stepper/lists"}