Since the first release of React Native, I’ve always hoped to build a React codebase that could run on any platform.

I loved building multi platform apps using Cordova and web technologies, but React Native has raised the bar so high now with its native performance.

So far, when you wanted to have a unified codebase of the Web and Native, you had to mess around with build systems (Webpack and React Native packager) in order to make everything work together.

Now with Create React Native App and Create React App, we do not have to worry about this layer of complexity.

I’ll guide you through the steps needed to have one codebase that runs anywhere!

Phase 1 : The dirty work

You’ll need :

the latest version of Node (when I wrote this post, it was 8.6.0)

create-react-app

First, create a React app using :

create-react-app my-hybrid-app && cd my-hybrid-app

We need to add a few dependencies to our project :

To install these packages you can either use npm or yarn .

npm install --save-dev babel-plugin-transform-object-rest-spread babel-plugin-transform-react-jsx-source babel-preset-expo jest-expo flow-bin react-native-scripts react-test-renderer@16.2.0 or yarn add --dev babel-plugin-transform-object-rest-spread babel-plugin-transform-react-jsx-source babel-preset-expo jest-expo flow-bin react-native-scripts react-test-renderer@16.2.0

And we add the packages for react-native, react-native-web and expo :

npm install --save expo@^25.0.0 react-native@0.52.0 react-native-web or yarn add expo@^25.0.0 react-native@0.52.0 react-native-web

Now let’s add a few files necessary to build a React Native app :

.babelrc

{

"presets": ["babel-preset-expo"],

"env": {

"development": {

"plugins": ["transform-object-rest-spread", "transform-react-jsx-source"]

}

}

}

.watchmanconfig

{}

.flowconfig

Create a .flowconfig file in your project directory and add the flow settings available here

app.json

{

"expo": {

"sdkVersion": "25.0.0"

}

}

App.test.js : this is the entry point for testing the React Native app.

import React from 'react';

import App from './App'; import renderer from 'react-test-renderer'; it('renders without crashing', () => {

const rendered = renderer.create(<App />).toJSON();

expect(rendered).toBeTruthy();

});

And then add a App.js file, this is going to be our React Native app entry point.

import React from 'react'

import HybridApp from './src/App' export default class NativeApp extends React.Component {

render() {

return <HybridApp />

}

}

At that point, your project should look like this :

my-hybrid-project

|

├── README.md

├── .babelrc

├── .flowconfig

├── .gitignore

├── .watchmanconfig

├── package.json

├── app.json

├── App.test.js

├── App.js <-- entry point for CRNA (don't move/rename it!)

│

└── src

│ ├── index.js <- entry point for CRA (don't move/rename it)

│ └── ... more source files

│

└── public

├── index.html

├── favicon.icon

└── manifest.json

Now let’s make a few changes to our package.json file and add some useful scripts

// These scripts are merely copied from the create-react-native-app package.json file

...

"main": "./node_modules/react-native-scripts/build/bin/crna-entry.js",

"scripts": {

"start-web": "react-scripts start",

"build-web": "react-scripts build",

"test-web": "react-scripts test --env=jsdom",

"eject-web": "react-scripts eject", "start-native": "react-native-scripts start",

"eject-native": "react-native-scripts eject",

"android": "react-native-scripts android",

"ios": "react-native-scripts ios",

"test-native": "node node_modules/jest/bin/jest.js --watch", "test": "npm run test-web && npm run test-native"

},

"jest": {

"preset": "jest-expo"

}

...

Phase 2 : Profit!

Everything is set up in our project, let’s start both packagers in two different terminal windows.

Terminal 1 :

npm run start-web or yarn start-web

Terminal 2 :

npm run ios or yarn ios

We need to edit ./src/App.js and add some platform agnostic code in it.

You can now write all your code as if you were writing some React Native code.

The trick here is that the webpack config of Create React App aliases automatically react-native to react-native-web (see the config here).

Everything is handled for us!

import React, { Component } from 'react'

import { View, Text, StyleSheet } from 'react-native' export default class App extends Component {

render() {

return (

<View style={styles.app}>

<View style={styles.appHeader}>

<Text style={styles.appTitle}>Welcome to React ⚛️</Text>

</View>

<Text style={styles.appIntro}>

To get started, edit src/App.js and save to reload.

</Text>

</View>

)

}

} const styles = StyleSheet.create({

app: {

flex: 1

},

appHeader: {

flex: 1,

backgroundColor: '#222',

padding: 20,

justifyContent: 'center',

alignItems: 'center'

},

appTitle: {

fontSize: 16,

color: 'white'

},

appIntro: {

flex: 2,

fontSize: 30,

textAlign: 'center'

}

})

You should now see this :