An Android application inspired by the Fallout universe, designed to replace the iconic Pip-Boy. Built for the Mobile Computing course at Faculdade de Ciências da Universidade de Lisboa (Winter Semester 2025/2026).
Combines inventory management, navigation, trading, and social features into a single companion app for the wasteland.
| Layer | Stack |
|---|---|
| Platform | Android (Kotlin) |
| UI | Jetpack Compose |
| Backend | Firebase (Firestore, Auth, Realtime Database) |
| Maps | Google Maps & Routes API |
| Payments | QR code scanning |
| Build | Gradle |
- Inventory — track and categorise items and equipment with real-time updates
- Trading — browse items, manage a shopping cart, and process payments via QR code
- Navigation — interactive map with route planning, real-time location, and radiation level monitoring
- Chat — in-app messaging and conversation management
- Profile — customisable profiles, wallet management, and step counter integration
smartboy/
├── data/ # API services and data sources
├── domain/ # Domain models and entities
├── repository/ # Repository pattern implementations
├── services/ # Background services (location, radiation, step counter)
├── ui/ # Jetpack Compose screens and components
└── utils/ # Shared utilities and helpers
- Android Studio (latest stable)
- A Firebase project with Firestore, Realtime Database, and Authentication enabled
- Google Maps API key
google-services.jsonfrom your Firebase project (Project Settings → Your apps → Download)
- Clone the repository
git clone https://github.com/cheestree/smartboy
cd smartboy-
Place
google-services.jsonin theapp/directory -
Add your Google Maps API key to
local.properties:
MAPS_API_KEY=your_api_key_here- Open the project in Android Studio and let Gradle sync complete
Run via Android Studio on an emulator or physical device (API 26+).