LuminCity is a Kotlin-based Android app built in 24 hours during Harget Huckathon 2025, where it won 2nd place. Designed for the fictional world of Valyria, the app tackles urban transport inefficiencies using real-time routing, AI, and inclusive design.

• Smart Route Optimization: Recommends fastest routes using traffic, weather, habits, and AI.
• Live Congestion Maps: Visualizes traffic for smarter choices.
• AI Chatbot: Natural language assistant for travel help.
• Accessibility Support: Routes tailored to users with diverse needs.
• QR Payment Simulation: Mimics digital transit payments.

• Kotlin + Jetpack Compose
• Google Maps and Directions APIs
• OpenAI (chatbot, suggestions)
• Firebase Auth & Firestore

1. Clone this repo:

   git clone https://github.com/your-username/LuminCity.git

2. Open in Android Studio and sync Gradle.
3. Add to local.properties:

   MAPS_API_KEY=your_maps_key
   OPENAI_API_ENDPOINT=your_openai_endpoint
   OPENAI_API_KEY=your_openai_key
   

4. Get the google-services.json config file from your Firebase and paste it to app folder.
5. Build and run on emulator or device.

Yiğit Kaya Bağcı

Emre Tahtalı

Enes İsmet Bal