Fork Kit
UPLB Tools builds free utilities for the University of the Philippines Los Baños community. Most of them are MIT-licensed and designed to be forked: the code is generic, and everything campus-specific is data and config you replace.
This site is the fork wiki — the cross-repo guide to standing up your own campus org (like bulsutools) and running the UPLB Tools stack on your campus.
What you can fork
Section titled “What you can fork”| Project | What it is | Fork difficulty | Guide |
|---|---|---|---|
| room-tba | Campus map + class finder (“where is this room?”), PWA, offline, editor mode | Medium — real campus data work | Fork room-tba |
| website | Org landing site listing your tools | Easy — mostly rebrand + deploy | Fork website |
Gradesim is not covered here — it has its own fork track.
One-click start
Section titled “One-click start”Prefer a button over a fork? Two GitHub template repos mirror upstream
main with no BulSU config baked in:
- bulsutools/room-tba-template — Use this template
- bulsutools/website-template — Use this template
Trade-off: template-generated repos have no upstream remote, so
syncing means adding one manually. Real forks keep
the link for you.
The 30-second version
Section titled “The 30-second version”- Stand up a campus org — create the GitHub org, profile repo, and bootstrap the repo set.
- Fork room-tba — clone,
bun run fork:init, seed your campus data, deploy. - Fork website — rebrand, list your tools, deploy.
- Keep your fork in sync — periodically merge upstream improvements.
The org-template/ directory in this repo contains a bootstrap script and
templates for step 1.