Room TBA UPD

Saan sa UP Diliman ang ___?

An open-source room finder and campus map for UP Diliman, forked from uplbtools/room-tba.

---

What this is

Room TBA UPD is a map-first web app for UP Diliman students. You search a room code, building nickname, or course; the app puts it on an interactive campus map, shows schedules when we have them, and keeps working when the signal drops.

No account needed to browse. Editors and contributors fix data in the same app (login popup on the map, not a separate admin site).

Data note: Room and class listings are updated each term by volunteers. Class search lists lecture, lab, thesis, special problem, and similar sections; ones without a room in CRS show as unassigned. Room schedules list only lecture and lab sections with assigned rooms. Wrong schedule? Open an issue.

What you can do

• Search rooms, buildings, dorms, orgs, offices, and landmarks (aliases included)
• Room schedules by term, class browsing by course code
• Plan a draft schedule in the Planner; see your day in the Today view (/today)
• Building locations with pins, directions, and shareable links
• Jeepney route overlays
• Works offline (PWA + local cache; tiles if already loaded)

Stack

Astro 7 + Svelte 5, Bun, Postgres + Drizzle, PGlite for offline data, MapLibre GL with OSM / MapTiler tiles.

Run it locally

You need Bun 1.3+ and a Postgres DATABASE_URL (Supabase works).

bun install
cp .env.example .env
# fill DATABASE_URL in .env

bunx drizzle-kit push
bun run scripts/seed-upd-campus.ts
bun run import:crs-classes -- --term-id 120261 --fetch
bun dev

Open http://localhost:4321.

Commands worth knowing

Command	Does what
bun dev	Dev server
bun run build	Production build (needs DATABASE_URL)
bun run test	Unit + component tests
bun run lint	Biome check (format + lint)
bun run fork:check	Scan for leftover UPLB strings inherited from upstream

Credits and license

Forked from uplbtools/room-tba, originally built for UPLB by UPLB Tools and maintained by Simonee Ezekiel Mariquit and contributors. Not an official UP Diliman product.

Layer	License
Application code	MIT
Community campus map data (buildings, rooms, dorms, orgs, pins, aliases)	CC-BY 4.0
OpenStreetMap basemap / footprints	ODbL (+ MapTiler for tiles)
CRS, OUR, and similar registrar imports	Not offered under an open bulk license

Use the code, fork it, teach with it. If you deploy a fork for another campus, change the data, not just the logo: see the upstream fork guide.