A framework for building native apps with React.
JavaScript Java Objective-C C++ Python C Other
Permalink
Failed to load latest commit information.
Examples Complete work on ImageLoader May 4, 2016
IntegrationTests Fix up this pattern var React = require('react-native'); Apr 9, 2016
JSCLegacyProfiler Add suport for JSC profiling on iOS 9 Nov 16, 2015
Libraries Fix unimplemted paths for Picker. Aug 18, 2016
React Fixed deadlock during app startup Apr 27, 2016
ReactAndroid Fix crash caused by accessibility being turned on and using a Modal Apr 27, 2016
ReactUbuntu Cleanup Jul 29, 2016
Tools/FBPortForwarding Open source FBPortForwarding Mar 24, 2016
babel-preset Fixed HMR for React Native Android Apr 25, 2016
blog Fix website Mar 25, 2016
bots Add `cla` command Apr 22, 2016
docs Android Support Repository -> Local Maven repository for Support Libr… Apr 27, 2016
flow Deploy v0.23.0 Apr 14, 2016
gradle/wrapper Added ability to run Movies app with BUCK Feb 26, 2016
jestSupport Update Jest to 0.9.0 Mar 15, 2016
keystores Added ability to run Movies app with BUCK Feb 26, 2016
local-cli Enable creation of react-native deb package. Aug 11, 2016
packager Merge branch 'master' of https://github.com/facebook/react-native int… Apr 28, 2016
react-native-cli Make sure to specify build deps for cli package. Aug 18, 2016
scripts Optimise e2e tests retries Apr 25, 2016
website merge InteractionManager stuff back into PanResponder Apr 26, 2016
.buckconfig Allow building UIExplorer with Buck Apr 12, 2016
.buckjavaargs limiting BUCK's memory for CI Feb 1, 2016
.editorconfig Create .editorconfig Oct 9, 2015
.eslintignore [ReactNative] clean lint in all of Libraries/ May 19, 2015
.eslintrc Removed eslint rule that checks modules Mar 10, 2016
.flowconfig Fix or suppress errors in react-native Apr 22, 2016
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (… Oct 14, 2015
.gitignore Merge branch 'master' into ubuntu Apr 27, 2016
.travis.yml Optimise e2e tests retries Apr 25, 2016
CMakeLists.txt Update copyright notices. May 30, 2016
CONTRIBUTING.md add instructions for testing website locally Mar 18, 2016
ISSUE_TEMPLATE.md Update PR and issue templates and guidelines Mar 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
PULL_REQUEST_TEMPLATE.md Tweak commands and guidelines Mar 20, 2016
README-ubuntu.md Update README Aug 4, 2016
README.md removed bithound badge Mar 1, 2016
React.podspec Add .mm to React.podspec Apr 22, 2016
Releases.md Updates to release notes Apr 19, 2016
breaking-changes.md Update breaking-changes.md Jan 16, 2016
build.gradle Support non-standard path of Android Support Repository Apr 21, 2016
circle.yml Optimise e2e tests retries Apr 25, 2016
cli.js Breaking change: Move `bundle` to `private-cli` Oct 13, 2015
gradlew Upgrade gradle to 2.9 Dec 14, 2015
gradlew.bat Release React Native for Android Sep 14, 2015
package.json Merge branch 'master' into ubuntu Apr 27, 2016
react.gradle Apply react.gradle from node_modules/react-native Mar 29, 2016
runXcodeTests.sh Add suggested ‘view size’ powers to -[RCTShadowView setFrame:] Mar 1, 2016
settings.gradle Delete SampleApp Sep 29, 2015

README.md

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 7.0.

Introduction

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.

Documentation

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.

Examples

  • 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):
./packager/packager.sh
# 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.

Upgrading

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.

Contributing

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!

License

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.