NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4028 most downloaded on npm
Native navigation primitives for your React Native app.
Last release 2 days ago
01 Oct 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
679 releases · first in 2018
Patch release addressing an issue with building a package due to the missing submodule from postinstall command.
Patch release addressing an issue with building a package due to the missing submodule from postinstall command.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.30.0...3.30.1
Older versions may still continue to work with this and newer releases of react-native-screens, but bugs from deprecated versions will not be consider…
Minor release including custom screen transitions, adding support for VisionOS, supporting slide_from_left animation on iOS and fixing other aspects (including wrong targets for touchable components on Fabric).
Thanks for following along! 💙
Note: Please note that support for React Native versions lower than 0.68 have been dropped. Older versions may still continue to work with this and newer releases of react-native-screens, but bugs from deprecated versions will not be considered for repair.
Custom screen transitions - In 3.30.0, we've introduced a support for custom transition animations while making a "go back" gesture. Made by @piaskowyk and @WoLewicki in https://github.com/software-mansion/react-native-screens/pull/1913
Support for VisionOS is here! - From now, react-native-screens offers bundled support for VisionOS platform. Made by @okwasniewski in https://github.com/software-mansion/react-native-screens/pull/2025
slide_from_left transition on iOS - You can use slide_from_left animation that will be used for pushing or popping a new screen. Made by @kirillzyusko in https://github.com/software-mansion/react-native-screens/pull/2057
Add cancelSearch command on SearchBar by @Jasonzj in https://github.com/software-mansion/react-native-screens/pull/1987
Fixed Android screen stack animation by @janicduplessis in https://github.com/software-mansion/react-native-screens/pull/2019
runOnUiQueueThread on 0.73 with Bridgeless by @cortinico in https://github.com/software-mansion/react-native-screens/pull/2022display for _viewConfig attribute by @WoLewicki and @tboba in https://github.com/software-mansion/react-native-screens/pull/2071goBackGesture screen transition by @piaskowyk in https://github.com/software-mansion/react-native-screens/pull/2061goBackGesture by @piaskowyk in https://github.com/software-mansion/react-native-screens/pull/2060headerBackButtonClicked event by @WoLewicki in https://github.com/software-mansion/react-native-screens/pull/2015Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.29.0...3.30.0
One column per quarter.
Minor release including fix for iOS that was accidentally omitted from 3.28.0. It should be now possible to present modal in outer stack, from modal i
Minor release including fix for iOS that was accidentally omitted from 3.28.0. It should be now possible to present modal in outer stack, from modal in nested stack (😄 )
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.28.0...3.29.0
Minor release adding a support for React Native 0.73, adding new iOS-like slide animation, fixing crashes with AVPlayer on iOS and resolving build iss
Minor release adding a support for React Native 0.73, adding new iOS-like slide animation, fixing crashes with AVPlayer on iOS and resolving build issues on Android.
Note: Please note that when using new renderer - Fabric, only the 0.73.x version of react-native is supported from this version onwards. With Paper renderer backward compatibility is maintained.
traverseForScrollView method by @tboba in https://github.com/software-mansion/react-native-screens/pull/1969Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.27.0...3.28.0
Minor release focusing on resolving build issues in certain configurations, compatibility with RC versions of React Native and crash on Fabric.
Minor release focusing on resolving build issues in certain configurations, compatibility with RC versions of React Native and crash on Fabric.
canCoalesce method to RNSHeaderHeightChangeEvent by @tboba in https://github.com/software-mansion/react-native-screens/pull/1933@babel/traverse from 7.21.0 to 7.23.2 by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1929react-devtools-core from 4.28.0 to 4.28.4 by @tboba in https://github.com/software-mansion/react-native-screens/pull/1941Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.26.0...3.27.0
Migrate from deprecated RCTEventEmitter by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1867
Minor release adding new useAnimatedHeaderHeight and useReanimatedHeaderHeight hooks, providing fixes for search bar and introducing internal changes. Please note that new hooks introduced in this release are fully functional on Paper, on Fabric there are few edge cases we are still working on.
headerConfig prop on Android by @tboba in https://github.com/software-mansion/react-native-screens/pull/1883RCTEventEmitter by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1867require syntax for resolution of all native components by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1909npx expo install by @GabrieldosSantosOliveira in https://github.com/software-mansion/react-native-screens/pull/1899Example app & e2e tests to RN 0.72.4 by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1880Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.25.0...3.26.0
Minor release focused on bug fixes & internals.
Minor release focused on bug fixes & internals.
RNSScreenView#finalizeUpdates by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1855sheetCornerRadius by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1863PlatformColor instead of plain string for color related props by @retyui in https://github.com/software-mansion/react-native-screens/pull/1846replaceSystemWindowInsets to Builder.setSystemWindowInsets by @kirillzyusko in https://github.com/software-mansion/react-native-screens/pull/1868Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.24.0...3.25.0
Minor release focused on fixing build issues reported in #1859.
Minor release focused on fixing build issues reported in #1859.
toggleCancelButton search bar command by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1854sheetExpandsWhenScrollingToEdge prop as iOS specific by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1851Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.23.0...3.24.0
Headerheight incorrect on phones with dynamic island by @dylancom in https://github.com/software-mansion/react-native-screens/pull/1784
useHeaderHeight hook by @tboba in https://github.com/software-mansion/react-native-screens/pull/1844tough-cookie and semver dependencies by @tboba in https://github.com/software-mansion/react-native-screens/pull/1823word-wrap by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1834Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.22.1...3.23.0
Patch release bringing back old behaviour of formSheet modal on iOS when using @react-navigation/native-stack.
Patch release bringing back old behaviour of formSheet modal on iOS when using @react-navigation/native-stack.
InnerScreen by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1811Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.22.0...3.22.1
Minor release fixing some build issues that could happen on older Xcode versions & with Android SDK 34.
Minor release fixing some build issues that could happen on older Xcode versions & with Android SDK 34.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.21.1...3.22.0
Patch release adding internal isNewBackTitleImplementation constant for use in @react-navigation/native-stack.
Patch release adding internal isNewBackTitleImplementation constant for use in @react-navigation/native-stack.
See #1791 & https://github.com/react-navigation/react-navigation/pull/11423 for details.
…from this version. It might be considered a BREAKING CHANGE so be careful with updating.
Minor release with support for React Native 0.72 on New Architecture, fixing some bugs and adding new functionalities.
Please note that support for react-navigation v4 has been dropped with this version and you can no longer use native-stack v4 starting from this version. It might be considered a BREAKING CHANGE so be careful with updating.
Example by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1681compileSdk < 33 by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1723onCreate in example apps by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1736setText command on SearchBar by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1739Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.20.0...3.21.0
Minior release aimed at fixing #1686 (change of default behaviour for stackPresentation: 'formSheet').
Minior release aimed at fixing #1686 (change of default behaviour for stackPresentation: 'formSheet').
No other changes were introduced with this release. Next "feature" release is in preparation.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.19.0...3.20.0
Minor release with support for React Native 0.71
Minor release with support for React Native 0.71
Important: Since this version, Fabric is only supported for React Native 0.71+. Support for older versions has beed dropped.
react-native.config.js by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1624Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.18.2...3.19.0
Patch release fixing regression on old architecture introduced in 3.18.1.
Patch release fixing regression on old architecture introduced in 3.18.1.
See #1614 & #1615 for details.
Patch release fixing #1608 as library configuration for @react-native-cli was not present in previously released version.
Patch release fixing #1608 as library configuration for @react-native-cli was not present in previously released version.
react-native.config.js to npm package by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1611Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.18.0...3.18.1
Minor release focusing on Fabric autolinking, small fixes, support for React Native 0.70 and some internal changes 🎉
Minor release focusing on Fabric autolinking, small fixes, support for React Native 0.70 and some internal changes 🎉
Important: Since this version, Fabric is only supported for React Native 0.70+. Support for older versions has beed dropped. See #1594.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.17.0...3.18.0
Minor release fixing bugs, including #1565 🎉
Minor release fixing bugs, including #1565 🎉
:raised_hands: Thank you for your contributions!
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.16.0...3.17.0
Minor release fixing cooperation of gesture recognisers & modals, fixing bugs and adding some new features 🎉
Minor release fixing cooperation of gesture recognisers & modals, fixing bugs and adding some new features 🎉
:raised_hands: Thank you for your contributions!
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.15.0...3.16.0
Minor release focused mostly on resolving issues with gesture recognition and its integration with ScrollView on iOS (Fabric & Paper)
Minor release focused mostly on resolving issues with gesture recognition and its integration with ScrollView on iOS (Fabric & Paper)
UIGestureRecognizerDelegate API for older iOS versions by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1516:raised_hands: Thank you for your contributions!
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.14.1...3.15.0
Patch release fixing bug which caused gestureResponseDistance Screen prop to not work properly, when the component was not created via react-native-sc
Patch release fixing bug which caused gestureResponseDistance Screen prop to not work properly, when the component was not created via react-native-screens native stack. See: https://github.com/software-mansion/react-native-screens/pull/1507 for changes.
Minor release fixing bugs, introducing better support for Fabric (iOS), compatibility with react-native 0.69
Minor release fixing bugs, introducing better support for Fabric (iOS), compatibility with react-native 0.69
Moreover, from this release forward, Fabric is supported only for react-native 0.69+. Support for 0.68.x is dropped.
hideHeaderIfNecessary for Fabric by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1491fullScreenSwipeEnabled (1) by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1362stackPresentation & stackAnimation (4) by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1365onFinishTransitioning event for ScreenStack for Fabric by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1471onTransitionProgress event for Screen for Fabric by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1472FullWindowOverlay component for Fabric by @kkafar in https://github.com/software-mansion/react-native-screens/pull/1495:raised_hands: Thank you for your contributions!
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/3.13.1...3.14.0
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1351 that suppresses Function components cannot be given refs. Atte
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1351 that suppresses Function components cannot be given refs. Attempts to access this ref will fail warning on Fabric architecture.
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
This minor release includes initial support for Fabric architecture 🎉
This minor release includes initial support for Fabric architecture 🎉
To learn about what we've achieved so far check out our Introducing Fabric to React Native Screens blog post.
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1313 that fixes incorrect swipe direction default.
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1313 that fixes incorrect swipe direction default.
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1245 that removes the use of jcenter() in the library
Patch release adding https://github.com/software-mansion/react-native-screens/pull/1245 that removes the use of jcenter() in the library
Patch release adding #1233 for usage in Expo SDK.
Patch release adding #1233 for usage in Expo SDK.
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
For library authors, #1148 may be considered a *BREAKING CHANGE*. From now on you'll need to implement your own logic for the hardware back button on…
Minor release with important bug fixes 🎉
For library authors, #1148 may be considered a BREAKING CHANGE. From now on you'll need to implement your own logic for the hardware back button on Android same as it is done in react-navigation.
:raised_hands: Thank you for your contributions!
Patch release adding #1127 for usage in Expo SDK.
Patch release adding #1127 for usage in Expo SDK.
Patch release adding #1119 for usage in Expo SDK.
Patch release adding #1119 for usage in Expo SDK.
Be aware that #801 may be considered a BREAKING CHANGE if you relied on the default header back button native dismissal. It can be switched by setting…
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Be aware that #801 may be considered a BREAKING CHANGE if you relied on the default header back button native dismissal. It can be switched by setting nativeBackButtonDismissalEnabled: true on the screen.
Also, be aware that using fullScreenSwipeEnabled option (#1072) with gestureEnabled set to true will cancel JS recognizers on the screen when using vertical or horizontal swipe gestures.
:raised_hands: Thank you for your contributions!
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
slide_from_bottom & fade_from_bottom animations (#848) by @itsjgf, @kacperkapusciak and @WoLewicki:raised_hands: Thank you for your contributions!
Deprecate appear event (#949) by @kacperkapusciak
Minor release fixing bugs, improving typings, and adding some functionalities 🎉
:raised_hands: Thank you for your contributions!
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
Be aware that #821 may be considered a *BREAKING CHANGE* since it slightly changes how headerShown prop works. We discourage changing headerShown prop…
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Be aware that #821 may be considered a BREAKING CHANGE since it slightly changes how headerShown prop works.
We discourage changing headerShown prop directly in the navigator's screenOptions. We suggest changing it for a specific screen in options prop. Keep in mind that headers in modals aren't shown by default.
:raised_hands: Thank you for your contributions!
Patch release fixing issues with react-native-windows. See this issue #885 and this pull request #886 for more information. Thanks to @prupipho for he
Patch release fixing issues with react-native-windows. See this issue #885 and this pull request #886 for more information.
Thanks to @prupipho for help with debugging the problem and @WoLewicki for help with fixing it 🙌
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
This release is considered to be a BREAKING CHANGE.
This release makes react-native-screens enabled by default. You no longer need to call enableScreens() at the top of your application 🎉
This release also improves react-native-screens web implementation (index.tsx) to properly resolve activityState.
In v3.0.0, we drop support for react-native versions 0.60 and 0.61.
This release is considered to be a BREAKING CHANGE.
Patch release transforming the library to TypeScript. See https://github.com/software-mansion/react-native-screens/pull/793 and https://github.com/sof
Patch release transforming the library to TypeScript. See https://github.com/software-mansion/react-native-screens/pull/793 and https://github.com/software-mansion/react-native-screens/pull/794 for more information.
Replace deprecated API (#768) by @sunzhongliangde
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
Patch release fixing regression introduced by not excluding example projects from the bob typescript build. See #790 for more information.
Patch release fixing regression introduced by not excluding example projects from the bob typescript build. See #790 for more information.
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
Patch release fixing regression introduced in #648.
Patch release fixing regression introduced in #648.
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
Patch release adding #714 on top of 2.15.1 for usage in a patch version of Expo SDK 40.
Patch release adding #714 on top of 2.15.1 for usage in a patch version of Expo SDK 40.
Patch release adding #712 and #772 on top of 2.15.0 for usage in a patch version of Expo sdk 40.
Patch release adding #712 and #772 on top of 2.15.0 for usage in a patch version of Expo sdk 40.
Be aware that #705 is a BREAKING CHANGE since it removes useScreens method.
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Change screens resolving logic (#698) by @WoLewicki
useScreens and outdated code (#705) by @WoLewickiBe aware that #705 is a BREAKING CHANGE since it removes useScreens method.
:raised_hands: Thank you for your contributions!
Minor release introducing #624, which changes the native logic used in react-navigation's stack, bottom-tabs, and drawer navigators. :tada:
Minor release introducing #624, which changes the native logic used in react-navigation's stack, bottom-tabs, and drawer navigators. :tada:
This change introduces:
react-native-screens per navigator with detachInactiveScreens propdetachPreviousScreen propYou can check the changes on the side of react-navigation in https://github.com/react-navigation/react-navigation/pull/8805 and the documentation of the new props in https://reactnavigation.org/.
Be aware that #689 may be considered a BREAKING CHANGE since it changes how the large title looks.
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Be aware that #689 may be considered a BREAKING CHANGE since it changes how the large title looks.
:raised_hands: Thank you for your contributions!
Replace deprecated useSafeArea with useSafeAreaInsets in example (#637) by @JB1905
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
:raised_hands: Thank you for your contributions!
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
Minor release fixing bugs, improving typings, and adding some functionalities. 🎉
AppContainer to modal screens (#614) by @WoLewickiScrollView behavior on transitioning between screens (#594) by @WoLewicki:raised_hands: Thank you for your contributions!
Patch release fixing regression introduced in #584.
Patch release fixing regression introduced in #584.
Minor release fixing bugs, improving typings, and adding some functionalities, from which the biggest one is navigation events (#499). :tada:
Minor release fixing bugs, improving typings, and adding some functionalities, from which the biggest one is navigation events (#499). :tada:
:raised_hands: Thank you all for your contributions!
It also adds #545 by @brentvatne, which introduces additional padding to the header, which is a BREAKING CHANGE and will cause the header to have too…
Minor release adding the compilation of the files before publishing #517 by @satya164, changing the company logo #537 by @jakub-gonet and clarification of README by @brentvatne.
It also adds #545 by @brentvatne, which introduces additional padding to the header, which is a BREAKING CHANGE and will cause the header to have too much top padding in case of not having a translucent status bar.
There are two ways to handle it:
Your coding agent can read these notes before it upgrades. Set up the MCP server →