A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Brent Vatne 4fd0a2de0d [Docs] Update known issues 2015-09-14 23:32:45 -07:00
Examples Release React Native for Android 2015-09-14 18:13:39 +01:00
IntegrationTests/IntegrationTests.xcodeproj/xcshareddata/xcschemes [ReactNative] Merge IntegrationTest into UIExplorer tests 2015-06-06 13:38:35 -08:00
JSCLegacyProfiler Automatically save and convert JavaScript profile to chrome format 2015-09-11 06:40:26 -07:00
Libraries Release React Native for Android 2015-09-14 18:13:39 +01:00
React Added toggle items to dev menu 2015-09-14 09:40:33 -07:00
ReactAndroid Release React Native for Android 2015-09-14 18:13:39 +01:00
docs [Docs] Update known issues 2015-09-14 23:32:45 -07:00
gradle/wrapper Release React Native for Android 2015-09-14 18:13:39 +01:00
jestSupport [ReactNative] Fix MessageQueue-test on open source 2015-06-18 08:56:33 -08:00
local-cli Release React Native for Android 2015-09-14 18:13:39 +01:00
packager Fix various issues with packager editor launcher 2015-09-14 10:00:26 -07:00
react-native-cli Release React Native for Android 2015-09-14 18:13:39 +01:00
react-native-gradle Release React Native for Android 2015-09-14 18:13:39 +01:00
scripts [Travis] Update CI to run with Xcode 6.4 2015-09-04 02:39:37 -07:00
website missing semicolon in Java example. 2015-09-15 01:32:50 +02:00
.eslintignore [ReactNative] clean lint in all of Libraries/ 2015-05-19 13:47:04 -08:00
.eslintrc Fix "global-strict" lint 2015-09-09 11:25:18 -07:00
.flowconfig Deploy 0.15.0 2015-09-11 17:01:38 -07:00
.gitignore Release React Native for Android 2015-09-14 18:13:39 +01:00
.travis.yml [Travis] Update CI to run with Xcode 6.4 2015-09-04 02:39:37 -07:00
CONTRIBUTING.md [README] Added note about squashing commits to the Contributing page 2015-09-07 23:32:31 -07:00
LICENSE Update license 2015-03-23 10:48:39 -07:00
LICENSE-CustomComponents Add CustomComponents license 2015-03-26 11:03:30 -07:00
LICENSE-docs More licenses 2015-03-24 19:59:10 -07:00
LICENSE-examples More licenses 2015-03-24 19:59:10 -07:00
PATENTS Update Patent Grant 2015-04-10 12:14:22 -07:00
README.md Release React Native for Android 2015-09-14 18:13:39 +01:00
React.podspec Release React Native for Android 2015-09-14 18:13:39 +01:00
build.gradle Release React Native for Android 2015-09-14 18:13:39 +01:00
cli.js Simplify cli.js 2015-04-07 12:17:52 -07:00
gradlew Release React Native for Android 2015-09-14 18:13:39 +01:00
gradlew.bat Release React Native for Android 2015-09-14 18:13:39 +01:00
npm-shrinkwrap.json [npm] Fix connect/ 2015-09-08 11:31:52 -08:00
package.json Release React Native for Android 2015-09-14 18:13:39 +01:00
runXcodeTests.sh tweak build script. 2015-03-26 09:17:17 -07:00
settings.gradle Release React Native for Android 2015-09-14 18:13:39 +01:00

README.md

React Native 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.

Introduction

See the official React Native website for an introduction to React Native.

Getting Started

Getting Help

Documentation

The websites documentation 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 components 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

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

Extending React Native

  • Looking for a component? react.parts
  • 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.

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 doesnt already exist before opening a new issue. Its helpful if you include the version of React Native and OS youre 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. 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, see our Contribution Guidelines.

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.