Skip to main content

Installation

Install rn-iconify and its peer dependencies.

Requirements​

  • React Native 0.60.0+ (Old Architecture)
  • React Native 0.72.0+ (New Architecture / TurboModules)
  • iOS 13.0+
  • Android API 21+

npm​

npm install rn-iconify react-native-svg react-native-mmkv

yarn​

yarn add rn-iconify react-native-svg react-native-mmkv

pnpm​

pnpm add rn-iconify react-native-svg react-native-mmkv

iOS Setup​

After installing, run pod install:

cd ios && pod install

Android Setup​

No additional setup required! Android auto-links the native modules.

Expo​

For Expo projects, you need a development build (Expo Go is not supported due to native dependencies).

npx expo install rn-iconify react-native-svg react-native-mmkv

Then create a development build:

npx expo prebuild
npx expo run:ios
# or
npx expo run:android
Expo Go Not Supported

rn-iconify requires native modules (react-native-mmkv) that are not available in Expo Go. You must use a development build or bare workflow.

Peer Dependencies​

PackageVersionPurpose
react-native-svg≥13.0.0SVG rendering
react-native-mmkv≥3.0.0Fast native cache (JSI)

Verify Installation​

Create a simple test component:

import { Mdi } from 'rn-iconify';
import { View } from 'react-native';

export default function App() {
  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
      <Mdi name="check-circle" size={48} color="green" />
    </View>
  );
}

If you see a green checkmark, you're all set!

Troubleshooting​

iOS: "RNIconify" module not found​

Run pod install again:

cd ios && pod install --repo-update

Android: Build fails with MMKV​

Make sure you have the latest react-native-mmkv:

npm install react-native-mmkv@latest

Metro: Unable to resolve module​

Clear Metro cache:

npx react-native start --reset-cache

Next Steps​