[npm-badge]: https://img.shields.io/npm/v/react-router-dom.svg?style=flat-square

[npm]: https://www.npmjs.org/package/react-router-dom

[build-badge]: https://img.shields.io/github/workflow/status/remix-run/react-router/test/dev?style=flat-square

[build]: https://github.com/remix-run/react-router/actions/workflows/test.yml

React Router is a lightweight, fully-featured routing library for the React JavaScript library. React Router runs everywhere that React runs; on the web, on the server (using node.js), and on React Native.

If you're new to React Router, we recommend you start with the tutorial.

If you're migrating to v6 from v5 (or v4, which is the same as v5), check out the migration guide. If you're migrating from Reach Router, check out the migration guide for Reach Router. If you need to find the code for v5, [it is on thev5 branch](https://github.com/remix-run/react-router/tree/v5).

When v6 is stable we will publish the docs on our website.

There are many different ways to contribute to React Router's development. If you're interested, check out our contributing guidelines to learn how you can get involved.

This repository is a monorepo containing the following packages:

- [react-router](/packages/react-router)

- [react-router-dom](/packages/react-router-dom)

- [react-router-native](/packages/react-router-native)

Detailed release notes for a given version can be found on our releases page.

You may provide financial support for this project by donating via Open Collective. Thank you for your support!

React Router is developed and maintained by Remix Software and many amazing contributors.