Skip to content

installation.md

Latest commit

 

History

History
100 lines (80 loc) · 2.47 KB

installation.md

File metadata and controls

100 lines (80 loc) · 2.47 KB
Raw

Installation

← Docs

Supported platforms

Platform Status Notes
iOS Supported Uses expo-blur for the morph header.
Android Supported Uses RN filter: [{ blur }] — see version note below.
Web Not supported Toastiva is built for native iOS and Android only.

Warning

Android blur requires React Native 0.76+ with the New Architecture (Fabric). The filter: [{ blur: ... }] style prop was added in RN 0.76 and only renders on Android when Fabric is enabled. On RN < 0.76, or with the legacy renderer, filter is silently ignored on Android — the toast still works, but without the blurred morph header. iOS is unaffected (it uses expo-blur).

Expo

Install the native peers with Expo so Reanimated and Worklets stay on versions supported by your SDK.

npx expo install \
  react-native-gesture-handler \
  react-native-reanimated \
  react-native-worklets \
  react-native-safe-area-context \
  react-native-svg \
  expo-blur

npm install toastiva

Bare React Native

npm install toastiva \
  react-native-gesture-handler \
  react-native-reanimated \
  react-native-safe-area-context \
  react-native-svg \
  expo-blur

Follow each library's native install steps (pod install on iOS, Reanimated Babel plugin, etc).

Reanimated & Worklets

If you use Reanimated 4, install the react-native-worklets version required by your Reanimated version.

Reanimated Worklets
4.2.x 0.7.x
4.3.x 0.8.x

Peer dependencies

react>= 18
react-native>= 0.72
react-native-gesture-handler>= 2
react-native-reanimated>= 3 < 5
react-native-safe-area-context>= 4
react-native-svg>= 13
expo-blur>= 14

Next: Usage →