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.
Latest stable
4.30.1
Last release 12 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
712 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
feat(Android): deprecate status/navigation bar edge to edge related props in native code by @kligarski in https://github.com/software-mansion/react-na…
Minor release focused on fixing bugs, especially with the formSheet presentation, introduction of pageSheet presentation on iOS and integration with react-native-edge-to-edge on Android.
[!note] Notable change is that for some time now we publish nightly builds. You can check them out by running
yarn install react-native-screens@nightly.
unstable_accessibilityContainerViewIsModal prop for FullWindowOverlay by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2854react-native-edge-to-edge by @zoontek in https://github.com/software-mansion/react-native-screens/pull/2464fitToContents sheet height react to dynamic content by @kligarski in https://github.com/software-mansion/react-native-screens/pull/2877gesture-handler is present by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2819useHeaderHeight does not report correct value after cancelling search by @maciekstosio in https://github.com/software-mansion/react-native-screens/pull/2817TouchableOpacity does not work on screens with headerTranslucent: true on notchless iOS devices with older OS versions by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2858ScreenStackHeaderSearchBarView invalid props type by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2881providers.exec to enable configuration-cache by @lukmccall in https://github.com/software-mansion/react-native-screens/pull/2903isTranslucent to ScreenFragmentWrapper & align method naming on Screen by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2818shouldUseCustomBackBarButtonItem flag by @maciekstosio in https://github.com/software-mansion/react-native-screens/pull/2867SearchBar code by renaming param by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2882HeaderConfig as ViewProps already include children by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2883RNS_IGNORE_SUPER_CALL_BEGIN by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2907Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.10.0...4.11.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This beta includes mostly tests, refactors & other internal improvements. Beside that it brings 3 important fixes for iOS.
This beta includes mostly tests, refactors & other internal improvements. Beside that it brings 3 important fixes for iOS.
unstable_accessibilityContainerViewIsModal prop for FullWindowOverlay by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2854TouchableOpacity does not work on screens with headerTranslucent: true on notchless iOS devices with older OS versions by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2858Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.11.0-beta.1...4.11.0-beta.2
fix(Android): drawing order for multiple disappearing screens by @kligarski in https://github.com/software-mansion/react-native-screens/pull/2806
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.11.0-beta.0...4.11.0-beta.1
feat(iOS): add pageSheet presentation for native-stack by @kligarski in https://github.com/software-mansion/react-native-screens/pull/2793
gesture-handler is present by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2819useHeaderHeight does not report correct value after cancelling search by @maciekstosio in https://github.com/software-mansion/react-native-screens/pull/2817isTranslucent to ScreenFragmentWrapper & align method naming on Screen by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2818Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.10.0...4.11.0-beta.0
Minor release adding support for formSheet + ScrollView + sticky header layout on iOS (requires specific view hierarchy to work, see: #2747). The rele
Minor release adding support for formSheet + ScrollView + sticky header layout on iOS (requires specific view hierarchy to work, see: #2747). The release includes also series of important fixes.
There are a lot of big internal changes in this release - we kindly ask you to report any bug issues and especially regressions we didn't catch.
Cheers!
Please note that this change only aligns the library with the behaviour of min. supported react-native version, which is 0.76 (old arch) and 0.77 (new arch). This should not affect your apps unless you're using older react-native version + custom patches.
setOptions by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2812sheetAllowedDetents value & apply appropriate styles by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2762formSheet not visible when going back from push in parent stack by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2767formSheet selected detent index after fragment reattachment by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2782formSheet presentation by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2788formSheet with fitToContents does not have correct height after goBack by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2789ScreenStack.onUpdate method by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2763Example by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2780notifyChildUpdated -> onChildUpdated by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2783RNSScreenStackHeaderConfig.updateViewController:withConfig:animated: by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2798Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.9.1...4.10.0
Another beta release focused on bugfixes. Stable version is expected by the end of the week in positive scenario.
Another beta release focused on bugfixes. Stable version is expected by the end of the week in positive scenario.
formSheet selected detent index after fragment reattachment by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2782Example by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2780notifyChildUpdated -> onChildUpdated by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2783Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.10.0-beta.2...4.10.0-beta.3
Changes relative to 4.10.0-beta.0.
Changes relative to 4.10.0-beta.0.
sheetAllowedDetents value & apply appropriate styles by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2762formSheet not visible when going back from push in parent stack by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2767ScreenStack.onUpdate method by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2763Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.10.0-beta.0...4.10.0-beta.2
Nothing published for this version
feat(iOS): add experimental support for scrollview header when using formsheet by @kkafar in https://github.com/software-mansion/react-native-screens/
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.9.1...4.10.0-beta.0
Nothing published for this version
4.9.0 has issue when building using USE_FRAMEWORKS=dynamic. This version should resolve these.
4.9.0 has issue when building using USE_FRAMEWORKS=dynamic. This version should resolve these.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.9.0...4.9.1
Minor release focused on bringing stable support for react-native 0.78.
Minor release focused on bringing stable support for react-native 0.78.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.8.0...4.9.0
Nothing published for this version
Support for 0.78, releasing this as beta yet, because it breaks backward compatibility for Paper - I hope to restore it before stable.
Support for 0.78, releasing this as beta yet, because it breaks backward compatibility for Paper - I hope to restore it before stable.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.8.0...4.9.0-beta.0
Fixup for 4.7.0 with unresolved import (when using frameworks) + 16 KB page size support on Android
Fixup for 4.7.0 with unresolved import (when using frameworks) + 16 KB page size support on Android
-Wdollar-in-identifier-extension compile time warning by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2707Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.7.0...4.8.0
Previous one was buggy, therefore this change is considered a fix rather than a breaking change.
Minor release focused on bugfixing.
In case you use formSheet stack presentation on Android this might change the hide animation of the sheet. Previous one was buggy, therefore this change is considered a fix rather than a breaking change.
fitToContents by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2670fitToContents includes small bottom padding on iOS by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2701Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.6.0...4.7.0
fix(Android): missing transition events with formSheet presentation by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2682
Changes relative to beta.3
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.7.0-beta.3...4.7.0-beta.4
fix: add missing files to whitelist in package.json by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2673
Follow up for beta.2
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.7.0-beta.2...4.7.0-beta.3
fix(Android): missing background color for formSheets on RN 0.77+ by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2660
Relative to 4.7.0-beta.1
fitToContents by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2670Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.7.0-beta.1...4.7.0-beta.2
Beta changing type of animation for form sheet on Android. See the PR #2542 for more details. Enabling this behaviour will most likely require to spec
Beta changing type of animation for form sheet on Android. See the PR #2542 for more details. Enabling this behaviour will most likely require to specify some animation prop on form sheet screen in stable 4.7.0, but currently it replaced the default.
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.6.0-beta.1...4.7.0-beta.1
Nothing published for this version
feat(Android): deprecate series of status/navigation bar related props by @kkafar in https://github.com/software-mansion/react-native-screens/pull/263…
Minor release providing few important fixes, including these for pressables on new architecture and FullWindowOverlay.
RCTMountingTransactionObserving implementation new-arch only by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2624react-native-vector-icons by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2621FabricEnabledHeaderSubviewGroup -> FabricEnabledHeaderSubviewViewGroup + fix arch-consistency check by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2622Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.5.0...4.6.0
feat(Android): deprecate series of status/navigation bar related props by @kkafar in https://github.com/software-mansion/react-native-screens/pull/263…
These changes are relative to beta.0
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.6.0-beta.0...4.6.0-beta.1
Beta releasing fix for pressables in native header #2466.
Beta releasing fix for pressables in native header #2466.
RCTMountingTransactionObserving implementation new-arch only by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2624react-native-vector-icons by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2621FabricEnabledHeaderSubviewGroup -> FabricEnabledHeaderSubviewViewGroup + fix arch-consistency check by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2622Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.5.0...4.6.0-beta.0
Minor release coming with support for react-native@0.77 and few minor bugfixes.
Minor release coming with support for react-native@0.77 and few minor bugfixes.
react-native@0.77 by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2581Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.4.0...4.5.0
Minor release landing series of important fixes. This version comes w/o support for react-native 0.77. You can expect the support with next minor, whi
Minor release landing series of important fixes. This version comes w/o support for react-native 0.77. You can expect the support with next minor, which should be shipped in the beginning of January before 0.77 release.
ios.componentProvider by @kkafar in https://github.com/software-mansion/react-native-screens/pull/2583ios.componentProvider to package.json by @jakex7 in https://github.com/software-mansion/react-native-screens/pull/2567Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.3.0...4.4.0
Another RC with important fixes. I aim to release stable version before 24.12.
Another RC with important fixes. I aim to release stable version before 24.12.
ios.componentProvider to package.json by @jakex7 in https://github.com/software-mansion/react-native-screens/pull/2567Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.4.0-rc.0...4.4.0-rc.1
Releasing minor's RC to allow for easier testing of important fixes
Releasing minor's RC to allow for easier testing of important fixes
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.3.0...4.4.0-rc.0
fix(Android): prevent crash with InsetsObserverProxy already registered by @kkafar in https://github.com/software-mansion/react-native-screens/pull/25
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.2.0...4.3.0
feat: add support for transparent large header on iOS by @EvanBacon in https://github.com/software-mansion/react-native-screens/pull/2501
Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.1.0...4.2.0
One column per quarter.