This repo is intending to provide an easy starting point for developers looking to make fully cross platform applications across both web with React Native Web and mobile with Expo.
All branches represent a particular starting point.
It is bootstrapped with Create React App so you can run yarn web in order to start up the development web server with all the hot reloading goodness you've come to expect.
It has then been integrated with Create React Native App and running yarn ios or yarn android will start the Expo packager. You can also run the project from the Expo XDE program.
| Branch | Description |
|---|---|
| master | The most minimal possible boilerplate, will always be the case |
| redux | Implements redux reducers, actions, store and connection including example |
| navigation-react-router | Using react-router-dom, react-router-native and react-router-navigation in order to have a platform agnostic navigation solution including native look at feel on phones |
Clone the branch with the starting point you want and just rename the project (don't forget the package.json, Run git remote rm origin && yarn to remove the ref to this repo and install node_modules then you're good to go. 🙂
A full list of the scripts defined in package.json is shown below.
| Script | Action |
|---|---|
yarn web |
Start CRA Development Build |
yarn build-web |
Create production build for web |
yarn eject-web |
Eject from CRA |
yarn start-native |
Start the Expo packager |
yarn eject-native |
Eject from Expo |
yarn android |
Start expo packager and install app to Android Emulator |
yarn ios |
Start expo packager and install app to iOS Simulator |
yarn test-native |
Run testing script for mobile app |
yarn test-web |
Run testing script for web app |
yarn test |
Run both testing scripts |
The aim for this library is to make several branches that have different starting points i.e. Navigation, Auth etc.
Master branch will always be the most minimal starting point.
I'm also toying with the idea of doing a starting point with React Native CLI instead of Expo however that will mean the UI for mobile will less predictiable than developing with Expo.
If you have any ideas for a boilerplate then please create an issue or even better a pull request! I'm hoping to get this repo to be a big hub for getting started with React Native Web with tutorials etc.
- Get jest working properly
- TypeScript
- ReasonML
- Huge thanks to Nicolas Gallagher for making React Native Web
- Thanks to Expo for making it so easy to get started with React Native development
- Thanks to Yannick Spark for writing this great article which inspired me to get started with React Native Web