JavaScript HTML Python CSS Dockerfile Shell C
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
client code style Aug 16, 2018
documentation Fix missing translated changelog in documentation Aug 21, 2018
.gitignore Wip fixing test suite Jul 5, 2018
LICENSE Doc + Licenses + Dependencies versions Aug 10, 2017 update manifest file Jun 8, 2017 update contributing and readme files May 22, 2018

Release name Build Status Docker Build Status

[en] Magrit is an online mapping application developed by UMS RIATE.
[fr] Magrit est une application de cartographie thématique développée par l'UMS RIATE.


  • Magrit is an online application for thematic mapping (cartography).
  • It's intentionally simple (the UI follows the basic steps of map creation).
  • It's designed for teaching and learning cartography.
  • It lets you import your own geometry dataset (Shapefile, GeoJSON, GML, etc.) and optionnaly your tabular file.
  • We also provide many sample datasets to try out the various representations and become familiar with the application.
  • It allows to render and combine a wide variety of maps: choropleth, proportional symbols, cartogram, discontinuity, etc.
  • It supports the most popular modern desktop browsers: Chrome, Firefox and Opera (+ Edge and Safari with limitations).
  • Server-side, Magrit is backed by a python 3.5+ application (particularly for some geoprocessing tasks relying on GDAL, GEOS and PROJ.4 libraries).
  • Client-side, Magrit is written in modern JS (ES6) and uses notably the d3.js library.


Most users should go on :


More maps are available in the gallery.

Simple installation / Installation for development

The only targeted/tested OS for development is currently GNU/Linux.
However, you can install it on other platforms, which are supported by Docker (GNU/Linux, FreeBSD, Windows 64bits, MAC OSX) which is the preferred solution if you want to install Magrit for using it but don't want to do any development:

To install Magrit directly on your GNU/Linux system you have to install some shared libraries and python libraries. Once installed, the python server application can take care to concatenate/transpile/etc. the JS and CSS code. These steps are detailed in the Wiki and in the file:

Contributing to Magrit

Contributions are welcome! There are various way to contribute to the project which are detailed in CONTRIBUTING file! You can notably:

  • Report bugs or send us feedback.
  • Add new translations or fix existing ones.
  • Contribute code (you're in the right place! Clone the repo, fix what you want to be fixed and submit a pull request).
  • Contribute to the gallery by submitting your best maps.