Need help with osm-liberty?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

258 Stars 75 Forks Other 211 Commits 15 Opened issues


A free Mapbox GL basemap style for everyone

Services available


Need anything else?

Contributors list

OSM Liberty BSD licensed GitHub CI status

OSM Liberty

A free Mapbox GL basemap style for everyone with complete liberty to use and self host. OSM Liberty is a fork of OSM Bright based on free data sources with a mission for a clear good looking design for the everyday user. It is based on the vector tile schema of OpenMapTiles.

Preview OSM Liberty with Maputnik


You can use the style in your Mapbox GL maps.

By default, the vector tiles and glyphs are served from Maptiler Cloud and the raster tiles and sprites directly from GitHub. You would need to subscribe to Maptiler Cloud to get an access key and replace the placeholder {key} for the vector source and glyphs with your own key.

Another option is to create your own vector tiles with OpenMapTiles and host the tiles and assets yourself for complete liberty.

  OSM Liberty


Data Sources

Map Design

The map design originates from OSM Bright but strives to reach a unobtrusive and clean design for everyday use. Colored relief shading from Natural Earth make the low zoom levels look good.

OSM Liberty Map demo

Edit the Style

You can edit the style directly online in Maputnik.

This style actually triggered the need for the development of Maputnik.

A pre-commit hook is included to validate and format the JSON styles using

. To use, just install the NPM dev dependencies:

npm install
and then validate or format the style with
npm run validate
npm run format

Validation and reformatting will happen automatically on commit if you have the dependencies installed.

Icon Design

A Maki icon set using colors to distinguish between icon categories.

Maki is a living project and adds new icons over time, which means that there could be new icons that OSM Liberty could use for POIs.
is a simple script to list both the names in OSM Liberty's iconset that don't map to any valid Maki name, and the Maki names that are not currently used in OSM Liberty's iconset. You can run the script with

Color Palette

Color Name

Hex Value


Light Blue |

Orange |
Red |
Brown |
Green |

Modify Icons

  1. Take the
    and import it to the Maki Editor.
  2. Apply your changes and download the icons in SVG format and the iconset in JSON format.
  3. Optional: Format the JSON with
    cat iconset.json | jq -MS '.'
    for better legibility.
  4. Add the SVG files from the folder svgsnotin_iconset to the folder
    downloaded from the Maki Editor. These are the SVGs for road shields, the dot used for city and town layers and the road area pattern which could not be modified using the Maki Editor. To modify these you could use e.g. Inkscape.
  5. Install spritezero-cli:
    npm install -g @mapbox/spritezero-cli
  6. Generate the low resolution sprite:
    spritezero osm-liberty ./svgs/
  7. Generate the high resolution sprite:
    spritezero --retina [email protected] ./svgs/

Have a look at ...

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.