Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit



Failed to load latest commit information.
Latest commit message
Commit time
February 4, 2019 16:38
December 22, 2017 10:13
October 11, 2016 10:14
April 12, 2017 16:31
March 24, 2015 19:59
May 13, 2020 14:36
July 17, 2017 14:22
October 1, 2019 08:57


The project is no longer maintained.

There is an Microsoft version:

You can run React Native on Catalyst react-native-community/discussions-and-proposals#131

React Native macOS (ex react-native-desktop)

Build macOS desktop applications using React Native.

Build Status npm version discord #react-native-platforms

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

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.


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


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



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


React Native is MIT licensed.