About
About this map.
A small website with one job: help a new student or a visitor find the right building without asking around.
Why I built it
When I first arrived on campus, I had no map at all. I did not know what each building was for, or whether there was a study room or a gym — let alone where they were. The only option was to walk the campus myself, and even then I did not necessarily find every room that actually does something. I wanted to help new students settle in quickly, so I built this campus map.
The result is a schematic map, not a satellite photo. Shapes are simplified and labelled, which makes the important things — where the teaching buildings sit, how the student dorms line the eastern edge, how the restaurant and teacher dormitories sit around the lake — easier to read at any size.
What is on the site
- Home — a short introduction and a preview of the campus.
- Map — the main page: 14 places on the map and 11 places inside them, a search box, category filters, a photograph beside the map and the details below it.
- 3D Campus — a campus model you can rotate and zoom. Select a building or the East Gate for its photograph, or use the small buttons on the left to find study rooms, gyms, restaurants and shops.
- Buildings — the same places as cards, each with its photograph and the rooms inside it.
- About — this page.
The new 3D campus
The flat map is for finding a place quickly; the 3D page offers a different way to get familiar with campus. Buildings, the student center, dormitories, courts, roads and the lake are modelled from the master plan and campus photographs, rather than using the whole plan as a ground image. It is a model for orientation, not a survey, and some architectural details are simplified.
Drag to turn the view and zoom with the wheel or touch gestures, or jump to the teaching quarter, lake, sports grounds or dormitories using the view buttons. Photos do not float over every roof: selecting a building or its name opens a photo panel that you can close to continue exploring. Rooms and shops are grouped by building on the left; choosing a gym or study room brings its building into view and shows its floor, location and photograph.
How it works
Everything is static. There is no server and no database, and the site does not collect any data.
- Semantic HTML — one
<header>, one<main>, one<footer>; the map is an inline SVG with a title and description. - Shared styles — colours, spacing and category colours live in CSS custom properties, giving all five pages a shared visual style. The 3D page adds styles for its scene controls and photo panel.
- Vanilla JavaScript — every place is written once, in one data file that both the map and the buildings page read, so the two always agree. Clicks, keyboard input and filtering need no libraries.
- Responsive by default — the SVG scales with its container; on a narrow screen the map becomes scrollable instead of shrinking to nothing.
- Accessible controls — every building is a keyboard-focusable button, the markers inside buildings are buttons of their own, the filter buttons report their pressed state, and the details panel announces changes.
- Photos on demand — photographs appear on demand rather than loading every location's photo when the map or 3D campus opens. The flat map and building guide use compressed previews; the 3D page loads a place's photograph when it is selected. Photos can also be opened in a larger viewer.
- English / 中文 — the switch in the header changes the language of the whole site, and remembers your choice.
- Light and dark — the theme follows the system setting, or the button in the header; every colour is a CSS variable, so a theme is just another set of them. The map drawing keeps its paper colours.
What I learned
- How to plan an SVG with a coordinate system, and why a
viewBoxmakes a drawing responsive for free. - How to keep a map interaction simple: select, filter, describe — no framework needed.
- What a photograph weighs. Full-size pictures are 2–5 MB each, so a page that loads one on demand feels very different from one that loads twenty.
- How to translate master-plan coordinates into a 3D scene, and why roofs, roads, planting and camera positions need checking from more than one angle.
- How to keep a new page focused on the same purpose: helping people understand campus and find places, rather than adding complexity for its own sake.
What I would add next
- The new places from the campus's second phase, once it is built.
- A version you can add to your phone's home screen.
Please check the details. Building names were taken from the campus plan and my own walk around. If a name or location is wrong, tell me and I will correct it.
Credits and sources
The map is a schematic drawn from scratch in SVG, based on the campus plan and my own walks around campus. No third-party map tiles are used on this site.
The photographs were taken by me on walks around campus in November 2026 and are used only here. They are stored at full size in photos/, and the index in photos/README.md records where each one was taken.
Typefaces are the ones already on your device (system fonts). Built for Web Technologies 2026 at BiUH.
The 3D campus uses three.js, kept in the site's own vendor/ folder rather than a CDN. Everything on it is modelled rather than painted: the roads, kerbs, footways and crossings are slabs laid to the master plan's own lines, the running track is a ring of rubber round a pitch, each court is its own deck, and the lake is water in a stone bank. Each building is raised to the footprint and floor count the plan gives, with its facades drawn on canvas and mapped onto it.
Contact — X20250076@stu.hibiuh.edu.cn