How to Develop iOS Apps on Linux using React Native

Hey there, Linux user!

Are you trying to develop iOS apps, but don't want to spring for a Mac?

Or, perhaps you have plenty of cash, but using a closed-source operating system brings you pain?

I know what you're going through.

The bad news is that Apple, officially speaking, requires that all iOS apps be built on Mac OS X.

The good news is that there are a few loopholes to get around this.

Would Steve still be smug if he knew we were writing apps on Linux?


For the sake of this article, I'm going to presume that:

  1. You have access to an Apple Developer Account
  2. You have an iOS device
  3. You don't have a Mac.

I'll also show you how to get up and running using two approaches:

Solution A: You have one-time access to a Mac.
Solution B: You don't have access to a Mac, at all.

Solution A: One-time Access to a Mac

The approach that we are going to take is to point your iOS app at your Linux machine so that you can write your Javascript code on the Linux machine and run your code on your iOS device.

In order to get up and running, you'll need a Mac in order to build the native code and deploy the app onto the device for the first time, but once the app is deployed, you'll be able to use Javascript to do anything doesn't involve changing the native code.

Mac for native code, Linux for Javascript

So, borrow a Mac from your neighbor and follow these steps:

Getting Started

Launch Xcode

First, you'll need to launch Xcode by opening the following file: PROJECT_ROOT/ios/PROJECT_NAME.xcodeproj.

You can open it using the Finder, the Terminal, or by using File > Open within Xcode.

NOTE: This file should have been generated when you ran react-native init to create your project.

Once you open the project, you should be greeted by the following screen:

Welcome to Xcode.

Adding a Configurable Server IP Address

Add a iOS Settings Entry Using Settings.bundle

Now that we're in Xcode, the next thing we need to do is to add a Settings screen to our app.

As described on the Apple developer documentation, we'll add a Settings.bundle file.

The goal is to create an entry in the iOS Settings for our LinuxExample app, like this:

System Settings: Menu

To add the Settings.bundle file, you need to right-click the file list and click "Add Files to ..."

Add Files to Project

Next step: you need to select a file type.

You want Resources -> Settings.Bundle.

Adding File: File Type

Last step: tell Xcode where to put Settings.Bundle.

You want to make sure that this is in PROJECT_ROOT/ios/PROJECT_NAME/. In my case, this is LinuxExample/ios/LinuxExample/.

Once you've selected the location, click create.

Adding File: Where to Save

With the file added, you should be able to run the app. Use the play button in the top left of Xcode. Or hit ⌘-R.

Press Play

If everything worked, you should see your app running!

Hello World

After running the App, hit the home button, go to Settings and scroll all the way to the bottom. You should see your app! In our case, it's "LinuxExample."

Settings Menu Entry

Click YourApp/LinuxExample and you'll see some default options in here.

System Settings: Slider, etc

Edit Settings.bundle

Now that we have our settings screen up and running, it's time to change our Settings.bundle so that we can configure our server's host and port.

First, open Root.plist inside Settings.bundle. You may need to click the arrow next to Settings.bundle to reveal Root.plist.

You should see four "preference items" inside of it. You may need to click the arrow next to "preference items" in order to reveal the preference Item 0, 1, 2, 3.

Original Settings.bundle/Root.plist

Now we want to change Root.plist such that we have three preference items:

  • Group marker
  • Text Field, with name "host_preference" and default value of "localhost"
  • Text Field, with name "port_preference" and default value of "8081"

See below image for an example:

Updated Settings.bundle/Root.plist

Once you've made these changes, if you run the app again, you should be able to see Host and Port in the settings screen instead of the slider, etc.

System Settings: Slider, etc

NOTE: you may need to uninstall and reinstall the app after changing the Settings.bundle file.

Edit AppDelegate.m

The next step is to actually make use of the host and port that we are setting.

So jump into AppDelegate.m and find the line where you set the jsCodeLocation.

By default, it's on line 34 and it should look like this:

  jsCodeLocation = [NSURL URLWithString: @"http://localhost:8081/index.ios.bundle?platform=ios&dev=true"];

You want to go in there and change it to the following:

  NSString *host = [[NSUserDefaults standardUserDefaults] stringForKey: @"host_preference"];
  NSString *port = [[NSUserDefaults standardUserDefaults] stringForKey: @"port_preference"];

  NSString * urlString = [NSString stringWithFormat: @"http://%@:%@/index.ios.bundle?platform=ios&dev=true", host, port];
  jsCodeLocation = [NSURL URLWithString: urlString];

This code will pull the host and port number out of the app's settings and make the server URL from them.

Finally, in order for our app to properly load its settings from iOS, we need to provide some default values for our preferences.

For this, we go to the top of didFinishLaunchingWithOptions and add the following code:

