Jeepney route finder for Metro Cebu, Philippines
Interactive map • Fare estimation • OSRM-snapped routes • Metro Cebu route catalog
This repository is under active development.
- ✅ Interactive route finder and route catalog are working.
- ✅ GitHub Pages deployment is enabled.
- ⏳ Route data accuracy and UX refinements are ongoing.
JeepMe is a modern web app that helps commuters find the best jeepney routes across Metro Cebu, Philippines.
It lets you pin an origin and destination on a map, then suggests jeepney routes based on proximity matching. It can also estimate fares and draw realistic paths by snapping route lines to real streets via OSRM.
- Route finder: Pin origin/destination to find matching jeepney routes.
- Fare estimation: Simple distance-based estimate.
- Street snapping: Uses OSRM (Open Source Routing Machine) to draw routes aligned to streets.
- Geocoding & search: Uses Nominatim (OpenStreetMap) for place search and reverse geocoding.
- Route library: Includes a catalog of Metro Cebu jeepney lines.
C:/Repository/JeepMe/
├── src/
│ ├── app/ # Next.js App Router routes
│ ├── components/ # UI components
│ └── lib/ # Routing, OSRM, geocoding, data types
├── public/ # Static assets
└── .github/workflows/ # CI + GitHub Pages
npm install
npm run devOpen: http://localhost:3000
Live demo: https://recursivedev.github.io/JeepMe
Deployment is handled by: .github/workflows/pages.yml
See CONTRIBUTING.md.
If you're using agentic AI to contribute, read AGENTS.md first.
See SECURITY.md.
MIT — see LICENSE.
Route data is approximate and based on commonly known jeepney paths. Actual routes may vary due to traffic rerouting or driver decisions. Fare information is estimated and may not match actual collections.