A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Jamon Holmgren 900f2df351 Adds links to the README for roadmap, releases, RFCs. Fixes the help link (#22548)
Summary:
This PR only contains README updates.

1. Adds roadmap link
2. Adds releases repo link
3. Adds discussions and proposals repo link
4. Fixes the help link (pointed to abandoned forum)
Pull Request resolved: https://github.com/facebook/react-native/pull/22548

Differential Revision: D13372704

Pulled By: cpojer

fbshipit-source-id: 3c04d00ae08281298a851ddd6ec38ff67c6add30
2018-12-06 19:35:14 -08:00
.appveyor Merge appveyor.yml with .appveyor/config.yml (#22529) 2018-12-05 10:19:01 -08:00
.circleci Fix code analysis bot failure to post lint warnings on pull requests 2018-12-05 13:15:56 -08:00
.github Make PR template consistent with Changelog (#22117) 2018-11-04 11:29:52 -08:00
ContainerShip Bump Android SDK to 28, Build Tools to 28.0.2, Gradle to 4.7, Gradle Plugin to 3.2.0 (#21632) 2018-12-05 09:06:31 -08:00
IntegrationTests Use `invariant` instead of `fbjs/lib/invariant` 2018-12-03 00:07:02 -08:00
Libraries Add Flow types for `Platform.select` [5/5] 2018-12-06 02:54:19 -08:00
RNTester Add detox tests for Switch (#22470) 2018-12-05 12:59:04 -08:00
React Inline `YGFloatOptional` completely 2018-12-06 07:38:43 -08:00
ReactAndroid Roll back `-ffast-math` 2018-12-06 07:38:43 -08:00
ReactCommon Don't pass `std::string` by pointer 2018-12-06 07:38:44 -08:00
bots Use Changelog instead of Release Notes for danger bot (#22395) 2018-11-27 12:38:22 -08:00
flow Use `invariant` instead of `fbjs/lib/invariant` 2018-12-03 00:07:02 -08:00
flow-github Use real flow types from metro 2018-11-22 12:27:10 -08:00
gradle/wrapper Bump Android SDK to 28, Build Tools to 28.0.2, Gradle to 4.7, Gradle Plugin to 3.2.0 (#21632) 2018-12-05 09:06:31 -08:00
jest Fix ActivityIndicator snapshot test, add toMatchShallowSnapshot 2018-12-05 17:23:42 -08:00
keystores Use fb_native_wrapper for all targets 2018-10-31 11:47:42 -07:00
lib
local-cli Use main.jsbundle in iOS template for production build (#22531) 2018-12-06 19:29:52 -08:00
react-native-cli JS: Upgrade to `chalk@^2.4.1` 2018-11-27 23:33:56 -08:00
react-native-git-upgrade
scripts Fix code analysis bot failure to post lint warnings on pull requests 2018-12-05 13:15:56 -08:00
third-party-podspecs Fix Xcode 10 builds (broken by folly upgrade) (#22394) 2018-11-26 01:41:15 -08:00
tools/build_defs Fix unmangled visibility in rn_defs 2018-11-27 13:46:24 -08:00
.buckconfig Bump Android SDK to 28, Build Tools to 28.0.2, Gradle to 4.7, Gradle Plugin to 3.2.0 (#21632) 2018-12-05 09:06:31 -08:00
.buckjavaargs
.editorconfig editorconfig: Set indent_size for BUCK files to 4 (#21554) 2018-10-08 23:17:38 -07:00
.eslintignore
.eslintrc eslint: Disable jasmine env and only enable jest env for test files 2018-11-27 03:51:02 -08:00
.flowconfig Use `invariant` instead of `fbjs/lib/invariant` 2018-12-03 00:07:02 -08:00
.flowconfig.android Use `invariant` instead of `fbjs/lib/invariant` 2018-12-03 00:07:02 -08:00
.gitattributes
.gitignore
.npmignore
.nvmrc
CODE_OF_CONDUCT.md
CONTRIBUTING.md
DockerTests.md Fix npm commands in DockerTests.md (#21758) 2018-10-12 14:43:40 -07:00
Jenkinsfile
LICENSE
LICENSE-docs
README.md Adds links to the README for roadmap, releases, RFCs. Fixes the help link (#22548) 2018-12-06 19:35:14 -08:00
React.podspec Upgrade folly to v2018.10.22.00 for iOS (#21976) 2018-10-29 12:13:11 -07:00
Releases.md
build.gradle Bump Android SDK to 28, Build Tools to 28.0.2, Gradle to 4.7, Gradle Plugin to 3.2.0 (#21632) 2018-12-05 09:06:31 -08:00
cli.js
gradlew
gradlew.bat
jest-preset.json
package.json Bump ws package to 1.1.5 due to vulnerability issues (#21769) 2018-12-03 22:21:56 -08:00
react.gradle Fix incorrect merged asset path with flavor for Android Gradle Plugin 3.2. (#21782) 2018-10-31 05:29:13 -07:00
rn-cli.config.js
rn-get-polyfills.js
runXcodeTests.sh
settings.gradle Fix jsc regression.Fixes #22274 (#22293) 2018-11-21 14:36:33 -08:00
setupBabel.js
yarn.lock Bump ws package to 1.1.5 due to vulnerability issues (#21769) 2018-12-03 22:21:56 -08: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. 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.