A framework for building native apps with React.
JavaScript Java Objective-C C++ C Objective-C++ Other
Latest commit 212d31e Jan 22, 2017 @bvaughn bvaughn committed with facebook-github-bot Updated Systrace and RCTRenderingPerf to sync w/ React changes
A temporary React Native compatibility fix was added to React in commit [bba0d99](facebook/react@bba0d99) and subsequently removed in commit [e612826](facebook/react@e612826). I noticed this while testing the React Native fiber renderer and attempting to use `Systrace`.

This commit updates React Native to no longer rely on the deprecated method and module.

PS I'm not sure if I should also update `ReactDebugTool` with this commit or wait for a subsequent sync script to update it. I haven't committed to this repo before. Please advise. 😄
Closes #11970

Differential Revision: D4446219

Pulled By: bvaughn

fbshipit-source-id: f286b8a4d00cdcbfbb49f52b9f1db5231d453f4c
Failed to load latest commit information.
.github Ask for solutions in new issue template. Nov 11, 2016
Examples XHR: support typed arrays for request payloads Jan 21, 2017
IntegrationTests Cache policy control for image source Jan 18, 2017
JSCLegacyProfiler Add suport for JSC profiling on iOS 9 Nov 16, 2015
Libraries Updated Systrace and RCTRenderingPerf to sync w/ React changes Jan 22, 2017
React Add one more parameter(keyboardType) to AlertIOS.promot(). Jan 19, 2017
ReactAndroid XHR: support typed arrays for request payloads Jan 21, 2017
ReactCommon CatalystInstanceImpl.setSourceURL Jan 18, 2017
babel-preset Update babel-preset, filter path by identifiers. Nov 23, 2016
blog Blog post about new versions and release cadence Jan 9, 2017
bots Add icebox command Nov 23, 2016
docs Fix some typos in NativeModulesAndroid.md Jan 20, 2017
flow amend babel definitions to allow inline plugins without configuration Jan 20, 2017
gradle/wrapper Update gradle wrapper binary and scripts Sep 9, 2016
jest Add UIManager method mocks to jest/setup.js Jan 21, 2017
keystores Added ability to run Movies app with BUCK Feb 26, 2016
lib Reorganize core JS files Oct 11, 2016
local-cli Support copy to clipboard on Windows Jan 20, 2017
packager Fix typo in ResolutionRequest.js Jan 21, 2017
react-native-cli Run application using package.json scripts Jan 20, 2017
react-native-git-upgrade Fix react-native-git-upgrade by get package.json instead of selective… Dec 9, 2016
scripts Add an integration test for WebSocket Jan 16, 2017
website Add Tencent Classroom app to the Showcase Jan 21, 2017
.buckconfig Allow building UIExplorer with Buck Apr 12, 2016
.buckjavaargs limiting BUCK's memory for CI Feb 1, 2016
.editorconfig Fix indent of .gradle files Oct 19, 2016
.eslintignore [ReactNative] clean lint in all of Libraries/ May 19, 2015
.eslintrc XHR: support typed arrays for request payloads Jan 21, 2017
.flowconfig Fix the suppress comment regex for react_native Jan 19, 2017
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (… Oct 14, 2015
.gitignore Improve Android testing scripts Dec 14, 2016
.npmignore Merge rnpm into react-native May 20, 2016
.travis.yml Apple TV support 6: Add tvOS target to react-native-cli template project Dec 31, 2016
CONTRIBUTING.md Update Edit on GitHub links to point to master Aug 4, 2016
LICENSE Update license Mar 23, 2015
LICENSE-CustomComponents Add CustomComponents license Mar 26, 2015
LICENSE-docs More licenses Mar 25, 2015
LICENSE-examples More licenses Mar 25, 2015
PATENTS Update Patent Grant Apr 10, 2015
README.md Update React Native minimum OS version to iOS8 Sep 2, 2016
React.podspec Stop copying unused JS files into the Pods folder Jan 11, 2017
Releases.md Update `releases` to refer to month instead of two weeks Dec 2, 2016
Windows Fix tutorial link in README.md Jun 14, 2016
breaking-changes.md Update breaking-changes.md Jan 16, 2016
build.gradle Update gradle-download-task from 2.0.0 to 3.1.2 to fix boost zip down… Dec 8, 2016
circle.yml Re-enable Android e2e test Jan 16, 2017
cli.js packager: centralize babelRegisterOnly callsites Jan 6, 2017
gradlew Update gradle wrapper binary and scripts Sep 9, 2016
gradlew.bat Update gradle wrapper binary and scripts Sep 9, 2016
jest-preset.json Add missing slash. Dec 8, 2016
package.json Deploy v0.38.0 Jan 18, 2017
react.gradle Fix missing static images when using data binding Sep 28, 2016
rn-cli.config.js Add a local packager config, so that react can find react-native when… Jul 5, 2016
runXcodeTests.sh Add suggested ‘view size’ powers to -[RCTShadowView setFrame:] Mar 1, 2016
settings.gradle Android: TicTacToe Example Project Aug 9, 2016
setupBabel.js Fix packager breakages on node4 Jan 13, 2017


React Native Build Status Circle CI npm version

React Native enables you to build world-class application experiences on native platforms using a consistent developer experience based on JavaScript and React. The focus of React Native is on developer efficiency across all the platforms you care about - learn once, write anywhere. Facebook uses React Native in multiple production apps and will continue investing in React Native.

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.

Getting Started

Getting Help

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 ScrollView and 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

Running the examples on iOS

Now open any example (the .xcodeproj file in each of the Examples subdirectories) and hit Run in Xcode.

Running the examples on Android

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):
# Open the Movies app in your emulator

Extending React Native

  • Looking for a component? JS.coach
  • Fellow developers write and publish React Native modules to npm and open source them on GitHub.
  • Making modules helps grow the React Native ecosystem and community. We recommend writing modules for your use cases and sharing them on npm.
  • Read the guides on Native Modules (iOS, Android) and Native UI Components (iOS, Android) if you are interested in extending native functionality.


React Native is under active development. See the guide on upgrading React Native to keep your project up-to-date.

Opening Issues

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 is BSD licensed. We also provide an additional patent grant.

React documentation is Creative Commons licensed.

Examples provided in this repository and in the documentation are separately licensed, as are some of the custom components.