GithubHelp home page GithubHelp logo

longsight / react-navigation Goto Github PK

View Code? Open in Web Editor NEW

This project forked from react-navigation/react-navigation

0.0 2.0 0.0 8.52 MB

Learn once, navigate anywhere

Home Page: https://reactnavigation.org

License: Other

JavaScript 95.53% Shell 0.20% HTML 0.20% CSS 4.08%

react-navigation's Introduction

React Navigation CircleCI npm version codecov PRs Welcome

Learn once, navigate anywhere.

React Navigation is born from the React Native community's need for an extensible yet easy-to-use navigation solution based on Javascript.

React Navigation is the result of a collaboration between developers from Facebook, Expo and the React community at large: it replaces and improves upon several navigation libraries in the ecosystem, including Ex-Navigation, React Native's Navigator and NavigationExperimental components.

Installation

Since the library is a JS-based solution, to install the latest version of react-navigation you only need to run:

yarn add react-navigation

or

npm install --save react-navigation

Get Started

To learn how the library work, head to the introduction on the website for a quick tutorial that will cover all the basics - or try it out our expo demo.

Advanced guides

React Navigation API

Community contributions

A lot of developers poured their knowledge in blog posts, and other repos - we will try to keep here a list of tutorials and resources to help someone who wants to learn about React Navigation and techniques to handle navigation effectively.

Introduction to the library

Basic Tutorials

Intermediate Concepts

Advanced Topics

Comparisons and Discussion

Example Projects

Libraries

FAQs

When is version 1.0.0 going to be released?

As soon as all the tasks here have been completed. You can read more about it in the blog.

(in the meantime, you can find the changelog for every release here)

I'm having troubles using the library, what can I do?

Head to the issues and do a quick search: if you think you are experiencing a bug chances are somebody already opened an issue for it. If instead you are having more general problems, use Stack Overflow - which is better suited and helps keeping the Issues section of the repo clean. Alternatively you could join the Reactiflux community on Discord where there are React Native and React Navigation channels with helpful people who might be able to answer you.

You should only open a new issue if you believe that you are experiencing a bug or have a feature request, and please follow the dedicated template - it will help everyone helping you (and may get closed if it doesn't).

My app is really slow!

We are aware that the performances can be improved - we will work on this (keep an eye on the roadmap linked above). In the meantime, please refer to these few issues for specific information regarding:

In particular, refer to this comment (and the one after that) to learn more about how you can try improving the performance of your code.

How can I help?

Glad you ask! This library is a community effort: it can only be great if we all help out in one way or another πŸ˜„ . If you feel like you aren't experienced enough using react navigation to contribute, you can still make an impact by:

  1. Responding to one of the open issues. Even if you can't resolve or fully answer a question, asking for more information or clarity on an issue is extremely beneficial for someone to come after you to resolve the issue.

  2. Creating public example repos of navigation problems you have solved.

  3. Answering questions on Stack Overflow. Alternatively, asking questions on Stack Overflow instead of opening an issue.

  4. Answering questions in our Reactiflux channel.

  5. Providing feedback on the open PRs.

If you feel brave enough you can submit a PR: follow the Contributors guide to find out how. If you don't know where to start, check the ones with the label good first issue - even fixing a typo in the documentation is a worthy contribution!

Is this the only library available for navigation?

No: there are some other libraries - which, depending on your project, can be better or worse suited for your project. They differ in the approach and implementation from react-navigation, but share the common goal of helping you create a good React Native application; you can find a general round up in the React Native docs.

Can I use this library for web?

This library originally planned to support web too - but at the moment it is not a priority for v1.0; a lot of work is necessary to reach it as-is and we had to freeze this support (consider it "experimental").

Code of conduct

This library has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

License

React-navigation is licensed under the BSD 2-clause "Simplified" License.

react-navigation's People

Contributors

ashoat avatar brentvatne avatar charpeni avatar cooperka avatar danielmschmidt avatar dantman avatar davepack avatar dmhood avatar fiberjw avatar fson avatar gabrielbull avatar grabbou avatar hilkeheremans avatar jkimbo avatar joemckie avatar juhasuni avatar kelset avatar knowbody avatar koenpunt avatar matthamil avatar nihgwu avatar plasticine avatar probeadd avatar puercopop avatar satya164 avatar skevy avatar spencercarli avatar thurt avatar vonovak avatar wschurman avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.