A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Kody Greenbaum 159adfb826 Adding Missing Optional Fields to ScrollEvent Type
Summary: Adding Velocity and targetContentOffset Fields to Scroll Event Type

Reviewed By: yungsters

Differential Revision: D9731754

fbshipit-source-id: e4ad89d66d0bb4344c717cf2d94027c54d346375
2018-09-11 10:22:39 -07:00
.circleci Bump Detox to 8.2.3 2018-08-28 12:59:37 -07:00
.github Change the number of days to kill stales from 3 to 7 (#21015) 2018-09-07 12:03:32 -07:00
ContainerShip Bump compileSdkVersion to 27 and buildToolsVersion to 27.0.3 (#20777) 2018-08-22 23:19:42 -07:00
IntegrationTests Typing View style as ViewStyleProp 2018-08-14 16:32:11 -07:00
Libraries Adding Missing Optional Fields to ScrollEvent Type 2018-09-11 10:22:39 -07:00
RNTester Use TextLegend example in Android as well 2018-09-07 11:31:54 -07:00
React Add the new RCTWKWebView* files to build target on iOS (#21031) 2018-09-10 18:17:30 -07:00
ReactAndroid Add more systrance on startup 2018-09-09 14:17:00 -07:00
ReactCommon Fabric: Unifying usage of `auto`s 2018-09-10 16:50:02 -07:00
bots Fix eslint code analysis bot (#20822) 2018-08-23 20:34:51 -07:00
flow JS: Switch to `nullthrows` Package [1/4] 2018-09-10 01:46:48 -07:00
flow-github Add DeltaBundler's Flow types to flow config (#20953) 2018-09-04 12:49:31 -07:00
gradle/wrapper fix gradle wrapper issue (#19976) 2018-08-08 15:03:01 -07:00
jest Add support for out-of-tree platform plugins (#20825) 2018-08-30 16:38:07 -07:00
keystores Apply auto-formatter for BUCK files in fbandroid. 2017-02-27 14:04:56 -08:00
lib Adding flow strict local to remaining possible files in xplat/JS 2018-08-09 08:54:44 -07:00
local-cli Fix Metro preset version (#21034) 2018-09-10 16:19:11 -07:00
react-native-cli added extra sinopia config to support packages (#20789) 2018-08-22 23:19:42 -07:00
react-native-git-upgrade ignore babelrc in git-upgrade (#20790) 2018-08-22 12:31:19 -07:00
scripts Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
third-party-podspecs Updated the glog library version from 0.3.4 to 0.3.5 (#20811) 2018-08-23 14:17:18 -07:00
tools/build_defs/oss Move RN's DEFS.bzl to tools and rename to rn_defs.bzl 2018-08-29 13:21:52 -07:00
.buckconfig Bump compileSdkVersion to 27 and buildToolsVersion to 27.0.3 (#20777) 2018-08-22 23:19:42 -07:00
.buckjavaargs
.editorconfig Fix indent of .gradle files 2016-10-19 16:58:36 -07:00
.eslintignore Split out docs to their own repo 2017-12-05 13:02:54 -08:00
.eslintrc Initial Detox E2E iOS configuration to be run on RNTester (#20235) 2018-07-30 14:31:24 -07:00
.flowconfig Deploy v0.80.0 to xplat/js 2018-09-05 08:48:31 -07:00
.flowconfig.android Deploy v0.80.0 to xplat/js 2018-09-05 08:48:31 -07:00
.gitattributes
.gitignore Check Flow and run basic packager tests using open source RN config 2018-08-09 16:17:40 -07:00
.npmignore Update .npmignore to include generated bundle file 2017-02-03 11:43:31 -08:00
.nvmrc Add .nvmrc + fix node version for eslint 5 compat (#20109) 2018-07-31 02:34:16 -07:00
CODE_OF_CONDUCT.md Update repo documentation to match other Facebook projects 2018-09-10 18:02:26 -07:00
CONTRIBUTING.md Update repo documentation to match other Facebook projects 2018-09-10 18:02:26 -07:00
DockerTests.md Typo in DockerTests.md (#20009) 2018-07-02 20:32:07 -07:00
Jenkinsfile Container Testing Updates 2017-04-12 16:31:35 -07:00
LICENSE Update to MIT license 2018-02-16 18:31:53 -08:00
LICENSE-docs
README.md Update repo documentation to match other Facebook projects 2018-09-10 18:02:26 -07:00
React.podspec Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
Releases.md Fix typo in Releases.md (#20487) 2018-08-01 07:16:56 -07:00
appveyor.yml Bump compileSdkVersion to 27 and buildToolsVersion to 27.0.3 (#20777) 2018-08-22 23:19:42 -07:00
build.gradle bump android gradle to 3.1.4 (#20767) 2018-08-22 23:19:42 -07:00
cli.js Prettier the rest of ReactNative 2018-05-11 13:52:30 -07:00
gradlew fix gradle wrapper issue (#19976) 2018-08-08 15:03:01 -07:00
gradlew.bat Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
jest-preset.json Fix jest snapshot testing on windows 2018-05-31 12:58:05 -07:00
package.json React: Upgrade to react-devtools@3.3.4 2018-09-10 14:47:11 -07:00
react.gradle Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
rn-cli.config.js Update license headers for MIT license 2018-02-16 18:31:53 -08:00
rn-get-polyfills.js Prettier the rest of ReactNative 2018-05-11 13:52:30 -07:00
runXcodeTests.sh Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
settings.gradle Back to JNI storage 2018-08-06 02:16:22 -07:00
setupBabel.js Prettier the rest of ReactNative 2018-05-11 13:52:30 -07:00
yarn.lock Update lock file for open source (#20800) 2018-08-22 23:04:56 -07:00

README.md

React Native · Circle CI Status Build status npm version PRs Welcome

Learn once, write anywhere: Build mobile apps with React.

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


Requirements

Supported target operating systems are >= Android 4.1 (API 16) and >= iOS 9.0. You may use Windows, macOS, or Linux as your development operating system, though building and running iOS apps is limited to macOS by default (tools like Expo can be used to get around this).

Building your first React Native app

Follow the Getting Started guide. The recommended way to install React Native depends on your project. Here you can find short guides for the most common scenarios:

How React Native works

React Native lets you build mobile apps using JavaScript. It uses the same design as React, letting you compose a rich mobile UI from declarative components.

With React Native, you don't build a "mobile web app", an "HTML5 app", or a "hybrid app". You build a real mobile app that's indistinguishable from an app built using Objective-C, Java, Kotlin, or Swift. React Native uses the same fundamental UI building blocks as regular iOS and Android apps. You just put those building blocks together using JavaScript and React.

React Native lets you build your app faster. Instead of recompiling, you can reload your app instantly. With hot reloading, you can even run new code while retaining your application state.

React Native combines smoothly with components written in Objective-C, Java, Kotlin, or Swift. It's simple to drop down to native code if you need to optimize a few aspects of your application. It's also easy to build part of your app in React Native, and part of your app using native code directly - that's how the Facebook app works.

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.

Full documentation

The full documentation for React Native can be found on our website. The source for the React Native documentation and website is hosted on a separate repo, https://github.com/facebook/react-native-website.

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.

Join the React Native community

See the CONTRIBUTING file for how to help out.

License

React Native is MIT licensed, as found in the LICENSE file.

React Native documentation is Creative Commons licensed, as found in the LICENSE-docs file.