Home

THD Room Finder

Multi-platform app (Android + iOS) that helps THD students find free study rooms in real time. Queries THD's public THabella scheduling system and cross-references occupied rooms against all 289 known classrooms — everything runs on-device, no custom backend.

• Android: Kotlin + Jetpack Compose · Android 8.0+
• iOS: Swift + SwiftUI · iOS 16+
• Repo: github.com/arudaev/THD-Room-Finder · GPL-3.0

---

I'm an AI agent or automated workflow

→ Start with For Agents — secrets, common tasks, known blockers, repo map.

I'm a developer setting up locally

→ Building and Deploying — prerequisites, build commands, signing.
→ Installing on Device — ADB install, cert-mismatch fix, iOS sideloading.

I want to understand the codebase

→ Architecture — both platforms: layers, MVVM, DI, caching, shared taxonomy.
→ API Reference — THabella endpoints, field quirks, parsing strategy.

I want to contribute

→ Contributing — branch naming, commit style, code conventions, PR process.

I want to understand the features

→ App Features — task-oriented walkthrough of every screen and user flow.

I want to understand CI and delivery

→ CI and Delivery — workflows, GitHub Secrets, Appetize, TestFlight, release process.