Scrappi

Scrappi is a mobile app built with Expo + React Native.

Requirements

• Node.js (LTS recommended)
• npm (comes with Node)
• Expo Go installed on a physical iOS/Android device (recommended for quickest start)

If you plan to run on iOS Simulator or Android Emulator, you’ll also need Xcode or Android Studio. The steps below focus on Expo Go.

Project structure (where to run commands)

This repository contains an outer folder and an inner app folder. All commands should be run from:

cd scrappi

That directory contains package.json.

Environment variables

1. From the inner scrappi/ directory, copy the example env file:

cp .env.example .env

2. Open .env and add the required API keys/values.

Without valid API keys, some features may be limited or not function.

Install dependencies

From the inner scrappi/ directory:

npm install

Run the app (development)

From the inner scrappi/ directory:

npx expo start

Then:

• In the terminal (or Expo Dev Tools), scan the QR code with:
  • iOS: Camera app
  • Android: Expo Go QR scanner

Network note

If you are testing on a physical device, your computer and phone must be on the same network. If you experience connection issues, try switching networks.

In our testing, BU Guest worked reliably, while eduroam sometimes caused Expo connectivity issues.

Permissions

Some features require OS permissions. When prompted, allow:

• Camera (for scanning)
• Location (for resource recommendation)