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

Check out develop for day-to-day work, that's the default branch. See Branches for more.

Use the Claude Code skills /create-pr and /update-pr to create and update pull requests, not manually. See Pull Requests for more.

2. Install Dependencies ​

bash
npm ci

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

3. Configure Environment ​

Ask a team lead to add you to the engineer-app project in Doppler with access to the uat-zuno config — doppler setup will fail without this.

Install the Doppler CLI, then link this repo to its Doppler project:

bash
npm run doppler:setup

This runs doppler login (opens a browser to authenticate) followed by doppler setup, linking your machine to the project/config without needing a manually copied API token.

Then generate the env files:

bash
npm run generate-env-files:local

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. Install EAS CLI ​

Install or update the EAS CLI globally:

bash
npm install -g eas-cli@latest

5. Run Development Client ​

Launch your simulator first, then run:

bash
eas build:run

Select the latest development-simulator build when prompted. This will install it on your running simulator.

If you need a new build (if you have made native changes):

bash
eas build:dev

6. Start the App ​

bash
npm run ios       # iOS simulator
npm run android   # Android emulator

If the app doesn't load after launching, press r in the terminal (or in the simulator window) to reload.

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.