SmartBoy

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.

Technologies

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

Features

• 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

Repository Structure

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

Prerequisites

• Android Studio (latest stable)
• A Firebase project with Firestore, Realtime Database, and Authentication enabled
• Google Maps API key
• google-services.json from your Firebase project (Project Settings → Your apps → Download)

⚙️ Setup

1. Clone the repository

git clone https://github.com/cheestree/smartboy
cd smartboy

2. Place google-services.json in the app/ directory

3. Add your Google Maps API key to local.properties:

MAPS_API_KEY=your_api_key_here

4. Open the project in Android Studio and let Gradle sync complete

🚀 Running

Run via Android Studio on an emulator or physical device (API 26+).

Developers

• Daniel Carvalho
• Daniel Sousa

License

GPL-3.0