Awesome
<div align="center"> <img align="center" src="./assets/icon.png" width="200" />React Native Everywhere
Expo ( Android + Web + iOS ) + Tauri ( Desktop ) = ♥
</div> <br />What is RNE?
RNE is a template I made to help me build Beautiful, Efficient, and write once run everywhere apps with Expo (React Native) building to Android, iOS and Web along with Desktop support using Tauri. This template includes some common libraries and configurations that I find myself using in almost all React Native project.
Beware: I am using libraries and configuration the way I like the most, your choices and the most efficient way to do it might differ.
<br />Whats included
The most relevant list of packages included in the template are as follows:
- React Native Paper
- React Navigation
- Redux along with
redux-loggerandredux-persist - react-redux
- React Native Async Storage
- Tauri
Using the template
To Get started click on that Use this template button in the repository and create your own repository.
Initial changes
We have to make some initial changes before we start building our app, please follow below steps carefully:
- change all the relevant fields to your project specific details in
./app.jsonand./src-tauri/tauri.conf.json - change the app icons in
assets, namely theadaptive-icon.png,favicon.png,icon.pngandsplash.png. Tauri specific icons will be generated using./assets/icon.png, once you have added the new assets runyarn tauri icon ./assets/icon.pngthis will generate the asset icons required by our desktop builds.
Now its time you build your app :>
Working
Their are multiple scripts in the package.json, most of them are just the default once that come with tauri and expo so I won't be documenting them. Building your Android, iOS and Web app using this template is same when using just expo so I will be skipping that. You can find below the general flow of development for desktop apps though.
For developing desktop app their are actually two steps:
- tauri depends on a web bundler like
webpackso we first start our expo web development server usingyarn weband we leave it running - open another terminal and now we can run
yarn desktopthat will start our tauri app in development mode
For building desktop app we employee a similar approach:
- we first build our web version of the app using
yarn build-web - once the web version is build we use
taurito package the web app usingyarn build-desktop
Issues
Enjoy the errors they are a feature :P ( kidding open an issue/improvements here)
<br />What to expect
This template will allow you to build beautiful React Native apps quickly for almost all platforms ( Android + iOS + Web + Linux + Windows + MacOS ). For platform specific APIs on Android, iOS and Web things need to be handled using Expo, whereas for desktop we'll be using what's provided by Tauri. This template is fast and reliable and I have run the light house test on it (results below). You can find the release builds for the template in Github Release Page