# Migration guide

## React Native / Expo: use `islamic-icons/native`

If you use this package in a React Native or Expo app, **always import from the `/native` subpath** so Metro bundles the uncompiled source and uses your app’s React instance (avoids “ReactCurrentDispatcher is undefined” and duplicate React errors).

**Before (can cause errors in RN):**
```tsx
import { MosqueIcon } from 'islamic-icons';
```

**After (correct for React Native / Expo):**
```tsx
import { MosqueIcon } from 'islamic-icons/native';
```

- **Web (Create React App, Vite, Next.js, etc.):** Keep using `'islamic-icons'` (default entry).
- **React Native / Expo:** Use `'islamic-icons/native'` and install the peer dependency:
  ```bash
  npm install react-native-svg
  ```

Same component names and props in both environments; only the import path changes by platform.