Installation
npm install react-native-platform-components
yarn add react-native-platform-components
iOS
cd ios
pod install
- Minimum iOS version: iOS 15.1+ (React Native sets this floor; the podspec follows it)
- Uses UIKit:
UIDatePicker,UIMenu,UIContextMenuInteraction,UITabBar,UIButtonand friends
Android
- Uses native Android Views with Material Design (including
PopupMenufor context menus) - Supports Material 3 styling
- Works with the default React Native and Expo AppCompat theme. To have the Material 3 components use your app's colors, see Android Theme Configuration
Web
With react-native-web, including Expo web, the components render the browser's own controls with the same props. No setup is needed; see Web.
Jest
The native views can't render under Jest. Mock the package with the interactive stand-ins it ships, in your Jest setup file:
jest.mock('react-native-platform-components', () =>
require('react-native-platform-components/jest')
);
See Testing with Jest for what each mock renders.
Expo (Managed Workflow)
Note: This library is not supported in Expo Go. It requires native code and must be used with Expo Dev Client or EAS Build.
npx expo install react-native-platform-components
npx expo prebuild
npx expo run:ios
# or
npx expo run:android
The library includes an Expo config plugin that handles all native configuration automatically. No manual native setup is required.
EAS Build:
eas build --platform ios
eas build --platform android
Config Plugin:
Add to your app.json. The android.theme option re-parents Expo's generated AppTheme onto Material 3, which SegmentedControl, TabBar, NavigationRail, Button, ButtonGroup, Chip, ChipGroup, Switch, Checkbox, RadioGroup, FloatingActionButton, FloatingToolbar, ActionSheet, Dialog and the material: 'm3' modes use for their colors (see Android Theme Configuration):
{
"expo": {
"plugins": [
[
"react-native-platform-components/app.plugin",
{ "android": { "theme": "material3" } }
]
]
}
}
Either form of the reference works: react-native-platform-components/app.plugin
as above, or the bare package name.
The android.drawables option copies vector drawables into the generated project at prebuild, so drawable icon names (icon={{ ios: 'house', android: 'home' }}) work as they do in a bare app. List .xml files or directories of them, relative to the project root; each drawable is named after its file (see Icons in Expo):
[
"react-native-platform-components/app.plugin",
{ "android": { "theme": "material3", "drawables": ["./assets/icons"] } }
]
For a complete working example, see the example-expo/ directory.
React Native New Architecture
This library is built for the React Native New Architecture (Fabric + TurboModules).
| Feature | Status |
|---|---|
| Fabric (New Renderer) | Supported |
| Codegen | Used for type-safe native bindings |
| TurboModules | Used for native theme updates |
| Old Architecture | Not supported |
Compatibility:
| Platform | Minimum |
|---|---|
| React Native | 0.81 with the New Architecture enabled |
| Expo SDK | 54, with a dev client or EAS Build (not Expo Go) |
| React | 19 |
| iOS | 15.1 (LiquidGlass needs iOS 26) |
| Android | API 24 (Android 7.0); Material Components 1.14 is bundled |
React Native 0.81 / Expo SDK 54 is the supported minimum. CI builds that combination with both Xcode 26 and Xcode 16.4; Liquid Glass is compiled out when the iOS 26 SDK is unavailable. Android is also built against React Native 0.76 in CI to check native compatibility below the supported minimum.
Requirements:
- New Architecture must be enabled in your app
- For bare React Native: set
newArchEnabled=trueingradle.properties(Android) and use theRCT_NEW_ARCH_ENABLEDflag (iOS) - For Expo: set
"newArchEnabled": trueinapp.json