Room TBA - UPLB Room Finder

A web app to help UPLB students find rooms on campus. "Saan sa UPLB ang ___?" Finally answered.

Features

• Search rooms by name, building, college, division
• Filter rooms by Building, College, or Division
• View room schedules with visual timetable display
• Building information with directions and OpenStreetMap integration
• Room-specific directions for commonly asked-about rooms
• Mobile-responsive design with accessibility features
• Offline support in cases where data is not accessible

Data

Course and room listings are maintained for UPLB students and updated each term; they currently reflect 2nd Semester AY 2025–2026.

Development/Contribution

To run locally, you need to download Bun.js and run the following command:

bun dev

The data is stored in the info.db file, and may be accessed using sqlite. If you are not familiar with using SQL, you may run the following command to open up drizzle studio and start correcting data:

bunx drizzle-kit studio

After that, you may open a pull request and describe the changes.

Project structure

This project uses Astro, and may have the following folders:

• /public - All the static assets that can be requested by the route
• /src/routes - All of the routes used by the website
• /src/components - All of the frontend components used by the website
• /src/assets - All other internal assets used by the program
• /src/lib - where helper Typescript functions are located

Releases and versioning

Versions follow Semantic Versioning. semantic-release runs on every push to main (skipping commits that include [skip ci]). It reads Conventional Commits messages, bumps package.json, updates CHANGELOG.md, creates a Git tag, and publishes a GitHub release.

Use prefixes such as fix:, feat:, or feat!: / BREAKING CHANGE: so the next version is chosen correctly. To preview what would ship without changing anything:

bun run release:dry

The footer and status bar show v{version} from package.json at build time.

License

MIT License

Author

Developed by Simonee Ezekiel Mariquit

Contributors

• Niño Anthony Marmeto - Helped with Electrical Engineering building information
• Rosh Almario - Helped with Institute of Chemistry room directions
• Ken Ramiscal - Helped with Developing the UI, offline support, and map functionalities
• Kalinaw Lukas Aom Bebis - Helped with developing the UI, bug fixing, and map functionalities
• Eunice Almeyda - Logo Designer
• Mary Gwyneth Telmosa - UI Designer