Mobile Documentation - bounswe/bounswe2025group5 GitHub Wiki

Mobile App Setup & Usage

Prerequisites

  • Node.js v14+ (LTS recommended)
  • npm or Yarn
  • Expo CLI 
    npm install --global expo-cli
  • Expo Go (iOS / Android) — install from App Store or Play Store

Project Installation

  1. Clone the repo 
    git clone https://github.com/your-org/your-mobile-app.git
cd your-mobile-app
  2. Install dependencies 
    npm install
# or
yarn install

Running the App

  • Start Metro bundler 
    npm start
# or
yarn start
  • Open in Expo Go
    1. Scan the QR code in your terminal with the Expo Go app. The same Wi-Fi network (not eduroam though, since it creates some issues) should be used for both devices.
    2. Choose Tunnel or Local mode if prompted.
  • Run in Simulator
    • Press i (iOS) or a (Android) in the Metro terminal.

Key Dependencies

  • expo-router — file-based routing
  • react-native-async-storage — persistent storage
  • expo-font + expo-splash-screen — custom fonts & splash handling
  • react-native-reanimated — animations
  • @expo/vector-icons — icon set

Troubleshooting

If you run into build or version errors (e.g. “Module X not found” or “Incompatible version”), it usually means one of the libraries didn’t install with the correct React Native or Expo–SDK–compatible version. In that case, just re-run:

expo install <package-name>

That’s all you need to get the mobile client up and running. Happy coding!