Skip to content

App Features

Jump to bottom
arudaev edited this page Apr 25, 2026 · 2 revisions

App Features

Task-oriented guide to THD Room Finder. Each section answers a specific user goal.

"I need a free room right now"

Open the app. The Home screen shows:

  • How many rooms are free at this moment — e.g. "42 of 289 rooms available"
  • A Find a Free Room button that opens the Room List

Tap the button. The Room List displays every available room, sorted so the most useful ones appear first: main-campus teaching rooms at the top, labs and seminar rooms below, remote buildings last. Admin and storage rooms are hidden entirely.

Each card shows:

  • Room name (e.g. "I 112") and building code
  • Floor and seat count
  • How long it stays free — "Free until 14:30" or "Free all day"

Tap any card to open Room Detail.

"I want to filter by building"

On the Room List, a row of chips runs across the top: All · A · B · C · D · E · I · ITC · …

Tap a chip to show only rooms in that building. Tap All to clear the filter. Filtering is instant and client-side — no additional network request.

"I want to check availability at a specific time"

Tap the clock icon in the Room List top bar. A two-step picker opens:

  1. Pick a date (Material 3 DatePicker)
  2. Pick a time (Material 3 TimePicker)

A coloured strip below the top bar confirms the selected time and shows an × to return to the current time. The room list updates immediately to show what's free at that date and time.

"I want to see everything about a specific room"

Tap a room card anywhere to open Room Detail. You'll see:

Room info

  • Full name and building code
  • Floor and seat count (regular + exam capacity)
  • Facilities and equipment list (e.g. "Beamer, Whiteboard")
  • Contact person name and email, if THabella provides one

Availability status

  • Green card: "Free until 14:30" or "Free all day"
  • Red card: "Occupied until 14:30"

Today's schedule

  • Chronological list of every event in the room for the selected day
  • Each entry: time range, event type ("Vorlesung", "Prüfung"), duration badge
  • Event titles are hidden in the public API — only the type is shown

"I want to use Siri or Shortcuts" (iOS)

After installing on iPhone, open Apple Shortcuts and search THD Room Finder. Two built-in shortcuts appear:

  • Find Free Rooms — runs GetFreeRooms and returns the current prioritised list; works with Siri voice commands
  • Open Room — deep-links directly to a specific room's detail screen

Siri suggestions are backed by cached room data and improve as you use the app.

"The app is showing old data"

Auto-refresh keeps all three screens current without user action. Every 5 minutes, each screen silently re-fetches data from THabella. No spinner appears — the display just updates in-place. If the refresh fails, the existing data is preserved.

To refresh manually: pull-to-refresh on the Room List, or tap Refresh on the Home screen.

If the network is unavailable: the app falls back to cached data (rooms: up to 24 hours old, events: up to 5 minutes old). An error message with a Retry button appears only if no cached data exists at all.

Material 3 theming (Android)

  • Dynamic color (Material You) on Android 12+: the UI adapts to your wallpaper palette
  • Dark mode follows the system setting automatically
  • Fallback palette on older devices: academic blue / teal theme
  • Card-based layout using ElevatedCard and OutlinedCard for visual hierarchy

THD Room Finder

Start here

Build & Install

Reference

Delivery

Contribute

Clone this wiki locally