The frontend should work directly as provided.
Several settings - including the URL for the routing server and the geocoder server - can be specified in
Different tile servers can be specified in
Note that the URL shortener used for generating route links only works with URLs pointing to the official Project-OSRM website.
masterbranch will always point to the latest released version of the frontend.
developbranch should always point to a working version with new features and bugfixes (think of it as a nightly-build).
- Other branches contain various work in progress.
Please use the OSRM-Project bug tracker (4) for submitting any bug reports or feature requests.
If you like to contribute, simply fork the project and start coding. It is best practice to create a new branch (from the current master) with a descriptive name for your contributions. When you are done, send a pull request from that branch. With this workflow, each pull request is isolated and can be easily merged.
Integration into Project-OSRM repository
The Project-OSRM repository already contains the frontend repository as a submodule. It will always point to the latest deployed version. To successfully work a repository that contains submodules, use the following git commands (available in git 1.7.1+):
git clone --recursive
to clone a repository and the contained submodules
git pull && git submodule update
to pull the latest version of the repository and update its submodules if required
Note that the frontend can also be checked out independently of the Project-OSRM repository.
The frontend has been tested with Firefox 3.0+, Internet Explorer 8+ and Chrome 18+. Certain visuals like rounded corners or moving boxes will only show in newer browser versions. But no actual functionality is affected by this. Note that the frontend will not work with Internet Explorer 6 or 7.
(1) Cloudmade Leaflet: http://leaflet.cloudmade.com/
(2) Project OSRM: http://project-osrm.org/
(3) Project OSRM Frontend: http://map.project-osrm.org/
(4) Project OSRM Bugtracker: https://github.com/DennisOSRM/Project-OSRM/issues/