---
title: MoBaz MRU
emoji: 🚌
colorFrom: red
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Offline-first Mauritius bus journey planner + live API
---

# 🚌 MoBaz — Mauritius Bus Planner

**MoBaz** (Mauritian Creole for *"my bus"*) is an offline-first journey planner
for Mauritius' bus network. Pick an origin and destination and it plans a route —
showing the bus line(s) to take, every stop with timing, the frequency
(headway), and the road-following path on a map.

This Space serves the live API + dataset **and** a Grafana metrics UI. One public
port (7860) is fanned out by nginx to four processes (backend, Prometheus,
Grafana, nginx):

| Path | Serves |
|------|--------|
| `/` | **Grafana** dashboards (redirects to `/grafana/`) |
| `/app/` | the **web app** (PWA) |
| `/api/*`, `/data/*` | live planner API + dataset (the **iOS/Android apps use these** — unchanged) |
| `/metrics` | Prometheus exposition (scraped internally) |
| `/status` | dependency-free backend status page |

- **Web app:** open `/app/` on this Space.
- **Metrics:** open the Space root (Grafana). Set a `GF_SECURITY_ADMIN_PASSWORD`
  Space secret to lock the Grafana admin account; anonymous visitors get read-only.
- **Android app refresh endpoint:** `./data/network.json` (unchanged).

> Note: HF Space storage is ephemeral and the Space sleeps when idle, so the
> Prometheus history resets on restart — dashboards show data since the last boot.

All journey planning runs **on-device** over the bundled network, so the app
works with no internet; map tiles are cached as you view them.

### Data & credits
- Routes, stops, frequency: [mauritius-buses.com](https://www.mauritius-buses.com/) (unofficial community data).
- Map tiles, stop coordinates: © [OpenStreetMap](https://www.openstreetmap.org/copyright) contributors.
- Road geometry: [OSRM](https://project-osrm.org/).

Not affiliated with NLTA, CNT or UBS. Frequencies are weekday headways, not fixed timetables.