Tuesday, September 15, 2015

What I learned from building a React Native app

React Native is Facebook's open-source framework for building native mobile apps using JavaScript. Unlike PhoneGap/Cordova, React Native provides bindings for native UI controls which totally outclass HTML-based hybrid solutions. After playing with the sample app for a while, I decided to jettison my Cordova codebase and rewrite the Circadi app using this new framework. It took me about 96 working hours to finish an MVP, now published on the App Store. My overall experience with React Native is positive. I'm going to give an account of my key findings below for people who're considering to adopt the framework.


Developer productivity

React Native enables developers to write native apps in JavaScript with ECMAScript 5/6 features and optional type checking using Flow. This alone is a huge boon to my productivity even if cross-platform code reuse were never promised. Having written Objective-C and Java at my former employer, I much prefer writing apps in a more terse language like JavaScript despite its many foibles.

The interpretive nature of JavaScript also significantly shortens the RN app dev cycle, making it as easy as developing web pages. Reloading a RN app in a second by pressing ⌘+R turns out to be a truly refreshing experience. (You do need to recompile the XCode project when you switch between build targets, link in a new native module, add a resource file, patch an Objective-C implementation, or resolve the occasional red-screen-of-death.)

Another design choice that facilitates quick UI iteration is React Native's flexbox and styling abstraction, modeled after a carefully chosen subset of CSS features. Layout tweaking using the flexbox model rarely gives me any unpleasant surprises, unlike my traumatic experience grappling with Interface Builder's constraint editor.

App performance

React Native app's UI components feel native because they are native controls exposed to JavaScript via a JS/Obj-C bridge. Achieving the same level of look-and-feel in HTML is a sisyphean task — eventually you'll have to either compromise on fidelity or resort to a non-standard UI theme.

React Native borrows the virtual DOM diff idea from React and makes it conceptually simple to write high-performance UI. If you try to repaint a full-screen background 60 times per second, RN will stutter; but for most non-game apps with few moving parts, it's not hard to create a smooth experience.


Cross-platform support

Facebook finally unveiled React Native for Android yesterday, almost six months after the iOS release. However, porting my RN app to Android is non-trivial. First of all, some of the UI controls such as SwitchIOS need to be replaced with Android counterparts; some (e.g. ActionSheetIOS) must be scratched and redesigned for the targeting platform. A more pressing issue is porting all of the native libraries my app depends on. I'll end up writing Java extensions or waiting for others to do it.

There's also no obvious way to write Apple Watch apps in RN yet.

Library support

React Native has fewer than 30 built-in components so far, iOS and Android combined. Chances are good that you'll need to find (or write your own) extensions to implement some basic features, for example, accessing SQLite databases or supporting in-app-purchase items. You'll be hurled back to the Dark Ages of app development, so be prepared with some knowledge of Objective-C and Java. Fluency in native code will be useful anyway even if you don't write RN extensions because: (1) React Native's documentation isn't on par with Apple's yet. You'll sometimes need to dive into the .m files to ferret out implementation details. (2) React Native is still a young framework, fraught with bugs on the other side across the JS bridge.

ES6 language support

Although you can use ECMAScript 6 features in your RN app, be aware that when you run react-native bundle --minify for release build, RN transpiles JavaScript into ES5 using Babel before calling UglifyJS2 for minification. However, not all ES6/7 syntax get transformed, and UglifyJS will choke on statements like for (... of ...), yield, etc. This is not technically a RN issue, but it will bite you during the release phase if you go too fancy with ES6 goodies.


I find React Native a good fit for JavaScript programmers to develop decent native apps with mostly standard UI. This fledgling framework has shown great promise to reduce app development cost, posing a real threat to Cordova and Appcelerator's Titanium.

Update: I published a game using React Native.


  1. > ES6 language support

    For ES6, we use babel in order to transpile ES6 code into ES5 that we then send to Uglify. You can look at all the transformations that are enabled here:

    1. Thanks for the correction, Vjeux! I've updated the section with better ES6 examples.

    2. Yeah, we have very poor error message for ES6 syntax that isn't supported. Chrome, JSC and Uglify support varied amount of ES6 and it will fatal in unexpected places. Sorry about that, we need to do better here.

  2. Really interesting, impressive that you were able to do this in less than 100 hours, I suppose you knew React already?

    If you look at it's immediately obvious that this is not (yet) a "write once deploy many" tool: you'll be developing the UI of your app separately for Android and for iOS.

    Unless, that is, someone comes up with an abstraction layer.

    I wonder how this compares with other cross-platform "native Javascript" tools. An interesting one is Nativescript:

    Backed by Telerik, architecture and documentation look really good.

    They have tackled the "Android/iOS abstraction" problem (you can create cross-platform UI components) and they have a very nice technique to enable your Javascript code to call into native libs.

    Also there's a layout module and there are styling options.

    There are many other tools, of course there's the tried and true Appcelerator Titanium, then there's Reapp (also based on React), Tabris.js and so on.

    Right now I'm using Ionic for my apps but I'm really interested in trying out some of these "native javascript" tools.

    1. NativeScript looks great! I'll evaluate it soon. Thanks for sharing the link.

    2. IMO, while NativeScript is better for "write once run everywhere" apps, I feel the biggest plus side of React Native is React.

      Because of React, you are able to write and reason about your code in ways that you can't with everything else.

      The benefits that this brings to teams and speed of development is amazing. Please look into React if you don't know what I mean.

  3. There are high performance SQLite3 React Native bindings available for both Android and iOS at this repo: