React Native for macOS is an experimental fork for writing desktop apps using Cocoa
JavaScript Java Objective-C C++ Objective-C++ HTML Other
Clone or download
Latest commit fa52727 Aug 6, 2018
Permalink
Failed to load latest commit information.
.circleci Fix a couple of tests, use .macos suffix with integrations tests Mar 1, 2018
.github Update CODEOWNERS Dec 22, 2017
ContainerShip Fixing eslint-comments warnings Jan 9, 2018
IntegrationTests Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
Libraries Update AppearanceExample Aug 6, 2018
RNTester Update AppearanceExample Aug 6, 2018
React Fix #187: Add Screen to Dimensions and listen to changes Aug 6, 2018
ReactAndroid Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
ReactCommon Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
babel-preset Fix metro bundling not being able to resolve haste dependencies Apr 5, 2018
blog Update HTTP -> HTTPS in links in the docs Dec 25, 2017
bots Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
danger Update to Danger 2.0 Dec 22, 2017
flow-github Fix failure due to missing Metro flow types Dec 14, 2017
flow Switch `declare function exports` to `declare module.exports` Dec 19, 2017
gradle/wrapper Android - Update Gradle to 2.2.3 Jan 31, 2017
jest Fix Jest mocks for Dimensions module Dec 4, 2017
keystores Apply auto-formatter for BUCK files in fbandroid. Feb 27, 2017
lib Revert D5409825: [RN] Convert easy files to Prettier Jul 13, 2017
local-cli Fix #207 Aug 6, 2018
react-native-git-upgrade Update HTTP -> HTTPS in links in the docs Dec 25, 2017
react-native-macos-cli Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
scripts Fix metro bundling not being able to resolve haste dependencies Apr 5, 2018
third-party-podspecs Apple TV Cocoapods support Jul 18, 2017
.buckconfig update gitignore & fix links May 22, 2017
.editorconfig Fix indent of .gradle files Oct 19, 2016
.eslintignore Split out docs to their own repo Dec 5, 2017
.eslintrc Enable eslint-plugin-eslint-comments in RN Jan 9, 2018
.flowconfig Make RNTesterApp work at some extent, update license to MIT License. Feb 21, 2018
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (… Oct 14, 2015
.gitignore Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
.npmignore Update .npmignore to include generated bundle file Feb 3, 2017
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Oct 26, 2017
CONTRIBUTING.md Update HTTP -> HTTPS in links in the docs Dec 25, 2017
DockerTests.md Docker Testing Environment for Android & JS Feb 24, 2017
Jenkinsfile Container Testing Updates Apr 12, 2017
LICENSE Make RNTesterApp work at some extent, update license to MIT License. Feb 21, 2018
LICENSE-docs More licenses Mar 25, 2015
README.md Make RNTesterApp work at some extent, update license to MIT License. Feb 21, 2018
React.podspec Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
Releases.md Update Releases.md Jul 17, 2017
breaking-changes.md DOCS ONLY: Update breaking changes location in breaking-changes.md: m… Feb 3, 2017
build.gradle Update gradle-download-task from 2.0.0 to 3.1.2 to fix boost zip down… Dec 8, 2016
cli.js Revert D5409825: [RN] Convert easy files to Prettier Jul 13, 2017
gradlew Update gradle wrapper binary and scripts Sep 9, 2016
gradlew.bat Update gradle wrapper binary and scripts Sep 9, 2016
jest-preset.json Merge https://github.com/facebook/react-native into merge-0.52.0 Jan 28, 2018
package-lock.json Add cli options May 18, 2018
package.json Update AppearanceExample Aug 6, 2018
react.gradle Improve support for unbundle feature Oct 14, 2017
rn-cli.config.js Make the runBeforeMainModule config param to RN repo and make it abso… Sep 26, 2017
rn-get-polyfills.js Move Array<string> to $ReadOnlyArray<string>. Separate polyfill list … Jul 13, 2017
runXcodeTests.sh Re-license and rename UIExplorer integration test app as RNTester May 8, 2017
settings.gradle Cleanup settings.gradle Jul 28, 2017
setupBabel.js Rename metro-bundler to metro Nov 29, 2017
yarn.lock Update AppearanceExample Aug 6, 2018

README.md

React Native macOS (ex react-native-desktop)

Build macOS desktop applications using React Native.

Build Status npm version discord #react-native-platforms

<View>
  <Button onPress={() => alert('clicked!')} />
</View>

Getting Started

Node 4.x+, OS X 10.11+ required.

Previous React Native experience is highly recommended.

$ npm install react-native-macos-cli -g
$ react-native-macos init MyProject
$ cd MyProject
$ react-native-macos run-macos

If you want to add macOS target to the existing iOS/Android/Windows project, make the steps above, merge this new folder into your current React Native project, then put rn-cli.config.js in the root.

Documentation

Since React Native macOS is just a fork, you can follow the same instructions on the React Native Documentation.

Disclaimer

React Native macOS is a fork of React Native for iOS. The project is still a fairly new so proceed at your own risk.

Community Help

Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.

  • Ask a question on StackOverflow and tag it with react-native-macos
  • Chat with us on Reactiflux in #react-native-platforms (mentioning @ptmt)
  • DM @ptmt on twitter

Examples

RNTesterApp

RNTesterApp includes a set of component examples that illustrate their functionality. It also allows you to load external JavaScript bundle files through HTTP. Just copy and paste a URL into the Search Field.

Download UIExplorer

screenshot 2016-03-31 21 06 33

screenshot 2016-03-31 21 00 30

screenshot 2015-10-24 16 40 36

License

React Native is MIT licensed.