Supported operating systems are >= Android 4.1 (API 16) and >= iOS 8.0.
See the official React Native website for an introduction to React Native.
Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.
The website’s documentation is divided into multiple sections.
Another great way to learn more about the components and APIs included with React Native is to read their source. Look under the
Libraries directory for components like
Navigator, for example. The UIExplorer example is also here to demonstrate some of the ways to use these components. From the source you can get an accurate understanding of each component’s behavior and API.
The React Native documentation only discusses the components, APIs and topics specific to React Native (React on iOS and Android). For further documentation on the React API that is shared between React Native and React DOM, refer to the React documentation.
git clone https://github.com/facebook/react-native.git
cd react-native && npm install
Now open any example (the
.xcodeproj file in each of the
Examples subdirectories) and hit Run in Xcode.
Note that you'll need the Android NDK installed, see prerequisites.
./gradlew :Examples:Movies:android:app:installDebug# Start the packager in a separate shell (make sure you ran npm install):./packager/packager.sh# Open the Movies app in your emulator
React Native is under active development. See the guide on upgrading React Native to keep your project up-to-date.
If you encounter a bug with React Native we would like to hear about it. Search the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of React Native and OS you’re using. Please include a stack trace and reduced repro case when appropriate, too.
The GitHub issues are intended for bug reports and feature requests. For help and questions with using React Native please make use of the resources listed in the Getting Help section. Product Pains in particular is a good way to signal your interest in a feature or issue. There are limited resources available for handling issues and by keeping the list of open issues lean we can respond in a timely manner.
For more information about contributing PRs and issues, see our Contribution Guidelines.
Good First Task is a great starting point for PRs.
We encourage the community to ask and answer questions on Stack Overflow with the react-native tag. It's a great way to help out and be involved!
React documentation is Creative Commons licensed.