# QRun

> Location-based orientation game app that gamifies facility familiarization through QR code scavenger hunts. Led development as part of HKU COMP3330.

URL: https://maniksoin.com/projects/qrun/
Live: https://innoacademy.engg.hku.hk/qrun/
Tags: Android, Java, Firebase, QR Code, Location Services, Mobile Development

## Overview

QRun is a gamified orientation app designed to help organizations onboard new members by making them familiar with their surroundings in a fun, interactive way. Users are given prompt images and must physically locate where the image was taken by scanning QR code stickers placed at those locations.

**Tagline:** *Discover places in base reality*

## Key Features

### Custom Room Creation
- Organizations can create custom "rooms" using pictures of their facilities
- Upload images and location data to generate unique room codes
- Automatically generates QR codes to be placed at respective locations

### Proximity Alerts
- Real-time notification alerts based on user proximity to target locations
- Guides users with distance indicators ("You are 10m away from the target!")
- GPS-based tracking for accurate location detection

### Social Features
- In-app chat to communicate with other players in the same room
- Leaderboard system to keep the experience competitive and engaging
- Community-driven gameplay experience

## Technical Implementation

### Mobile Development
- Native Android application with intuitive UI/UX
- QR code scanning using device camera
- Background location services for proximity detection

### Backend & Real-time Features
- Room management system for creating and joining game sessions
- Real-time leaderboard updates
- Chat functionality for social interaction

## Project Context

This project was developed as part of **COMP3330** (Interactive Mobile Application Development) at the University of Hong Kong, supervised by **Dr. Chim, T.W.** from the Department of Computer Science.

Showcased at the **7th Engineering Inno Show** at HKU Innovation Academy.

## Team

- **Manik Soin** (Project Leader) - BEng Computer Science
- Vyshnav Shabu Nair - BEng
- Lee Jeng Heun - BEng
- Srivastava Dhruv - BEng