NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #4028 most downloaded on npm
Native navigation primitives for your React Native app.
Latest stable
4.30.1
Last release 11 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.
This is the first beta release of react-native-screens 5.0.0, and it adds support for react-native 0.88. iOS gets ContainedModalProvider and Contained
This is the first beta release of react-native-screens 5.0.0, and it adds support for react-native 0.88. iOS gets ContainedModalProvider and ContainedModalOverContent, a modal confined to the bounds of its provider, e.g. a SplitView column. Stack v5 on Android now animates transitions with configurable presets and supports replaceAnimation. On iOS 27, Stack v4 gains minimizationBehavior and restorationBehavior, and both stacks gain safeAreaAdjustment. Form sheets can replace the Liquid Glass material on iOS 26.1+, and Stack v4 form sheets get a selectDetent command. Fixes include a crash when popping an Android Stack v5 screen with a nested stack. Most of the Misc section splits the native code into core and react layers.
The templateSource and xcasset tab icon types are removed, and imageSource icons on iOS are now tinted by default (#4868):
| Before | After |
|---|---|
{ type: 'templateSource', templateSource: src } |
{ type: 'imageSource', imageSource: src, renderingMode: 'template' } |
{ type: 'xcasset', name: 'icon' } (image set) |
{ type: 'imageSource', imageSource: { uri: 'icon' } } |
{ type: 'xcasset', name: 'icon' } (custom symbol) |
{ type: 'sfSymbol', name: 'icon' } |
{ type: 'imageSource', imageSource: src } that must keep its colors |
add renderingMode: 'original' |
The TabsScreenIconTemplateIOS and TabsScreenIconXcassetIOS type exports are removed too, use TabsScreenIconIOS. See #4868 for the remaining migration details.
selectDetent command for form sheets by @Bram-dc in https://github.com/software-mansion/react-native-screens/pull/4794RNSNavigationItemCustomizerProtocol by @Ubax in https://github.com/software-mansion/react-native-screens/pull/5080minimizationBehavior and restorationBehavior to control when the navigation bar minimizes and restores on scroll in Stack v4 by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4729sheetBackgroundEffect prop for form sheets by @t0maboro in https://github.com/software-mansion/react-native-screens/pull/5007safeAreaAdjustment prop to control safe area adjustment when the navigation bar minimizes on iOS 27 by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4732slideFrom* + none presets by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4660replaceAnimation by @kligarski in https://github.com/software-mansion/react-native-screens/pull/5058safeAreaAdjustment prop to control safe area adjustment when the navigation bar minimizes on iOS 27 in Stack v5 by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4744backgroundEffect prop by @t0maboro in https://github.com/software-mansion/react-native-screens/pull/5111Full Changelog: https://github.com/software-mansion/react-native-screens/compare/5.0.0-alpha.4...5.0.0-beta.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Opaque headers (headerTransparent: false) aren't deprecated, but UIKit's support for them is getting worse:
This is the fourth alpha release of react-native-screens 5.0.0. Tabs on iOS 26.1+ now use the UITab API, which brings UISearchTab with automaticallyActivatesSearch, prominentScreenKey and tabBarSidebarPreferredPlacement for iOS 27, along with a series of fixes for tabs that overflow into More; both platforms also gain custom drawable / symbol tab-bar icons. Stack v5 header items on iOS get visibilityPriority, menuRepresentation, variant and disabled, and the navigation bar's minimization on scroll can now be controlled with minimizationBehavior and restorationBehavior. On Android, Stack v5 detaches covered screens so both screens animate during a transition and handles the direction prop, and fragment restoration is now R8-safe. Stack v4 on iOS 26+ lays out screens under an opaque navigation bar and gains unstable_safeAreaEdges, and the broken types published for tabs and the stack header config are fixed.
Starting with iOS 26, Apple recommends against custom navigation bar backgrounds. Bars are transparent by default and content is meant to extend under them - see WWDC25: Build a UIKit app with the new design. Opaque headers (headerTransparent: false) aren't deprecated, but UIKit's support for them is getting worse:
edgesForExtendedLayout (which we used to lay out the screen below an opaque header) doesn't position the screen correctly in landscape and in modals. We partially worked around this with a SafeAreaView (#3231).Pressables.[!TIP] We recommend following Apple's guidance and using a transparent header on iOS 26+.
tabBarSidebarPreferredPlacement prop to choose between sidebar and tab bar on iOS 27 by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4668direction prop and improve RTL collapsing header workaround by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4611visibilityPriority prop to header items by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4709visibilityPriority prop for header items by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4678menuRepresentation prop to header items by @kmichalikk in https://github.com/software-mansion/react-native-screens/pull/4587minimizationBehavior and restorationBehavior to control when the navigation bar minimizes and restores on scroll by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4703UISearchTab with automaticallyActivatesSearch prop by @kmichalikk in https://github.com/software-mansion/react-native-screens/pull/4679prominentScreenKey so a chosen tab stays visible when the tab bar minimizes by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4724unstable_safeAreaEdges prop by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4872explicitParentProvider to ColorSchemeCoordinator to ensure correct resolution during transition by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4634useHeaderHeight by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4734tabBarSidebarPreferredPlacement test to component integration tests by @Loloekk in https://github.com/software-mansion/react-native-screens/pull/4816Full Changelog: https://github.com/software-mansion/react-native-screens/compare/5.0.0-alpha.3...5.0.0-alpha.4
This is the third alpha release of react-native-screens 5.0.0, and it brings many new header customization options to Stack v5 on both Android and iOS
This is the third alpha release of react-native-screens 5.0.0, and it brings many new header customization options to Stack v5 on both Android and iOS, along with new features and a series of fixes for FormSheet v5 on Android. It also adds support for Swift Package Manager, as well as a number of stability fixes for Stack and Tabs.
contentInsetStart, contentInsetEnd for toolbar by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4516statusBarScrimColor for the header by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4533backButtonMenuEnabled prop for iOS header by @kmichalikk in https://github.com/software-mansion/react-native-screens/pull/4544prompt to stack header by @kmichalikk in https://github.com/software-mansion/react-native-screens/pull/4590hidesSharedBackground prop to header items by @kmichalikk in https://github.com/software-mansion/react-native-screens/pull/4592tabBarHiddenAnimationEnabled prop (#4627) by @ilcato in https://github.com/software-mansion/react-native-screens/pull/4632defaultRouteName type in TabsContainer by @kligarski in https://github.com/software-mansion/react-native-screens/pull/4541doOnStart callback by @t0maboro in https://github.com/software-mansion/react-native-screens/pull/4581RNSFormSheetConfigurationApplicator stateless by @t0maboro in https://github.com/software-mansion/react-native-screens/pull/4567SplitViewController from ReactEventEmitter & ShadowState by @t0maboro in https://github.com/software-mansion/react-native-screens/pull/4603Full Changelog: https://github.com/software-mansion/react-native-screens/compare/5.0.0-alpha.2...5.0.0-alpha.3
This is the second alpha release of react-native-screens 5.0.0. A major part of this release involved migrating the iOS Split Navigation implementatio
This is the second alpha release of react-native-screens 5.0.0. A major part of this release involved migrating the iOS Split Navigation implementation from Swift to Objective-C. We also brought several enhancements to our core components, such as adding the liftOnScroll prop for the small header on Android and introducing titleMenu support on iOS for Stack v5. This release adds support for react-native 0.87.
liftOnScroll prop for small header, integrate with SVM (#4368)Full Changelog: https://github.com/software-mansion/react-native-screens/compare/5.0.0-alpha.1...5.0.0-alpha.2
This is the first alpha release of react-native-screens 5.0.0. We're shifting focus on the new version and moving the new components out of experiment
This is the first alpha release of react-native-screens 5.0.0. We're shifting focus on the new version and moving the new components out of experimental package - they are now available via direct import from react-native-screens.
Old components are now considered legacy, however they are still importable from the main package. We intend to keep exporting and support these "legacy" components until we release 5.0.0 stable with stable new Native Stack implementation. We also still plan to release a few minor/patch versions of the v4 line of the library. We don't plan to merge any "big" new features there, however.
initialDetentIndex support (#4294)onDetentChanged support (#4292)preferredCornerRadius (#4282)accessibilityLabel for toolbar menu items (#4250)RootNodeKind trait for FormSheet, drop contentOriginOffset (#4306)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 patch release backports a set of iOS fixes. Tabs now render the tab bar on an iPhone Duo cold-launched while unfolded, and a detached UISearchTab
This patch release backports a set of iOS fixes. Tabs now render the tab bar on an iPhone Duo cold-launched while unfolded, and a detached UISearchTab no longer leaves the remaining tab titles truncated. In Stack v4, cancelling an interactive dismissal of a screen pushed with UIKit's zoom transition (e.g. expo-router's Link.AppleZoom) no longer leaves the navigation bar with alpha == 0, so the back button and header items stay visible. SplitView gains RNSNavigationItemCustomizerProtocol, which lets third-party solutions customize a column's navigationItem, and column navigation bars now have prefersLargeTitles enabled with the collapsed title shown by default.
RNSNavigationItemCustomizerProtocol so third-party solutions can customize a column's navigationItem (#5080)UISearchTab title at creation to avoid truncated tab titles (#5057)Full Changelog: https://github.com/software-mansion/react-native-screens/compare/4.30.0...4.30.1
Opaque headers (headerTransparent: false) aren't deprecated, but UIKit's support for them is getting worse:
This release focuses on iOS 27 and iPhone Duo support in Stack v4. On iOS 26+ screens are now laid out under an opaque navigation bar and inset through the safe area instead of UIKit's extended-layout frame and useHeaderHeight reports the visible height of the bar while it is minimized. The new unstable_safeAreaEdges prop on ScreenStackItem lets a screen override the insets applied on iOS 26+, and opaque headers no longer minimize on scroll. Tabs.Host gains prominentScreenKey (iOS 27+), backed by prominentTabIdentifier, so a chosen tab stays visible when the tab bar minimizes.
Starting with iOS 26, Apple recommends against custom navigation bar backgrounds. Bars are transparent by default and content is meant to extend under them - see WWDC25: Build a UIKit app with the new design. Opaque headers (headerTransparent: false) aren't deprecated, but UIKit's support for them is getting worse:
edgesForExtendedLayout (which we used to lay out the screen below an opaque header) doesn't position the screen correctly in landscape and in modals. We partially worked around this with a SafeAreaView (#3231).Pressables.[!TIP] We recommend following Apple's guidance and using a transparent header on iOS 26+.
prominentScreenKey so a chosen tab stays visible when the tab bar minimizes (#4724)unstable_safeAreaEdges prop (#4872)useHeaderHeight (#4734)Nothing published for this version
Nothing published for this version
This release migrates the Tabs implementation on iOS 26.1+ to the UITab API and extends the Tabs component with several new props: tabBarHiddenAnimati
This release migrates the Tabs implementation on iOS 26.1+ to the UITab API and extends the Tabs component with several new props: tabBarHiddenAnimationEnabled, tabBarSidebarPreferredPlacement, automaticallyActivatesSearch (backed by UISearchTab) and custom drawable/symbol tab-bar icons with per-slot coloring and per-tab sizing. Header items in Stack v4 gain a visibilityPriority prop on iOS.
It also brings a number of fixes, most notably hardening of the Android fragment lifecycle (R8-safe restoration, orphaned fragment cleanup, no crash during instance teardown) and corrections to form sheet scroll view handling on iOS.
tabBarHiddenAnimationEnabled prop (#4627)UISearchTab with automaticallyActivatesSearch prop (#4679)visibilityPriority prop to header items (#4709)tabBarSidebarPreferredPlacement test to component integration tests (#4816)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 is a small release that brings several fixes to the library.
This is a small release that brings several fixes to the library.
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
One column per quarter.