https://github.com/gfazioli/mantine-picker
A Mantine Picker extension
https://github.com/gfazioli/mantine-picker
component ios-picker mantine mantine-ui mantine-v7 picker reactjs typescript
Last synced: 23 days ago
JSON representation
A Mantine Picker extension
- Host: GitHub
- URL: https://github.com/gfazioli/mantine-picker
- Owner: gfazioli
- License: mit
- Created: 2025-03-20T17:10:12.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2026-02-02T06:44:01.000Z (about 1 month ago)
- Last Synced: 2026-02-13T18:42:32.354Z (27 days ago)
- Topics: component, ios-picker, mantine, mantine-ui, mantine-v7, picker, reactjs, typescript
- Language: TypeScript
- Homepage: https://gfazioli.github.io/mantine-picker/
- Size: 11.4 MB
- Stars: 10
- Watchers: 1
- Forks: 0
- 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 Picker Component
[](https://www.npmjs.com/package/@gfazioli/mantine-picker)
[](https://www.npmjs.com/package/@gfazioli/mantine-picker)
[](https://www.npmjs.com/package/@gfazioli/mantine-picker)
---
[
❤️ 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.
[Mantine Picker](https://gfazioli.github.io/mantine-picker/) is a versatile UI component for building iOS-like wheel pickers in React with Mantine, enabling selection through dragging, mouse wheel, clicking, and keyboard navigation. Developers can fully control state via value and onChange, or render bespoke item content with renderItem (e.g., color swatches, badges).
The component’s appearance and behavior are highly tunable: itemHeight, visibleItems, cylinderRadius, rotation (rotateY), blur/opacity/scale gradients, mask and highlight, dividers, loop, and animationDuration. Decorative sections (leftSection/rightSection) let you embed icons or labels that remain fixed while the list scrolls, and readOnly mode permits programmatic updates while preventing user changes—handy for counters and clocks.
Beyond simple lists like cities or months, the Picker supports composite inputs such as time and date pickers by composing multiple instances (hours, minutes, AM/PM; day, month, year) and synchronizing their values. Styling can be adapted with variants, size presets, uppercase transforms, gradients, and custom shadows, and global styles are imported once via the package’s CSS. Altogether, Mantine Picker offers a polished, customizable selection experience that integrates cleanly with Mantine layouts and components for production-ready pickers.
> [!note]
>
> → [Demo and Documentation](https://gfazioli.github.io/mantine-picker/) → [Youtube Video](https://www.youtube.com/playlist?list=PL85tTROKkZrWyqCcmNCdWajpx05-cTal4) → [More Mantine Components](https://mantine-extensions.vercel.app/)
## Installation
```sh
npm install @gfazioli/mantine-picker
```
or
```sh
yarn add @gfazioli/mantine-picker
```
After installation import package styles at the root of your application:
```tsx
import '@gfazioli/mantine-picker/styles.css';
```
## Usage
```tsx
import { Picker } from '@gfazioli/mantine-picker';
function Demo() {
return (
);
}
```
## 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://github.com/user-attachments/assets/520e4838-9f2f-4714-9de2-8067c7630d1d
---
[](https://www.star-history.com/#gfazioli/mantine-picker&Timeline)