React-Native Monorepo: SimpleApp

"SimpleApp" is an app which uses Firebase for authentication & data storage.

This is upgrade work to other monorepos; i.e. ticket.524 & ticket.526. The repos are examples for how to share code between different platforms (Web, Android, & iOS). They can be used as a template or starter-kit for React-Native & React-Native-Web. The key to code sharing is React-Native's Platform-specific extensions. The extensions are .native.js , .ios.js or .android.js and when used, the relevant platform file is compiled.

The main benefit of any monorepo is to share application logic. Another benefit is the rendering of individual components unique to each platform. Development is mobile-first AND then webapp.

Installation

• Get the repo
• From root directory, do yarn
• Change root/android/local.properties as needed
• From root/ios directory, do pod install (if needed)
• Install react-native-google-signin per both the Android guide & iOS guide
• Add Firebase per these guides: Firebase for Android , Firebase for iOS, Firebase JS SDK for Webapps

Required: React-Native working per Getting Started. If using React-Native ^0.60 , make sure
you review the blog post & use the upgrade guide. As notes in those links, update these files

• Change root/android/build.gradle as needed
• Change root/android/app/build.gradle as needed
• Change root/android/gradle.properties as needed
• etc

Run

For each platform, from the root directory, do

Web

• node_modules/.bin/webpack -p --progress
• node_modules/.bin/webpack-dev-server --content-base public/ --config ./webpack.config.js --port 3001 --inline --hot --colors
• Manually open a browser to localhost:3001 to see webapp
• Inspect browser window = open console to see shared code working on button click

Android

• react-native run-android -- --clear-cache

iOS

• react-native run-ios or open ios/SimpleApp.xcodeproj with Xcode

Animated GIFs

Notes - Development

• To keep code simple, Email verification not used
• Button is common CSS ; it is not a React Component
• React Router aka 1 package used as Navigational Components
• Form Input Error checking is basic ; repo user can refactor as needed
• Password Authentication and Password Resets (via Firebase), left as exercise to repo user
• Additional Social Logins, e.g. Facebook or Twitter, for web & mobile, left as exercise to repo user

Notes - Miscellaneous

• To make code easy to use & follow, Redux is omitted.
• React props is used for web / mobile & React state is used for web / mobile.
• Lerna or Yarn Workspaces is not used ; there is only 1 node_modules folder.

Inspiration

• A Firebase in React Tutorial (is for Web)
• Integrating Firebase with React Native (is for Mobile)
• Fun, Food, Friends (only for webapp ; refactored for Web and ported to Android/iOS)