Zone Manager App

• Standard compliant React Native App Utilizing Ignite

⬆️ How to Setup

Step 1: git clone this repo:

Step 2: cd to the cloned repo:

Step 3: Install the Application with yarn or npm i

▶️ How to Run App

1. cd to the repo
2. Run Build for either OS

• for iOS
  • run react-native run-ios
  • If this fails with Simulator not found use react-native run-ios --simulator="iPhone **MODEL**"
• for Android
  • Run Genymotion
  • run react-native run-android

🚫 Standard Compliant

This project adheres to Standard. Our CI enforces this, so we suggest you enable linting to keep your project compliant during development.

To Lint on Commit

This is implemented using husky. There is no additional setup needed.

Bypass Lint

If you have to bypass lint for a special commit that you will come back and clean (pushing something to a branch etc.) then you can bypass git hooks with adding --no-verify to your commit command.

Understanding Linting Errors

The linting rules are from JS Standard and React-Standard. Regular JS errors can be found with descriptions here, while React errors and descriptions can be found here.

🔐 Secrets

This project uses react-native-config to expose config variables to your javascript code in React Native. You can store API keys and other sensitive information in a .env file:

API_URL=https://myapi.com
GOOGLE_MAPS_API_KEY=abcdefgh

and access them from React Native like so:

import Secrets from 'react-native-config'

Secrets.API_URL  // 'https://myapi.com'
Secrets.GOOGLE_MAPS_API_KEY  // 'abcdefgh'

The .env file is ignored by git keeping those secrets out of your repo.

Get started:

1. Copy .env.example to .env
2. Add your config variables
3. Follow instructions at https://github.com/luggit/react-native-config#setup
4. Done!

Build and Release

Development build

1. Generate the js bundle

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res

2. enter android directory and assemble debug apk (unsigned)

cd android
./gradlew assembleDebug

3. Send generated APK from app/build/outputs/apk/debug/<version>.apk

Release build

1. Ensure version upgrade

react-native-version --never-amend

This will update app version in IOS and Android Manifests

2. Build app using gradle

cd android
./gradlew assembleDebug

3. Build using android runner if build fails

react-native run-android --variant=release

4. Send generated APK from app/build/outputs/apk/release/<version>.apk