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-alpha.18 (2024-03-22)

Bug Fixes

• accept partial linking.config for static navigation (3825046) - by @satya164

Features

• add automatic home screen detection for auto linking (b0bec6f) - by @satya164

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

Features

• add a way to automatically generate linking config (d090836) - by @satya164
• automatically enable linking if any config is specified (c91d247) - by @satya164

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

Features

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

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

Features

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

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

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

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

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

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

Bug Fixes

• preserve # in the URL if the screen hasn't changed (#11876) (66cc899) - by @groot007

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

Bug Fixes

• fix forwarding ref for static navigation (83921e9) - by @satya164

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

Bug Fixes

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

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

Bug Fixes

• browser navigating out after using back feature and going home (#11833) (8745ea5), closes #11832 - by @SlickDomique
• type errors when getState used outside of a screen (#11827) (b3512a5), closes #11701 - by @MrRefactor

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

Bug Fixes

• forward ref for static navigation (f6b99b1) - by @satya164

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

Bug Fixes

• fix import for LinkingOptions (9986736) - by @satya164

Features

• move theming to core and pass theme to options (#11707) (8e7ac4f) - by @satya164

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

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

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

Bug Fixes

• cannot resolve use-latest-callback (#11696) (361bc6a) - by @jkaveri

Features

• add useUnhandledLinking for handling deep links behind auth etc. (#11602) (688c43a), closes #10939 - by @osdnk
• add a button element to elements package (#11669) (25a85c9) - by @satya164
• add API for unhandled linking (#11672) (5758b26) - by @osdnk

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

Bug Fixes

• don't use .web extensions (8dfd9bc) - by @satya164

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

Bug Fixes

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

• incorrect url parsing (isssue: #10924) (#11528) (fab2cc6) - by @retyui

• prevent back handler usage on web (#11458) (486ee81) - by @EvanBacon

• replace series function used to queue async callbacks (#11485) (d8dc693) - by @karlsander

• 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)

Features

• support a top-level path configuration in linking config (1d0297e) - by @satya164

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

• add ScrollView type to 'getScrollResponder' (#11112) (f4324cd) - by @ken0nek

• don't modify browser history on re-render (ab66777) - by @satya164

• keep hash/fragment section un URLs on web (#11078) (a30daa0) - by @nikgraf

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

• fix!: align onReady callback and navigationRef.isReady (1959baa) - by @satya164

Features

• make useScrollToTop work when nesting multiple tab navigators (#11063) (dce463a), closes /github.com/react-navigation/react-navigation/pull/9434#issuecomment-1328345015 - by @anthonyguay
• support statically confguring navigation tree (#11144) (4cc322e) - 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.

• Previously, the onReady prop and navigationRef.isReady() work slightly differently. The onReady callback fired when NavigationContainer finishes mounting and deep links is resolved. The navigationRef.isReady() method additionally checks if there are any navigators rendered - which may not be true if the user is rendering their navigators conditionally inside a NavigationContainer.

This changes onReady to work similar to navigationRef.isReady(). The onReady callback will now fire only when there are navigators rendered - reflecting the value of navigationRef.isReady().

6.0.14 (2022-11-21)

Bug Fixes

• add accessibility props to NativeStack screens (#11022) (3ab05af)

6.0.13 (2022-09-16)

Bug Fixes

• handle path with empty string properly for linking (#10708) (e8c374e)

6.0.12 (2022-08-24)

Bug Fixes

• handle path with empty string properly for linking (#10708) (e8c374e)

6.0.11 (2022-07-05)

Bug Fixes

• ensure same @types/react version in repo (#10663) (e662465), closes #10655
• expose LinkingContext (#10604) (ac24e61)
• prevent history.go() navigation outside bounds (#10601) (ff8d8a3), closes #10481

6.0.10 (2022-04-01)

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

6.0.9 (2022-04-01)

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

6.0.8 (2022-02-02)

Bug Fixes

• broken history items index when items reset (#10312) (16f3462)

6.0.7 (2022-01-29)

Bug Fixes

• fix crash in useLinking on Web (#10262) (e612a4c), closes /github.com/react-navigation/react-navigation/pull/9970/files#r784475821 /github.com/react-navigation/react-navigation/blob/fb84805c889bbb7059e7e95592c004aea2a510d6/packages/native/src/useLinking.tsx#L84 /github.com/react-navigation/react-navigation/blob/fb84805c889bbb7059e7e95592c004aea2a510d6/packages/native/src/useLinking.tsx#L86 /github.com/react-navigation/react-navigation/blob/fb84805c889bbb7059e7e95592c004aea2a510d6/packages/native/src/useLinking.tsx#L108 /github.com/react-navigation/react-navigation/blob/fb84805c889bbb7059e7e95592c004aea2a510d6/packages/native/src/useLinking.tsx#L110
• update URL on web when params change. fixes #10046 (4468b96)
• web: avoid passing undefined root state in web (#10186) (9087439), closes #10185

6.0.6 (2021-10-12)

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

6.0.5 (2021-10-09)

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

6.0.4 (2021-09-26)

Bug Fixes

• fix building link with useLinkProps (bcdc559)

6.0.3 (2021-09-26)

Bug Fixes

• fix href with useLinkProps. fixes #9930 (4ae53e1)
• fix navigation when going back and forth in history on web (#9970) (fb84805), closes #9408 #9128
• make useScrollToTop work with react-native-largelist (#9960) (073fd57)
• use console.error for linking conflicts instead of throwing (4b36bcf)

6.0.2 (2021-08-07)

Bug Fixes

• fix crash in useLinkTo when passing an object (#9800) (dfd0cc7)

6.0.1 (2021-08-03)

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

6.0.0 (2021-08-01)

Features

• add a way to filter out deep links from being handled (c322b05)

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

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

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

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

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

Bug Fixes

• disable duplicate linking check for independent containers (20b8ebd)

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

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

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

Bug Fixes

• validate property names in linking config (324ea71)

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

Bug Fixes

• try to fix #9631 (b4d7b0e)

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

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

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

Features

• expose container ref in useNavigation (1d40279)

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

Features

• initial implementation of a flipper plugin (d6f6f5f)

6.0.0-next.8 (2021-05-16)

Bug Fixes

• add ability to pass generic params to Link (9c30c42)

6.0.0-next.7 (2021-05-10)

Features

• return a NavigationContent component from useNavigationBuilder (1179d56)

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

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

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

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

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

Features

• add ability to specify root param list (b28bfdd)
• support navigate-like object in Link (1478659)

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

Features

• add helper and hook for container ref (0ecd112)

6.0.0-next.2 (2021-04-08)

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

6.0.0-next.1 (2021-03-10)

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

6.0.0-next.0 (2021-03-09)

Bug Fixes

• address breaking change in react-native for Linking (61c6bb0)
• default to backBehavior: firstRoute for TabRouter (8bdc6c6)
• drop dangerously prefix from getState and getParent (227f133)
• normalize prefix when parsing. fixes #9081 (fd034fe)
• support sync getInitialURL in native useLinking (52dd4e7)

Features

• associate path with the route it opens when deep linking (#9384) (86e64fd), closes #9102
• stop exporting useLinking hook (5a9a1ed)

BREAKING CHANGES

• Returning to first route after pressing back seems more common in apps. This commit changes the default for tab and drawer navigators to follow this common practice. To preserve previous behavior, you can pass backBehavior=history to tab and drawer navigators.
• we have added linking prop for the same use case which is easier to use. so no need to export useLinking anymore.

5.8.9 (2020-11-10)

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

5.8.8 (2020-11-09)

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

5.8.7 (2020-11-08)

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

5.8.6 (2020-11-04)

Bug Fixes

• ignore any errors from deep linking (4c2379c)

5.8.5 (2020-11-04)

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

5.8.4 (2020-11-03)

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

5.8.3 (2020-11-03)

Bug Fixes

• make sure that invalid linking config doesn't work if app is open (52451d1)

5.8.2 (2020-10-30)

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

5.8.1 (2020-10-28)

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

5.8.0 (2020-10-24)

Features

• add getInitialURL and subscribe options to linking config (748e92f)
• allow deep linking to reset state (#8973) (7f3b27a), closes #8952
• support wildcard string prefixes (#8942) (23ab350), closes #8941

5.7.6 (2020-10-07)

Bug Fixes

• add missing check for initial state on web (9e36508)

5.7.5 (2020-09-28)

Bug Fixes

• check for correct resolved value in useThenable. fixes #8798 (cc8f1f4)

5.7.4 (2020-09-22)

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

5.7.3 (2020-08-04)

Bug Fixes

• make sure we don't exit the page when going back (2a48b91)
• wait longer for history.go and handle interruptions (b1f1377)

5.7.2 (2020-07-28)

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

5.7.1 (2020-07-19)

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

5.7.0 (2020-07-10)

Bug Fixes

• ensure correct document title after going back on Chrome (8f5286e)
• tweak border color to match iOS default (c665c02)

Features

• add a hook to update document title (13c9d1e)
• add support for badges to bottom tab bar (96c7b68)

5.6.1 (2020-06-25)

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

5.6.0 (2020-06-24)

Bug Fixes

• fix forward with history API. closes #8409 (d85d27c)

Features

• add an onReady callback to the container (#8491) (8177c45)
• rework linking configuration to be more strict (#8502) (a021cfb)

5.5.1 (2020-06-06)

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

5.5.0 (2020-05-27)

Bug Fixes

• export types from /native (af1722d)

Features

• add a ServerContainer component for SSR (#8297) (68e750d)
• add ref to get current options in ServerContainer (#8333) (0b1a718)

5.4.3 (2020-05-23)

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

5.4.2 (2020-05-20)

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

5.4.1 (2020-05-20)

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

5.4.0 (2020-05-16)

Bug Fixes

• fix types for linking options (d14f38b)

Features

• add a PathConfig type (60cb3c9)

5.3.2 (2020-05-14)

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

5.3.1 (2020-05-14)

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

5.3.0 (2020-05-10)

Features

• initialState should take priority over deep link (039017b)

5.2.6 (2020-05-08)

Bug Fixes

• fix building typescript definitions. closes #8216 (47a1229)

5.2.5 (2020-05-08)

Bug Fixes

• return a promise-like from getInitialState (#8210) (85ae378)

5.2.4 (2020-05-05)

Bug Fixes

• return undefined for buildLink if linking is not enabled (9fd2635)

5.2.3 (2020-05-01)

Bug Fixes

• default linking enabled to true (c7b8e2e)

5.2.2 (2020-05-01)

Bug Fixes

• don't throw when using 'useLinking'. fixes #8171 (10eca8b)

5.2.1 (2020-04-30)

Bug Fixes

• render fallback only if linking is enabled. closes #8161 (1c075ff)

5.2.0 (2020-04-30)

Bug Fixes

• add catch to thenable returned by getInitialState (d6fa279)
• return onPress instead of onClick for useLinkProps (ae5442e)

Features

• add useLinkBuilder hook to build links (2792f43)
• add a useLinkProps hook (f2291d1)
• add action prop to Link (942d2be)
• add Link component as useLinkTo hook for navigating to links (2573b5b)

5.1.7 (2020-04-27)

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

5.1.6 (2020-04-17)

Bug Fixes

• handle in-page go back when there's no history (6bdf6ae), closes #7852

5.1.5 (2020-04-08)

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

5.1.4 (2020-03-30)

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

5.1.3 (2020-03-23)

Bug Fixes

• add info about android launchMode in useLinking error (d94e43c)

5.1.2 (2020-03-22)

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

5.1.1 (2020-03-19)

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

5.1.0 (2020-03-17)

Features

• add permanent drawer type (#7818) (6a5d0a0)

5.0.10 (2020-03-16)

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

5.0.9 (2020-03-03)

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

5.0.8 (2020-02-26)

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

5.0.7 (2020-02-21)

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

5.0.6 (2020-02-19)

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

5.0.5 (2020-02-14)

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

5.0.4 (2020-02-14)

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

5.0.3 (2020-02-12)

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

5.0.2 (2020-02-11)

Bug Fixes

• make getInitialState async on web (6c6102b)

5.0.1 (2020-02-10)

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

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

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

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

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

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

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

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

Bug Fixes

• add licenses (0c159db)

Features

• add error if multiple instances of useLinking are used (#310) (4bc0c8f)
• integrate with history API on web (5a3f835)

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

Bug Fixes

• add licenses (0c159db)

Features

• add error if multiple instances of useLinking are used (#310) (4bc0c8f)
• integrate with history API on web (5a3f835)

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

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

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

Features

• 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

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

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

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

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

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

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

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

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

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

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

Features

• add nested config in deep linking (#210) (8002d51), closes #154

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

Features

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

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

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

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

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

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

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

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

Bug Fixes

• don't call getNode if ref is already scrollable (#162) (66551f2)

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

Bug Fixes

• support scroll to top in navigators nested in tab (50dea65)

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

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

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

Features

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

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

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

5.0.0-alpha.10 (2019-10-03)

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

5.0.0-alpha.9 (2019-10-03)

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

5.0.0-alpha.8 (2019-09-16)

Features

• make deep link handling more flexible (849d952)
• make example run as bare react-native project as well (#85) (d16c20c)

5.0.0-alpha.7 (2019-08-31)

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

5.0.0-alpha.6 (2019-08-31)

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

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

Bug Fixes

• handle both null and undefined in useScrollToTop (c951027)

Features

• handle animated component wrappers in useScrollToTop (#81) (cdbf1e9)
• handle more methods in useScrollToTop (f9e8c7e)

5.0.0-alpha.4 (2019-08-28)

Bug Fixes

• fix stack nested in tab always getting reset (dead4e8)

5.0.0-alpha.3 (2019-08-27)

Features

• add hook to scroll to top on tab press (9e1104c)
• add native container (d26b77f)

5.0.0-alpha.2 (2019-08-22)

Bug Fixes

• fix path to typescript definitions (f182315)

5.0.0-alpha.1 (2019-08-21)

Bug Fixes

• fix peer deps and add git urls (6b4fc74)

Features

• add hook for deep link support (35987ae)
• add native container with back button integration (#48) (b7735af)