Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/winoteam/react-router-navigation
⛵️ A complete navigation library for React Native, React DOM and React Router
https://github.com/winoteam/react-router-navigation
navigation navigator react-native router tabs web
Last synced: 3 months ago
JSON representation
⛵️ A complete navigation library for React Native, React DOM and React Router
- Host: GitHub
- URL: https://github.com/winoteam/react-router-navigation
- Owner: winoteam
- License: mit
- Archived: true
- Created: 2016-07-23T21:41:15.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-10-05T22:28:50.000Z (about 3 years ago)
- Last Synced: 2024-07-31T09:34:37.088Z (3 months ago)
- Topics: navigation, navigator, react-native, router, tabs, web
- Language: JavaScript
- Homepage:
- Size: 16.3 MB
- Stars: 502
- Watchers: 21
- Forks: 49
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-list - react-router-navigation
README
# react-router-navigation
[![Build Status](https://travis-ci.org/winoteam/react-router-navigation.svg?branch=master)](https://travis-ci.org/winoteam/react-router-navigation)
[![npm version](https://badge.fury.io/js/react-router-navigation.svg)](https://badge.fury.io/js/react-router-navigation)
[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier)> ❌ This project is not maintained anymore ... go see [`react-navigation`](https://github.com/react-navigation/react-navigation)
**`react-router-navigation` provides tools to navigate between multiple screens with navigators or tab views. This library is based on `react-router`, `react-navigation`, and `react-native-tab-view`.**
## 🔥 Highlights
* **Just an add-on to [`react-router`](https://github.com/ReactTraining/react-router)**
* Declarative composability
* Allow you to call transitions anywhere in your code with simple components
* Dynamic Routing
* URL Driven Development
* Easy-to-use navigation solution using `react-navigation`
* Tab Bar Support using `react-native-tab-view`
* Cross-platform (iOS, Android and Web)
* First class deep linking support
* Nested Navigators
* [Fully-tested](https://facebook.github.io/jest/) & [strictly-typed](https://flow.org/)
* [TypeScript support](https://github.com/DefinitelyTyped/DefinitelyTyped/pull/23114)## 📟 Demos
* [Minimal native app](examples/minimal-native-app)
* [Real world native app](examples/real-world-native-app)
* [Polaris web app](examples/polaris-web-app) ➡️ [See it !](https://focused-blackwell-61841d.netlify.com/)## 💻 How to use
Install as project dependency:
```shell
$ yarn add react-router react-router-native react-router-navigation
```Now you can use React Router Navigation to navigate between your screens:
## 💡 Guide
To learn how the library work, head to this introduction written by [@CharlesMangwa](https://twitter.com/Charles_Mangwa): [Thousand ways to navigate in React-Native](https://medium.com/the-react-native-log/thousand-ways-to-navigate-in-react-native-f7a1e311a0e8)
## 📖 Docs
* [``](docs/NAVIGATION.md) handles the transition between different scenes in your app.
* [``](docs/TABS.md) make it easy to explore and switch between different views.
* [``](docs/BOTTOM_NAVIGATION.md) make it easy to explore and switch between top-level views in a single tap.
* Works great with [React Native web](https://github.com/necolas/react-native-web). [Getting started](docs/REACT_NATIVE_WEB.md)
* And some [performance tips](docs/PERFORMANCE.md)## 🕺 Contribute
**Want to hack on `react-router-navigation`? Awesome! We welcome contributions from anyone and everyone. :rocket:**
1. Fork this repository to your own GitHub account and then clone it to your local device
2. Install dependencies using Yarn: `yarn`
3. Ensure that the tests are passing using `yarn test`
4. Send a pull request 🙌Remember to add tests for your change if possible.
️
## 👋 QuestionsIf you have any questions, feel free to get in touch on Twitter [@Leo_LeBras](https://twitter.com/Leo_LeBras) or open an issue.
## 😍 Thanks
`react-router-navigation` is based on [React Router](https://github.com/reactjs/react-router). Thanks to Ryan Florence [@ryanflorence](https://twitter.com/ryanflorence), Michael Jackson [@mjackson](https://twitter.com/mjackson) and all the contributors for their work on [`react-router`](https://github.com/reactjs/react-router) and [`history`](https://github.com/mjackson/history).
Special thanks to [@ericvicenti](https://twitter.com/ericvicenti), [@skevy](https://twitter.com/skevy), [@satya164](https://twitter.com/satya164) and [@grabbou](https://twitter.com/grabbou) for their work on [`react-navigation`](https://github.com/react-community/react-navigation/) and [@satya164](https://twitter.com/satya164) for his work on [`react-native-tab-view`](https://github.com/react-native-community/react-native-tab-view).