CHANGELOG.md

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

7.0.0-rc.25 (2024-08-09)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.24 (2024-08-08)

Bug Fixes

• avoid using column-reverse for header for a11y on web (3101d04) - by @satya164
• improve custom header in native stack & stack (7e6b666) - by @satya164

Features

• implement search bar in elements header (#12097) (78b1535) - by @satya164

7.0.0-rc.23 (2024-08-07)

Bug Fixes

• add more fallbacks for headerBackButtonDisplayMode (#12094) (bc01c15) - by @satya164

7.0.0-rc.22 (2024-08-05)

Features

• add headerBackButtonDisplayMode for native stack (#12089) (89ffa1b), closes #11980 - by @dylancom

BREAKING CHANGES

• This removes the headerBackTitleVisible option,

Adds corresponding functionality from software-mansion/react-native-screens#2123.

7.0.0-rc.21 (2024-08-02)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.20 (2024-08-01)

Bug Fixes

• fix incorrect condition due to bad merge (3a0b0b5) - by @satya164

7.0.0-rc.19 (2024-08-01)

Bug Fixes

• fix useAnimatedHeaderHeight on web for native stack (03b39d6) - by @satya164
• fix wrong header height for translucent header on Android (ca64015) - by @satya164

7.0.0-rc.18 (2024-07-25)

Bug Fixes

• fix type inference for params. closes #12071 (3299b70) - by @

Features

• add fullScreenSwipeShadowEnabled prop to NativeStackView (#12053) (da34512) - by @maksg

7.0.0-rc.17 (2024-07-19)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.16 (2024-07-12)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.15 (2024-07-12)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.14 (2024-07-11)

Bug Fixes

• upgrade react-native-builder-bob (1575287) - by @

7.0.0-rc.13 (2024-07-11)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.12 (2024-07-10)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.11 (2024-07-08)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.10 (2024-07-07)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.9 (2024-07-04)

Bug Fixes

• fix published files (829caa0) - by @

7.0.0-rc.8 (2024-07-04)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.7 (2024-07-04)

Features

• add package.json exports field (1435cfe) - by @

7.0.0-rc.6 (2024-07-02)

Bug Fixes

• drop leftover empty string for headerBackTitleVisible (b93f861) - by @satya164

7.0.0-rc.5 (2024-07-01)

Bug Fixes

• stop using react-native field in package.json (efc33cb) - by @

7.0.0-rc.4 (2024-06-29)

Bug Fixes

• add a workaround for incorrect inference #12041 (85c4bbb) - by @

7.0.0-rc.3 (2024-06-28)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.2 (2024-06-28)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.1 (2024-06-28)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-rc.0 (2024-06-27)

Bug Fixes

• native-stack: set headerTopInstetEnabled to the same value as statusBarTranslucent to prevent header content jump (#12014) (7791191), closes /github.com/react-navigation/react-navigation/blob/25e834b4f330fb05b4ecdbe81ef7f2f065fd26c8/packages/elements/src/SafeAreaProviderCompat.tsx#L55 #10827 - by @kkafar
• setting headerBackTitleVisible to false not working on iOS (#11937) (52a3234), closes /github.com/software-mansion/react-native-screens/blob/d54a19a/ios/RNSScreenStackHeaderConfig.mm#L506 /github.com/software-mansion/react-native-screens/blob/d54a19a9789b799566da16a89e2cd8d8f1ad0ba7/ios/RNSScreenStackHeaderConfig.h#L42 /github.com/software-mansion/react-native-screens/blob/d54a19a/ios/RNSScreenStackHeaderConfig.mm#L514-L539 - by @zetavg
• use measured header height when exposing it (#11917) (d90ed76) - by @satya164

Features

• add navigationBarTranslucent option to native stack (#11998) (2864b6c) - by @alduzy

7.0.0-alpha.20 (2024-03-25)

Features

• pass href to headerLeft function (ce6d885) - by @satya164

7.0.0-alpha.19 (2024-03-22)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.18 (2024-03-22)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.17 (2024-03-20)

Features

• add getStateForRouteNamesChange to all navigators and mark it as unstable (4edbb07) - by @satya164

7.0.0-alpha.16 (2024-03-14)

Features

• automatically infer types for navigation in options, listeners etc. (#11883) (c54baf1) - by @satya164

7.0.0-alpha.15 (2024-03-10)

Bug Fixes

• support custom fontFamily configurations in headerTitleStyle (#11880) (1e9e838), closes #11429 - by @Kasendwa

Features

• add a type for options arguments (8e719e0) - by @satya164

7.0.0-alpha.14 (2024-03-09)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.13 (2024-03-08)

Bug Fixes

• update drawer and header styles according to material design 3 (#11872) (bfa5689) - by @groot007

Features

• make all screens after presentation: 'modal' as modal unless specified (#11860) (f16216c) - by @groot007

7.0.0-alpha.12 (2024-03-04)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.11 (2024-02-24)

Bug Fixes

• fix peer dependency versions (4b93b63) - by @

7.0.0-alpha.10 (2024-02-23)

Bug Fixes

• White flash transitions with DarkTheme (#11800) (1770c96) - by @gianlucalippolis

7.0.0-alpha.9 (2024-02-23)

Bug Fixes

• fix header height for iOS devices with dynamic island (#11786) (4c521b5), closes #11655 - by @gianlucalippolis

Features

• add a HeaderButton component to elements (d8de228) - by @satya164
• introduce missing props from native-stack v5 (#11803) (90cfbf2) - by @tboba

7.0.0-alpha.8 (2024-01-17)

Features

• add layout and screenLayout props for screens (#11741) (2dc2178) - by @satya164
• preloading in routers (382d6e6) - by @osdnk

7.0.0-alpha.7 (2023-11-17)

Bug Fixes

• update peer dependencies when publishing (c440703) - by @

7.0.0-alpha.6 (2023-11-12)

Bug Fixes

• fix header customization in native stack (6885210) - by @satya164
• headerHeight on phones with dynamic island (#11338) (e4815c5), closes #10989 - by @dylancom

Features

• add a layout prop for navigators (#11614) (1f51190) - by @satya164
• add useAnimatedHeaderHeight hook (#11663) (5a88c74), closes #11338 - by @tboba

7.0.0-alpha.5 (2023-09-25)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.4 (2023-09-13)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.3 (2023-09-07)

Bug Fixes

• Allow to use PlatformColor in the theme (#11570) (64734e7) - by @retyui

• buggy behaviour of search bar / large title on Fabric with native stack v7 (#11501) (dcb4e4c) - by @kkafar

• feat!: add a direction prop to NavigationContainer to specify rtl (#11393) (8309636), closes #11393 - by @satya164

BREAKING CHANGES

• Previously the navigators tried to detect RTL automatically and adjust the UI. However this is problematic since we cannot detect RTL in all cases (e.g. on Web).

This adds an optional direction prop to NavigationContainer instead so that user can specify when React Navigation's UI needs to be adjusted for RTL. It defaults to the value from I18nManager on native platforms, however it needs to be explicitly passed for Web.

7.0.0-alpha.2 (2023-06-22)

Note: Version bump only for package @react-navigation/native-stack

7.0.0-alpha.1 (2023-03-01)

Bug Fixes

• fix paths in sourcemap files (368e069) - by @satya164

Features

• add ability to customize the fonts with the theme (#11243) (1cd6836) - by @satya164

7.0.0-alpha.0 (2023-02-17)

Bug Fixes

• fix headerBackVisible type annotation (#11220) (d18936a) - by @Vin-Xi

• make headerBackground visible with transparent header (#11109) (2b1e8dc) - by @yhkaplan

• refactor!: improve the API for Link component (7f35837) - by @satya164

BREAKING CHANGES

• Initially the Link component was designed to work with path strings via the to prop. But it has few issues:

• The path strings are not type-safe, making it easy to cause typos and bugs after refactor
• The API made navigating via screen name more incovenient, even if that's the preferred approach

This revamps the API of the Link component to make it easier to use. Instead of to prop, it now accepts screen and params props, as well as an optional href prop to use instead of the generated path.

e.g.:

<Link screen="Details" params={{ foo: 42 }}>Go to Details</Link>

This also drops the useLinkTo hook and consolidates into the useLinkTools hook - which lets us build a href for a screen or action for a path.

6.9.2 (2022-11-21)

Bug Fixes

• add accessibility props to NativeStack screens (#11022) (3ab05af)
• let headerShadowVisible: true display a shadow even if headerTransparent is true (#10993) (06b6be2), closes #10845
• supersede Platform.isTVOS for Platform.isTV (#10973) (1846de6)

6.9.1 (2022-10-11)

Bug Fixes

• fix headerTransparent with custom header in native-stack (#10919) (40bed38), closes #10822 #10902

6.9.0 (2022-09-16)

Bug Fixes

• fix incorrect height in useHeaderHeight in native-stack (#10827) (b8ea527), closes #10333
• improve when back button is shown in nested native stacks (#10761) (05dab7d)
• replace deprecated I18nManager.isRTL with 18nManager.getConstants().isRTL (#10547) (50b88d4)
• restore native behavior of back button (7ba7246), closes #10761 software-mansion/react-native-screens#1589

Features

• add freezeOnBlur prop (#10834) (e13b4d9)
• implement usePreventRemove hook (#10682) (7411516)

6.8.0 (2022-08-24)

Bug Fixes

• improve when back button is shown in nested native stacks (#10761) (05dab7d)
• replace deprecated I18nManager.isRTL with 18nManager.getConstants().isRTL (#10547) (50b88d4)

Features

• implement usePreventRemove hook (#10682) (7411516)

6.7.0 (2022-07-05)

Bug Fixes

• ensure same @types/react version in repo (#10663) (e662465), closes #10655
• explicitly set gestureDirection default value in native-stack (#10674) (25a0d4c)
• fix typo in native-stack types (f4df53a)
• use top inset for header height on ipad (#10652) (d5b2600), closes #10609

Features

• add missing props from react-native-screens to native-stack (#10578) (7e9027b), closes #10454

6.6.2 (2022-04-22)

Bug Fixes

• fix incorrect header title when headerLeft is specified (bc6f6b5), closes #10452
• fix incorrect warning for headerTransparent in native-stack (4ff1ef5), closes #10502

6.6.1 (2022-04-01)

Note: Version bump only for package @react-navigation/native-stack

6.6.0 (2022-04-01)

Features

• add an ID prop to navigators (4e4935a)

6.5.2 (2022-03-23)

Bug Fixes

• provide proper context to header elements in native stack (5b01241), closes #10453

6.5.1 (2022-03-23)

Bug Fixes

• take screen count to dismiss from native side for native stack (#10377) (27225a2)

6.5.0 (2022-02-06)

Features

• add customAnimationOnGesture & fullScreenSwipeEnabled props to native-stack (#10321) (ab86045)

6.4.1 (2022-02-03)

Bug Fixes

• correctly set header to translucent (c9eed38)

6.4.0 (2022-02-02)

Bug Fixes

• set header to translucent when using searchbar or large title (a410f84)

Features

• add search bar to native-stack on Android (e329c43)

6.3.0 (2022-01-29)

Bug Fixes

• fix exposing custom header height with modals (3b4edf7)
• fix useRoute & useNavigation in custom header in native stack (826b0c5)
• hide header shadow for transparent header (ffcd171)
• make native stack background transparent when using transparentModal (d58f4b9)
• wrap native stack with NavigationContent (#10288) (d0f8620), closes #10287 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/core/src/useNavigation.tsx#L16 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/native/src/useLinkProps.tsx#L26 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/core/src/useNavigationBuilder.tsx#L606 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/bottom-tabs/src/navigators/createBottomTabNavigator.tsx#L101 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/drawer/src/navigators/createDrawerNavigator.tsx#L99 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/stack/src/navigators/createStackNavigator.tsx#L110 /github.com/react-navigation/react-navigation/blob/b91c9b05ff96727f5fa6ef0bec51b5d7eac06600/packages/native-stack/src/navigators/createNativeStackNavigator.tsx#L67

Features

• native-stack: add support for header background image (393773b)
• native-stack: export NativeStackView to support custom routers on native-stack (#10260) (7b761f1)
• native-stack: expose custom header height (#10113) (e93b2e9)
• pass canGoBack to headerRight (82a1669)

6.2.5 (2021-10-16)

Bug Fixes

• fix default for animationTypeForReplace to match with JS stack (ec4c8cc)

6.2.4 (2021-10-12)

Note: Version bump only for package @react-navigation/native-stack

6.2.3 (2021-10-09)

Note: Version bump only for package @react-navigation/native-stack

6.2.2 (2021-09-27)

Bug Fixes

• fix invalid headerTintColor in native-stack (#9972) (43d3211)

6.2.1 (2021-09-26)

Note: Version bump only for package @react-navigation/native-stack

6.2.0 (2021-09-26)

Bug Fixes

• export header props for other navigators (8475481), closes #9965
• pass title style to . fixes #9885 (127e030)
• support same styles in centered title in native stack (77080d8)

Features

• add headerBackButtonMenuEnabled prop (#9881) (c15bcfb), closes /github.com/software-mansion/react-native-screens/discussions/1071#discussioncomment-1227326
• pass more props to header left in native-stack (ef41211)

6.1.0 (2021-08-18)

Bug Fixes

• content container in native web stack should fill parent (#9832) (ec0d113)

Features

• add headerTitleAlign prop in native stack. closes #9829 (fe692c2)

6.0.6 (2021-08-17)

Note: Version bump only for package @react-navigation/native-stack

6.0.5 (2021-08-11)

Bug Fixes

• fix headerTransparent not working outside stack navigator (42c43ff)

6.0.4 (2021-08-09)

Note: Version bump only for package @react-navigation/native-stack

6.0.3 (2021-08-07)

Note: Version bump only for package @react-navigation/native-stack

6.0.2 (2021-08-05)

Bug Fixes

• fix incorrect name for headerTransparent (1da575e)

6.0.1 (2021-08-03)

Note: Version bump only for package @react-navigation/native-stack

6.0.0 (2021-08-01)

Bug Fixes

• show error when beforeRemove is used to prevent action in naive stack (6d518a4)

Features

• add custom header option to native-stack (1a39632)
• basic web implementation for native stack (de84458)
• expose header height in native-stack (#9774) (20abccd)

6.0.0-next.11 (2021-07-16)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.10 (2021-07-16)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.9 (2021-07-01)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.8 (2021-06-10)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.7 (2021-06-01)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.6 (2021-05-29)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.5 (2021-05-29)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.4 (2021-05-27)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.3 (2021-05-26)

Features

• add screenListeners prop on navigators similar to screenOptions (cde44a5)

6.0.0-next.2 (2021-05-25)

Note: Version bump only for package @react-navigation/native-stack

6.0.0-next.1 (2021-05-23)

Bug Fixes

• automatically set top inset on Android in native stack (2cb44a5)

Features

• add native-stack to repo (#9596) (a55d6a8)

5.0.5 (2020-02-14)

Note: Version bump only for package @react-navigation/native-stack

5.0.4 (2020-02-14)

Note: Version bump only for package @react-navigation/native-stack

5.0.3 (2020-02-12)

Note: Version bump only for package @react-navigation/native-stack

5.0.2 (2020-02-11)

Note: Version bump only for package @react-navigation/native-stack

5.0.1 (2020-02-10)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.35 (2020-02-04)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.34 (2020-02-04)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.33 (2020-02-03)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.32 (2020-02-02)

Bug Fixes

• add licenses (0c159db)
• screens integration on Android (#294) (9bfb295)
• update screens for native stack (5411816)

5.0.0-alpha.30 (2020-02-02)

Bug Fixes

• add licenses (0c159db)
• screens integration on Android (#294) (9bfb295)
• update screens for native stack (5411816)

5.0.0-alpha.29 (2020-01-24)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.28 (2020-01-23)

Bug Fixes

• fix types for native stack (1da4a64)

Features

• emit appear and dismiss events for native stack (f1df4a0)
• let the navigator specify if default can be prevented (da67e13)

5.0.0-alpha.27 (2020-01-14)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.26 (2020-01-13)

Bug Fixes

• make sure paths aren't aliased when building definitions (65a5dac), closes #265

5.0.0-alpha.25 (2020-01-13)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.24 (2020-01-09)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.23 (2020-01-09)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.22 (2020-01-05)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.21 (2020-01-03)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.20 (2020-01-01)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.19 (2019-12-19)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.18 (2019-12-16)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.17 (2019-12-14)

Features

• add custom theme support (#211) (00fc616)

5.0.0-alpha.16 (2019-12-11)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.15 (2019-12-07)

Features

• export underlying views used to build navigators (#191) (d618ab3)

5.0.0-alpha.14 (2019-11-20)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.13 (2019-11-17)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.12 (2019-11-10)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.11 (2019-11-08)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.10 (2019-11-04)

Bug Fixes

• popToTop on tab press in native stack (301c35e)

5.0.0-alpha.9 (2019-11-04)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.8 (2019-11-02)

Features

• add headerBackTitleVisible to navigation options in native stack (77f29d3)

5.0.0-alpha.7 (2019-11-02)

Bug Fixes

• remove top margin from screen in native stack on Android (5cd6940)

5.0.0-alpha.6 (2019-10-30)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.5 (2019-10-29)

Note: Version bump only for package @react-navigation/native-stack

5.0.0-alpha.4 (2019-10-22)

Features

• native-stack: add support for large title attributes (#135) (6cf1a04)

5.0.0-alpha.3 (2019-10-18)

Bug Fixes

• remove top margin when header is hidden in native stack. fixes #131 (fb726ee)

5.0.0-alpha.2 (2019-10-18)

Bug Fixes

• fix header font size config in native stack (#128) (477c088)

5.0.0-alpha.1 (2019-10-15)

Bug Fixes

• increase hitSlop of back button on Android (c7da1e4)
• update supported options for native stack (b71f4e5)

Features

• initial version of native stack (#102) (ba3f718)