Installation | Screen Transitions

Requirements

The current release requires:

React 19.2 or later
Reanimated 4
Worklets 0.8 or later
React Navigation 7.3 or later
Gesture Handler 2.16.1 or later

Expo Router support currently requires Expo Router 56.2.10 or later and is marked Alpha. See Expo Router before using it in production.

Install the package

npm install react-native-screen-transitions

Install peer dependencies

For Expo projects:

npx expo install @react-navigation/native react-native-gesture-handler \
  react-native-reanimated react-native-safe-area-context react-native-worklets

For bare React Native projects:

npm install @react-navigation/native react-native-gesture-handler react-native-reanimated react-native-safe-area-context react-native-worklets

Follow the Reanimated and Gesture Handler setup instructions for your React Native version. Bare iOS projects must also install pods after changing native dependencies. Expo Router apps already install Expo Router as part of their app setup.

Continue with React Navigation or the Alpha Expo Router integration.

Optional packages

Install @react-native-masked-view/masked-view when using navigation masks or library-managed zoom masking:

npm install @react-native-masked-view/masked-view

Boundary teleportation uses react-native-teleport:

npm install react-native-teleport@1.2.0