This is a preview of the new router for React Native apps. It is currently in alpha and is not ready for production use. The repo also acts as an RFC for the router. Please open a discussion if you have any questions or feedback.
- Router - Current implementation.
- Documentation - Current documentation for the router (WIP / RFC).
- Example - Test app.
- RFC - Add your feedback here.
The easiest way to try Expo Router is by creating a new project:
npx create-react-native-app -t with-router
If you want to work against the latest branch for contributions, you can use apps/demo.
apps/demois a basic playground for developing the Expo Router package, please don't open PRs specifically to improve the tester.
- Run
yarnin the root of the repo to install dependencies. - Run
yarn startin the root to compile thepackages/ - Change directory to
apps/demoand runyarn startto start the demo app. - Modify the contents of
apps/demo/app/to use the router.
The router demo uses a custom version of Metro, this may cause conflicting version issues that lead to require.resolve cannot be found. If this happens, you can run yarn in the root of the repo and restart the dev server.