Routers to help build custom navigators
Last release 1 months ago
27 Jul 2026
Ships fairly regularly
a new release about every 2 weeks
Some releases are documented
notes for 11 of 27 stable releases
82 versions withdrawn
withdrawn after publishing
7 years old
143 releases · first in 2019
Release timeline
143 releases since 2019Releases
- 8.0.0-alpha.1727 Jul 2026pre-release
Release notes
Open source →8.0.0-alpha.17 (2026-05-19)
Bug Fixes
- detect duplicate navigators in hidden trees (ab1db32) - by @satya164
- handle container ref methods in hidden trees (d3ef9c2) - by @satya164
- handle targeted actions in hidden nested navigators (fee99a3) - by @satya164
- make beforeRemove event work even when navigator or screen is hidden (5f280d9) - by @satya164
- make getRootState return state for hidden nested navigators (e600b34) - by @satya164
- return current options from navigators in hidden trees (37fd105) - by @satya164
Additional notes
Open source →8.0.0-alpha.17 (2026-03-30)
Bug Fixes
- use activity for resolving platform color (6693a44) - by @satya164
Additional notes
Open source →8.0.0-alpha.17 (2026-03-14)
Bug Fixes
- bump peer deps to match required versions (44416b0) - by @
Features
- support system icons in drawer items (a035d46) - by @satya164
Additional notes
Open source →8.0.0-alpha.17 (2026-03-09)
Bug Fixes
- fix incorrectly commented out pop to top (72c1345) - by @satya164
- 8.0.0-alpha.1621 Jul 2026pre-release
Release notes
Open source →8.0.0-alpha.16 (2026-07-21)
Bug Fixes
- create fresh route object when key changes in tab (a7e1a7e) - by @satya164
- fix param type for history object in route (e5018d2) - by @satya164
- focus preloaded and retained routes when child is focused (7d85761) - by @satya164
- match preloaded stack routes by exact ID (338609d) - by @satya164
- update history params when switching tabs (db548d8) - by @satya164
Additional notes
Open source →Additional notes
Open source →8.0.0-alpha.16 (2026-03-23)
Features
- add
withmethod to static configuration (604854f) - by @satya164
Additional notes
Open source →8.0.0-alpha.16 (2026-03-14)
Bug Fixes
- bump peer deps to match required versions (44416b0) - by @
Features
- support system icons in material top tabs (a6641ae) - by @satya164
Additional notes
Open source →8.0.0-alpha.16 (2026-03-05)
Bug Fixes
- avoid applying double inset for drawer content (43d9342) - by @
- 8.0.0-alpha.1517 Jul 2026pre-release
Release notes
Open source →8.0.0-alpha.15 (2026-07-17)
Bug Fixes
- fall back to first route if initial route isn't present when rehydrating (7f157c4) - by @
Additional notes
Open source → - 8.0.0-alpha.1416 Jul 2026pre-release
Release notes
Open source →8.0.0-alpha.14 (2026-07-16)
Bug Fixes
- add focused route to history when preload replaces it (986473b) - by @satya164
- don't handle reset for non-stale state with an invalid index (d2705e4) - by @satya164
- don't pop routes above the source route for pop action (ec7ab7f) - by @satya164
- fix incorrect tab history after navigationKey changes (859c9f3) - by @satya164
- focus most recent route in history when focused route is removed (3da90c5) - by @satya164
- keep initial route params when going back with fullHistory (e5995c4) - by @satya164
- preserve drawer status in history when changing index (7a36f07) - by @satya164
- remove stale history entries when getId changes the route key (a450b4e) - by @satya164
Additional notes
Open source →8.0.0-alpha.14 (2026-03-03)
Bug Fixes
- include background color and blur effect in scrollEdgeAppearance in native bottom tabs (#12997) (11cc687) - by @Kasendwa
Features
- 8.0.0-alpha.1318 Jun 2026pre-release
Additional notes
Open source →8.0.0-alpha.13 (2026-05-05)
Features
BREAKING CHANGES
- Previously
state.routesin stack didn't contain routes beyond index. This changes the behavior to add preloaded and retained routes in those positions, and removes thepreloadedRoutesarray in favor of routes beyond index.
This makes it possible to treat preloaded routes the same way as regular routes.
This means they can:
- Receive events from parent navigator
- Update their params
- Allow navigation in nested navigators
- Include nested navigator state in getRootState
It also stops treating preloaded routes as removed for
preventRemove.Additional notes
Open source →8.0.0-alpha.13 (2026-03-03)
Bug Fixes
- keep animating screens as interactive in stack (32c1f28) - by @satya164
- stack: use correct previous focused route when preloaded routes exist (#13000) (7778bae) - by @WojtekBoman
Features
Additional notes
Open source →8.0.0-alpha.13 (2026-02-16)
Bug Fixes
- include tab item appearance in scrollEdgeAppearance for native tabs (#12968) (c3b69e0) - by @Kasendwa
Features
- Previously
- 8.0.0-alpha.1211 Jun 2026pre-release
Additional notes
Open source →8.0.0-alpha.12 (2026-04-24)
Bug Fixes
- expose initialRouteName and screens in static config linking types (bce29d6) - by @satya164
- improve type inference performance (#13081) (2c5f5bb) - by @satya164
Features
- 8.0.0-alpha.118 Jun 2026pre-release
Additional notes
Open source →8.0.0-alpha.11 (2026-02-12)
Bug Fixes
- tweak theme colors to match iOS defaults (311b962) - by @satya164
Additional notes
Open source →8.0.0-alpha.11 (2026-02-10)
Bug Fixes
- use material back icon by default on android (6c4ce52) - by @satya164
Additional notes
Open source →8.0.0-alpha.11 (2026-02-10)
Features
- support badge background color and tab label color on iOS (3cd13d4) - by @satya164
- 8.0.0-alpha.1015 May 2026pre-release
Release notes
Open source →Additional notes
Open source →8.0.0-alpha.10 (2026-04-13)
Bug Fixes
- fix type inference for nested CompositeNavigationProp (f0abff2) - by @satya164
Features
- 8.0.0-alpha.911 May 2026pre-release
Additional notes
Open source →8.0.0-alpha.9 (2026-02-04)
Bug Fixes
- fix broken animation during replace (#12950) (0a7e22f) - by @satya164
- fix replace animation on fast transitions (a61273e) - by @satya164
Features
- support materialSymbol & sfSymbol for header back icon (60e7af2) - by @satya164
Additional notes
Open source →8.0.0-alpha.9 (2026-02-04)
Bug Fixes
- add a workaround for false positive with multiple linking error (be38f7c) - by @satya164
Features
- export MaterialLightTheme and MaterialDarkTheme (bc0ec11) - by @satya164
Additional notes
Open source →8.0.0-alpha.9 (2026-02-04)
Bug Fixes
- improve handling for PlatformColor (e141378) - by @satya164
Features
- support materialSymbol & sfSymbol for header back icon (60e7af2) - by @satya164
- 8.0.0-alpha.88 May 2026pre-release
Additional notes
Open source →8.0.0-alpha.8 (2026-03-23)
Bug Fixes
- use a weak ref instead of mutating params to avoid errors when it's frozen (#13042) (3de9e89) - by @gtokman
Features
- add
withmethod to static configuration (604854f) - by @satya164
Additional notes
Open source →Additional notes
Open source →Additional notes
Open source →Additional notes
Open source →Additional notes
Open source → - 8.0.0-alpha.75 May 2026pre-release
Release notes
Open source →8.0.0-alpha.7 (2026-05-05)
Features
BREAKING CHANGES
- Previously
state.routesin stack didn't contain routes beyond index. This changes the behavior to add preloaded and retained routes in those positions, and removes thepreloadedRoutesarray in favor of routes beyond index.
This makes it possible to treat preloaded routes the same way as regular routes.
This means they can:
- Receive events from parent navigator
- Update their params
- Allow navigation in nested navigators
- Include nested navigator state in getRootState
It also stops treating preloaded routes as removed for
preventRemove.Additional notes
Open source →Additional notes
Open source → - Previously
- 8.0.0-alpha.624 Apr 2026pre-release
Additional notes
Open source →8.0.0-alpha.6 (2026-03-03)
Bug Fixes
- update useNavigationState in layout effect (4f96a7e) - by @satya164
Additional notes
Open source →Additional notes
Open source →8.0.0-alpha.6 (2026-02-01)
Bug Fixes
- handle variant and weight for material symbol in native tabs (effd42f) - by @satya164
Features
- add support for disabling overrideScrollViewContentInsetAdjustmentBehavior (6f06cca) - by @
- 8.0.0-alpha.513 Apr 2026pre-release
Release notes
Open source →Additional notes
Open source →8.0.0-alpha.5 (2026-03-03)
Bug Fixes
- clear nested params after state is updated (be6796e), closes #12986 - by @satya164
- fix incorrect type for reset action (724e198) - by @satya164
- preserve navigator state with <Activity mode="hidden"> (5308cae) - by @satya164
- rework useIsFocused to update at the same time as the navigator (#13010) (ecf098b) - by @satya164
- tweaks to better work inside
<Activity mode="hidden">(#12985) (90a9394) - by @satya164 - use nested screen from params when creating path (#13005) (af23b4c) - by @satya164
Features
Additional notes
Open source →8.0.0-alpha.5 (2026-01-29)
Bug Fixes
- fix material symbol not getting updated when name changes (ea86b5c) - by @
- 8.0.0-alpha.430 Mar 2026pre-release
Additional notes
Open source →Additional notes
Open source →8.0.0-alpha.4 (2026-01-29)
Features
- add support for variant and weight to material symbol (1dcd6a5) - by @satya164
- 8.0.0-alpha.33 Mar 2026pre-release
Release notes
Open source → - 8.0.0-alpha.212 Feb 2026pre-release
Additional notes
Open source →8.0.0-alpha.2 (2026-01-19)
Features
- support materialSymbol icon in bottom tabs (370c5d3) - by @satya164
- 8.0.0-alpha.119 Jan 2026pre-release
Additional notes
Open source →8.0.0-alpha.1 (2026-01-19)
Features
- handle popToRoot natively in native tabs (da45221) - by @satya164
- 8.0.0-alpha.019 Dec 2025pre-release
Release notes
Open source →8.0.0-alpha.0 (2025-12-19)
https://reactnavigation.org/blog/2025/12/19/react-navigation-8.0-alpha
Additional notes
Open source →8.0.0-alpha.0 (2025-12-19)
https://reactnavigation.org/blog/2025/12/19/react-navigation-8.0-alpha
Additional notes
Open source →8.0.0-alpha.0 (2025-12-19)
https://reactnavigation.org/blog/2025/12/19/react-navigation-8.0-alpha
Additional notes
Open source →8.0.0-alpha.0 (2025-12-19)
https://reactnavigation.org/blog/2025/12/19/react-navigation-8.0-alpha
Additional notes
Open source →8.0.0-alpha.0 (2025-12-19)
https://reactnavigation.org/blog/2025/12/19/react-navigation-8.0-alpha
- 7.6.420 Jul 2026
Release notes
Open source →7.6.4 (2026-07-20)
Bug Fixes
- create fresh route object when key changes in tab (4c49c07) - by @satya164
- filter preloaded routes on route config changes (c032678) - by @satya164
- prevent popTo from matching routes above source (46de2ce) - by @satya164
- update correct route params in tab history (634cd4f) - by @satya164
- update route on repeated preload instead of replacing (85378e4) - by @satya164
- update route params in tab history on preload (6ab10e0) - by @satya164
- 7.6.320 Jul 2026
Nothing published for this version
- 7.6.217 Jul 2026
Release notes
Open source →7.6.2 (2026-07-17)
Bug Fixes
- fall back to first route if initial route isn't present when rehydrating (5b8e84d) - by @
- 7.6.116 Jul 2026
Release notes
Open source →7.6.1 (2026-07-16)
Bug Fixes
- add focused route to history when preload replaces it (0c702e8) - by @satya164
- don't handle reset for non-stale state with an invalid index (a106df1) - by @satya164
- fix incorrect tab history after navigationKey changes (b94faca) - by @satya164
- focus most recent route in history when focused route is removed (4411424) - by @satya164
- keep initial route params when going back with fullHistory (82c473f) - by @satya164
- preserve drawer status in history when changing index (a841d14) - by @satya164
- remove stale history entries when getId changes the route key (c2acdc5) - by @satya164
- 7.6.011 Jun 2026
Release notes
Open source →Additional notes
Open source → - 7.5.68 Jun 2026
Nothing published for this version
- 7.5.58 May 2026
- 7.5.47 May 2026
Nothing published for this version
- 7.5.317 Dec 2025
Nothing published for this version
- 7.5.220 Nov 2025
Nothing published for this version
- 7.5.126 Jul 2025
Nothing published for this version
- 7.5.025 Jul 2025
Release notes
Open source → - 7.4.114 Jun 2025
Nothing published for this version
- 7.4.030 May 2025
Nothing published for this version
- 7.3.74 May 2025
Nothing published for this version
- 7.3.62 May 2025
- 7.3.58 Apr 2025
Nothing published for this version
- 7.3.44 Apr 2025
Nothing published for this version
- 7.3.32 Apr 2025
Nothing published for this version
- 7.3.21 Apr 2025
Release notes
Open source → - 7.3.122 Mar 2025
Nothing published for this version
- 7.3.019 Mar 2025
Release notes
Open source → - 7.2.02 Mar 2025
Release notes
Open source → - 7.1.212 Dec 2024
Nothing published for this version
- 7.1.128 Nov 2024
Nothing published for this version
- 7.1.026 Nov 2024
Release notes
Open source → - 7.0.06 Nov 2024
Nothing published for this version
- 7.0.0-rc.87 Aug 2024pre-release
Nothing published for this version
- 7.0.0-rc.71 Aug 2024pre-release
Nothing published for this version
- 7.0.0-rc.611 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.57 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.44 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.34 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.24 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.11 Jul 2024pre-release
Nothing published for this version
- 7.0.0-rc.027 Jun 2024pre-release
Nothing published for this version
- 7.0.0-alpha.623 Feb 2024pre-release
Nothing published for this version
- 7.0.0-alpha.517 Jan 2024pre-release
Nothing published for this version
- 7.0.0-alpha.417 Nov 2023pre-release
Nothing published for this version
- 7.0.0-alpha.312 Nov 2023pre-release
Nothing published for this version
- 7.0.0-alpha.27 Sept 2023pre-release
Nothing published for this version
- 7.0.0-alpha.11 Mar 2023pre-release
Nothing published for this version