Skip to content


Choose a tag to compare
@mjackson mjackson released this 31 Jan 23:03

First alpha release of the next major version of React Router, version 6. A few of the highlights are:

  • Relative routes and links
  • Nested <Route>s
  • Automatic<Route> ranking with a new <Routes> API
  • New suspense-ready navigate API
  • useRoutes + matchRoutes for using object-based routing API

Development for v6 is happening on the dev branch.

If you'd like to test it out, install from npm:

$ npm install history@5 react-router@6 react-router-dom@6

Or, if you're on React Native:

$ yarn add history@5 react-router@6 react-router-native@6

We are actively working on documentation. For now, if you're just interested in testing things out you may be interested in the getting started guide. If you're interested in upgrading an existing app, please check out the v5 to v6 migration guide.

Please note that although there are several breaking changes we are still working on the migration path and will continue to publish improvements and helpers in v5 that should help you upgrade as smoothly as possible. We are not done with v5. Heck, we're still cutting releases of v3.

This release addresses several long-standing issues and pitfalls with previous releases. We are focused on providing a smooth upgrade path for both v4/5 users and v3 users who would like to make the jump to v6. We will be publishing more very soon.