A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Eli White 2f32fea79a Remove LayoutStyle, ShadowStyle, TransformStyle in favor of just ViewStyleProp
Summary: We are working to remove additional types and eventually define everything at the top level as a public exported type of react-native. I was able to update callsites by just using ViewStyleProp in places that were expecting a prop of just one of these. It is a little bit weaker, but much simpler. If a callsite wants to only take margin, it should just take a margin prop instead of a LayoutStyle prop.

Reviewed By: rickhanlonii

Differential Revision: D13599460

fbshipit-source-id: 12c01bc58baa7f6acf33e0b8aab05dabb79c646b
2019-01-08 18:49:37 -08:00
.appveyor fix windows ci 2018-12-07 14:16:45 -08:00
.circleci test_ios → : Update iOS Snapshots, remove tvOS tests, disable failing tests (#22720) 2018-12-20 15:08:47 -08:00
.github Rearrange PR Template (#22683) 2018-12-17 15:43:41 -08:00
ContainerShip Fix CircleCI build error (#22822) 2018-12-30 10:47:10 -08:00
IntegrationTests Use `invariant` instead of `fbjs/lib/invariant` 2018-12-03 00:07:02 -08:00
Libraries Remove LayoutStyle, ShadowStyle, TransformStyle in favor of just ViewStyleProp 2019-01-08 18:49:37 -08:00
RNTester Fix rerender count on RNTester blue tab (#22876) 2019-01-07 15:32:01 -08:00
React Unify native props 2019-01-07 15:39:21 -08:00
ReactAndroid Android TextInput: Improve application of styles for `value` prop (#22461) 2019-01-08 15:58:43 -08:00
ReactCommon Using ENUM_BITFIELDS_NOT_SUPPORTED for enum bitfields 2019-01-08 16:22:29 -08:00
bots Use Changelog instead of Release Notes for danger bot (#22395) 2018-11-27 12:38:22 -08:00
codegen Open source the Codegen! 2018-12-20 11:58:11 -08:00
flow Replace our local types by flow-typed (#20320) 2018-12-20 04:42:34 -08:00
flow-typed/npm Replace our local types by flow-typed (#20320) 2018-12-20 04:42:34 -08:00
gradle/wrapper Use new JavaScriptCore from npm (#22231) 2018-12-27 14:51:03 -08:00
jest Fix Jest mocks 2018-12-30 13:31:16 -08:00
keystores Use fb_native_wrapper for all targets 2018-10-31 11:47:42 -07:00
lib Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
local-cli Remove remaining references to local-cli 2018-12-10 19:08:10 -08:00
react-native-git-upgrade Fix no shadow warnings (#22190) 2019-01-01 17:13:15 -08:00
scripts Fix no shadow warnings (#22190) 2019-01-01 17:13:15 -08:00
template Use new JavaScriptCore from npm (#22231) 2018-12-27 14:51:03 -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 Skylint warnings in rn_defs.bzl. 2018-12-19 10:50:49 -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 limiting BUCK's memory for CI 2016-02-01 10:49:33 -08:00
.editorconfig editorconfig: Set indent_size for BUCK files to 4 (#21554) 2018-10-08 23:17:38 -07:00
.eslintignore Split out docs to their own repo 2017-12-05 13:02:54 -08:00
.eslintrc Remove references to `local-cli` 2018-12-07 07:49:18 -08:00
.flowconfig Replace our local types by flow-typed (#20320) 2018-12-20 04:42:34 -08:00
.flowconfig.android Replace our local types by flow-typed (#20320) 2018-12-20 04:42:34 -08:00
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (gradlew and 2015-10-13 23:10:39 -04:00
.gitignore Check Flow and run basic packager tests using open source RN config 2018-08-09 16:17:40 -07: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 Fix npm commands in DockerTests.md (#21758) 2018-10-12 14:43:40 -07:00
Jenkinsfile Container Testing Updates 2017-04-12 16:31:35 -07:00
LICENSE Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
LICENSE-docs More licenses 2015-03-24 19:59:10 -07:00
README.md Update README.md (#20867) 2018-12-09 22:27:11 -08:00
React.podspec Upgrade folly to v2018.10.22.00 for iOS (#21976) 2018-10-29 12:13:11 -07:00
Releases.md Fix typo in Releases.md (#20487) 2018-08-01 07:16:56 -07:00
build.gradle Use new JavaScriptCore from npm (#22231) 2018-12-27 14:51:03 -08:00
cli.js Remove remaining references to local-cli 2018-12-10 19:08:10 -08:00
gradlew fix gradle wrapper issue (#19976) 2018-08-08 15:03:01 -07:00
gradlew.bat Use new JavaScriptCore from npm (#22231) 2018-12-27 14:51:03 -08:00
jest-preset.json Make jest react-native preset to use typescript files (#22217) 2018-12-09 20:07:09 -08:00
package.json Fix test ci reporter (#22749) 2018-12-21 17:37:50 -08:00
react.gradle Remove remaining references to local-cli 2018-12-10 19:08:10 -08:00
rn-cli.config.js Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
rn-get-polyfills.js Remove global babelHelpers and regenerator (#21283) 2018-09-26 10:03:05 -07:00
runXcodeTests.sh Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
settings.gradle Fix jsc regression.Fixes #22274 (#22293) 2018-11-21 14:36:33 -08:00
yarn.lock Upgrade metro packages on React Native 2018-12-21 04:19:57 -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.