A framework for building native apps with React.
Clone or download
jbrown215 and facebook-github-bot @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup…
…pressions

Summary: Upgrades flow in xplat/js to 0.91. This diff also adds and removes suppressions.

Reviewed By: samwgoldman

Differential Revision: D13720697

fbshipit-source-id: 1bf8830ce286db92277476a2d2404cf0c0dddca2
Latest commit be51dbc Jan 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.appveyor Bump to Android Build Tools 28.0.3, Gradle 4.10.2, Gradle Plugin 3.2.1 Jan 11, 2019
.circleci fix validate-android-test-env.sh (#22961) Jan 14, 2019
.github Rearrange PR Template (#22683) Dec 17, 2018
ContainerShip fix validate-android-test-env.sh (#22961) Jan 14, 2019
IntegrationTests Fix RNTester Snapshot and Integration tests missing polyfills Jan 9, 2019
Libraries @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019
RNTester remove unused suppressions in xplat Jan 18, 2019
React Fabric: Even more systraces Jan 17, 2019
ReactAndroid Android TextInput: Fix updating of style props (#22994) Jan 18, 2019
ReactCommon Fabric: Clear separation between `commmit` and `tryCommit` Jan 17, 2019
bots Use Changelog instead of Release Notes for danger bot (#22395) Nov 27, 2018
codegen Use Generated Switch Schema Jan 16, 2019
flow-typed/npm remove deprecated utilities Jan 15, 2019
flow Replace our local types by flow-typed (#20320) Dec 20, 2018
gradle/wrapper Use new JavaScriptCore from npm (#22231) Dec 27, 2018
jest Fix Jest mocks Dec 30, 2018
keystores Use fb_native_wrapper for all targets Oct 31, 2018
lib Update copyright headers to yearless format Sep 11, 2018
local-cli Remove remaining references to local-cli Dec 11, 2018
react-native-git-upgrade Fix no shadow warnings (#22190) Jan 2, 2019
scripts - Fix failing to bundle in Release build with ndenv of anyenv by supp… Jan 16, 2019
template @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019
third-party-podspecs Fix Xcode 10 builds (broken by folly upgrade) (#22394) Nov 26, 2018
tools/build_defs Fix Skylint warnings in rn_defs.bzl. Dec 19, 2018
.buckconfig Bump Android SDK to 28, Build Tools to 28.0.2, Gradle to 4.7, Gradle … Dec 5, 2018
.buckjavaargs limiting BUCK's memory for CI Feb 1, 2016
.editorconfig editorconfig: Set indent_size for BUCK files to 4 (#21554) Oct 9, 2018
.eslintignore Split out docs to their own repo Dec 5, 2017
.eslintrc Remove references to `local-cli` Dec 7, 2018
.flowconfig @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019
.flowconfig.android @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (… Oct 14, 2015
.gitignore Check Flow and run basic packager tests using open source RN config Aug 9, 2018
.nvmrc Add .nvmrc + fix node version for eslint 5 compat (#20109) Jul 31, 2018
CODE_OF_CONDUCT.md Update repo documentation to match other Facebook projects Sep 11, 2018
CONTRIBUTING.md Update repo documentation to match other Facebook projects Sep 11, 2018
DockerTests.md Fix npm commands in DockerTests.md (#21758) Oct 12, 2018
Jenkinsfile Container Testing Updates Apr 12, 2017
LICENSE Update copyright headers to yearless format Sep 11, 2018
LICENSE-docs More licenses Mar 25, 2015
README.md Update README.md (#20867) Dec 10, 2018
React.podspec Upgrade folly to v2018.10.22.00 for iOS (#21976) Oct 29, 2018
Releases.md Fix typo in Releases.md (#20487) Aug 1, 2018
build.gradle bump android gradle plugin to 3.3.0 (#22988) Jan 15, 2019
cli.js Remove remaining references to local-cli Dec 11, 2018
gradlew fix gradle wrapper issue (#19976) Aug 8, 2018
gradlew.bat Use new JavaScriptCore from npm (#22231) Dec 27, 2018
jest-preset.js fix: use `require.resolve` in `jest-preset` (#22972) Jan 15, 2019
package.json @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019
react.gradle Copy bundled resources and js in Android App Bundle builds (#21738) Jan 15, 2019
rn-cli.config.js Update copyright headers to yearless format Sep 11, 2018
rn-get-polyfills.js Remove global babelHelpers and regenerator (#21283) Sep 26, 2018
runXcodeTests.sh Update copyright headers to yearless format Sep 11, 2018
settings.gradle Fix jsc regression.Fixes #22274 (#22293) Nov 21, 2018
yarn.lock @allow-large-files [flow] Bump xplat/js to 0.91 and remove unused sup… Jan 18, 2019

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. You can learn more about our open source roadmap in this blog post: Open Source Roadmap.

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. Releases are discussed in the React Native Community, https://github.com/react-native-community/react-native-releases, and larger discussions and proposals are in https://github.com/react-native-community/discussions-and-proposals.

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.