Getting Started
Installation
Install @ncrft/native-toast and its peer dependencies.
Install the package
pnpm add @ncrft/native-toastnpm install @ncrft/native-toastyarn add @ncrft/native-toastPeer dependencies
NativeToast relies on two peer dependencies that are standard in most Expo / React Native projects:
| Package | Minimum version | Purpose |
|---|---|---|
react-native-svg | >= 13.0.0 | Animated SVG icons (success checkmark, error X-mark) |
react-native-safe-area-context | >= 4.0.0 | Safe area inset handling for notch / status bar avoidance |
If you created your project with expo install, these are likely already present. You can verify with npx expo install react-native-svg react-native-safe-area-context.
Install peer dependencies (if missing)
pnpm add react-native-svg react-native-safe-area-contextnpm install react-native-svg react-native-safe-area-contextyarn add react-native-svg react-native-safe-area-contextExpo compatibility
NativeToast is tested against Expo SDK 54 (react-native@0.81). It should work on any React Native 0.81+ project.
No react-native-reanimated or react-native-gesture-handler setup is required — the library uses only built-in Animated and PanResponder APIs.