Engineer App

Appearance

Setup Guide ​

This guide will help you get the Engineer App running on your local machine for development.

Prerequisites ​

Before you begin, ensure you have the following installed:

  • Node.js (version can be found in .node-version)
  • npm
  • Git
  • iOS Simulator (macOS only) or Android Emulator

For detailed instructions on setting up your development environment (Xcode, Android Studio, simulators/emulators), follow the official Expo guide: Set up your environment. Select Development build as the build type.

TIP

If you are not familiar with app development; android emulators are garbage compared to the iOS simulator. It is worth going through the setup of iOS.

Installation Steps ​

1. Clone Repository ​

bash
git clone https://github.com/zuno-tech/installer-app.git
cd installer-app

2. Install Dependencies ​

bash
npm install

This will install all required packages including React Native, Expo, and development tools.

3. Configure Environment ​

Obtain the doppler key from an app developer and run:

bash
node scripts/fetch-and-generate-env-files.js <DOPPLER_KEY>

This script will produce the env-config.json file and it contains environment-specific configuration and is gitignored for security.

WARNING

Never commit env-config.json to version control. It contains sensitive configuration.

4. Build Development Client ​

bash
npm run build:dev

This command uses EAS Build to create a development client. If a compatible build already exists on EAS servers, it will be downloaded and installed directly. Otherwise, a new build will be created. Once installed on your simulator or device, you can start development.

Verify Installation ​

Once the dev server is running, you should see the app launch in your chosen simulator/emulator. The power up screen should appear if everything is configured correctly.

Troubleshooting ​

If you encounter issues during setup:

  1. Metro bundler cache issues: Run npm cache clean --force && watchman watch-del-all to clear the cache
  2. Node modules issues: Delete node_modules, then run npm install again
  3. iOS simulator not launching: Ensure Xcode Command Line Tools are installed

For more help, see FAQs.