NSDictionary *appDefaults = @{
    @"host_preference": @"localhost",
    @"port_preference": @"8081",
[[NSUserDefaults standardUserDefaults] registerDefaults:appDefaults];

And that's it for code! Congratulations!

iOS Device

You COULD build it for the iOS simulator, but the iOS simulator needs to run on Mac OS X. And for the sake of this tutorial, I'm presuming that you won't be able to use a Mac day-to-day.

The solution? Use an iOS device.

If you're developing an iOS app, you should have access to an iPhone, iPad, or iPod Touch.

An iPod touch, for example is only $200 USD. If you're a professional developer, you should be able to afford that. (Or get your boss to pay for it!).

Building the Code

First, you need to go to the build target selector in the top of the screen and select your iOS device.

Target the Device

With your device selected, build and run the code and your app should be on your iPhone!

Press Play

Run the packager on Linux

OK, we're finally nearing the finale!

Your app is now configurable and will run on any development server you point it to.

Let's put the Mac away and move back to our Linux machine.

First thing's first: open a terminal in your project root and run the following commands:

npm install

You should see the packager start running.

It will look like this:

 │  Running packager on port 8081.                                            │ 
 │                                                                            │ 
 │  Keep this packager running while developing on any JS projects. Feel      │ 
 │  free to close this tab and run your own packager instance if you          │ 
 │  prefer.                                                                   │ 
 │                                                                            │ 
 │                                  │ 
 │                                                                            │ 


Now try restarting the app on your iPhone.

If it's still pointing at your Mac, you should see an error, like this:

Failure to Connect

Change the iPhone's Host Settings

OK, now let's fix the problem.

On the iPhone, go into Settings -> YourApp and change the "host" to the hostname / IP address of your Linux machine. For me, it's donkeyKong.local.

Change the port to whatever the packager is running on, it should be 8081, but you can look at your terminal to be sure.

Changing the Host to the Linux Machine

With the host and port set, you should restart the iPhone app.

If you see the following in the terminal, then you know for sure that the packager is working!

transforming [========================================] 100% 401/401
[11:33:37 AM] <END>   transform (98ms)
[11:33:45 AM] <START> request:/index.ios.bundle?platform=ios&dev=true
[11:33:45 AM] <END>   request:/index.ios.bundle?platform=ios&dev=true (22ms)

You should also see the "Welcome to React Native" screen.


Write your code

Now that we have the packager running, it's time for the final test: can we actually edit our code from Linux?

Let's go into index.ios.js and change this line:

<Text style={styles.welcome}>
    Welcome to React Native!


<Text style={styles.welcome}>
    Welcome to React Native on Linux!

Now, shake the phone and select "Reload" from the menu that appears.

Shake, shake, shake

If there is a God, you should see the screen update, showing those magic words "Welcome to React Native on Linux!"

There is a God.

Mission Accomplished

Congratulations. You have everything you need to get up and running with React Native and iOS on Linux!

Now, go take a walk around the block. You've earned it!

Open Source Project

I've put a template project up on GitHub, so that you can just clone that to get started.

Solution B: Zero Access to a Mac

Finally, if you have NO access to a Mac or you have a distributed team, where some developers are iOS developers and other developers are Javascript developers, you can modify your iOS code as described in Solution A, but then use a continuous integration service instead of a Mac to build your native iOS code. This way you you can still write all the Javascript code on your Linux machine. If you're REALLY adventurous, there's even a way to write Objective-C/Swift from your Linux machine.

For a continuous integration service, I recommend BuddyBuild.

You can easily log in with GitHub/Bitbucket and link them to your code repo.

Once it's set up, you can have the builds sent directly to your phone. You can even set it to build on every push!

If you do this, you can collaborate with a distributed team very easily! The native developers can push their native code to Buddybuild and Buddybuild will then send you an updated build of the native code. You can then write your Javascript against that native code.

I think this workflow is quite good. Give it a shot and see what you think.

Also, if you're REALLY adventurous, then you could even edit the Objective-C code on your Linux machine and push it to Buddybuild, let them compile it, then send it back to your phone. Very cool, but not for the faint of heart.

In closing, using Buddybuild as your compiler is clunkier than if you had a Mac, yes, but it's pretty damn seamless when you consider than Apple doesn't want you to be working on a Linux machine in the first place.

Rock on, Linux users.

NOTE: This section is shorter than I intended because I ran short on time. Do you want to see this in more detail? Let me know in the comments and I can expand this into a full guide.


Thanks to Marco Argentieri, a developer from Italy who was the inspiration for this article. I ended up answering the question in a slightly different way than he asked it, but I think this solution has more broad use. Chime in if you think otherwise.

And thank YOU for reading all of this!

Was this article helpful? If so, don't miss my next post by joining the mailing list using the box below:

Get weekly tips to become a React Native Pro

* indicates required
Written on February 14, 2016

David Kay writes about keeping you productive in React Native. Over the years, he's developed over a dozen successful native apps. If you found this article helpful, join his weekly newsletter.