Introduction
Patine UI is a React Native component library for iOS, Android and the web, from one codebase. It covers the basics, such as buttons, inputs, cards and alerts, and the parts that take weeks to build well: date ranges, calendars, searchable selects, wheels, bottom sheets and menus.
It's 100% JavaScript with zero dependencies, so it runs unchanged in Expo Go, bare React Native and React Native Web, with no Tailwind, Babel or Metro setup. The names and props follow shadcn/ui and Radix, so if you or your AI agent know those, you already know this.
- npm
- yarn
- pnpm
- Expo
npm install patine-ui
yarn add patine-ui
pnpm add patine-ui
npx expo install patine-ui
There's no pod install, no rebuild and no config plugin.
<Card style={{ maxWidth: 380 }}> <CardHeader> <CardTitle>Pick a day</CardTitle> </CardHeader> <CardContent> <DatePicker value={date} onValueChange={setDate} minDate={new Date()} /> </CardContent> <CardFooter> <Button>Book</Button> </CardFooter> </Card>
Edit the code and the result updates instantly. Each example is a complete file you can copy into your app as-is, imports included.
What's included
Every component is listed in the sidebar, grouped as in the library:
- Foundations: Text & Heading, Stack, Separator
- Actions: Button, DropdownMenu, ActionSheet
- Inputs: Checkbox, Switch, RadioGroup, SegmentedControl, ChipGroup, Select, SelectList, Slider, Rating, InputOTP, PhoneField
- Date & time: DatePicker with ranges, DateWheelPicker, MonthPicker, WeekStrip, ExpandableCalendar, TimePicker with time ranges, DurationPicker, DateTimePicker
- Pickers: WheelPicker, MultiWheelPicker, CountryPicker, LanguagePicker, TimeZonePicker, EmojiPicker, ColorPicker
- Overlays: BottomSheet, picker sheets and picker fields
- Display: Card, Avatar, Badge
- Feedback: Alert, Skeleton
Why this library
- One codebase. The same components and props on iOS, Android and the web, with keyboard, focus, hover and screen readers working on each.
- Finished on day one. Every platform gets the Patine design by default, and each platform's behaviour. Set
design="native"onPatineProviderand each gets its own: iOS, Material 3 or the web. - Nothing to configure. No native code and no dependencies, so it works in Expo Go and ships in OTA updates.
- Familiar API. shadcn's names and props:
variant,size,checked+onCheckedChange,value+onValueChange, and composable parts likeCard+CardHeader. - Yours to customize. Light and dark themes follow the OS. Override any token (colors, radius, spacing, type) for the app or one component, style any part through
styles, and replace rows, days or triggers with render props. - Accessible. Roles, labels and states on every component, 44pt touch targets, a keyboard focus ring on the web, and animations that stop when the OS asks to reduce motion.
- International. Month, weekday and AM/PM names, the 12/24-hour clock, the first day of the week and the date order come from
Intl. Layouts flip for RTL. - Typed. Generics for value types and discriminated unions for selection modes, so
mode="range"gives you a typed{ start, end }.
Requirements
| Version | |
|---|---|
react | >= 18 |
react-native | >= 0.72 |
| Expo | Any SDK (works in Expo Go) |
react-native-web | Supported |
No other peer dependencies: no Reanimated, no Gesture Handler, no SVG.
Where to next
- Installation: install and optional setup
- Quick start: a first screen in five minutes
- Core concepts: controlled vs uncontrolled, sheets and drafts, designs, theming, slots
- Designs: the Patine design, the iOS, Material and web looks, and how to pick one
- Examples: real app screens built from the components, live on iOS, Android and the web
- API reference: every export in one page