osm-liberty-dark/README.md

# OSM Liberty [![BSD licensed](https://img.shields.io/badge/license-BSD-blue.svg)](https://github.com/maputnik/osm-liberty/blob/gh-pages/LICENSE.md) [![Build Status](https://travis-ci.org/maputnik/osm-liberty.svg?branch=gh-pages)](https://travis-ci.org/maputnik/osm-liberty)

<img align="right" alt="OSM Liberty" src="logo.png" />

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](https://github.com/openmaptiles/openmaptiles).

**[Preview OSM Liberty with Maputnik](https://maputnik.github.io/editor/?style=https://rawgit.com/maputnik/osm-liberty/gh-pages/style.json)**

## Usage

You can use the style in your Mapbox GL maps. 

By default, the vector tiles are served from [Maptiler Cloud](https://www.maptiler.com/cloud/) and the raster tiles, glyphs and sprites directly from GitHub.
You would need to [subscribe](https://www.maptiler.com/cloud/plans) to Maptiler Cloud to get an access key and replace the placeholder {key} [here](https://github.com/maputnik/osm-liberty/blob/gh-pages/style.json#L19) with your own key.


Another option is to create your own vector tiles with [OpenMapTiles](https://github.com/openmaptiles/openmaptiles) and host the tiles and assets yourself for complete liberty.

```html
<!DOCTYPE html>
<html>
<head>
  <meta charset=utf-8 />
  <title>OSM Liberty</title>
  <meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' />
  <style>
    body { margin:0; padding:0; }
    #map { position:absolute; top:0; bottom:0; width:100%; }
  </style>
  <script src='https://api.tiles.mapbox.com/mapbox-gl-js/v0.48.0/mapbox-gl.js'></script>
  <link href='https://api.tiles.mapbox.com/mapbox-gl-js/v0.48.0/mapbox-gl.css' rel='stylesheet' />
</head>
<body>
  <div id='map'></div>
  <script>
  var map = new mapboxgl.Map({
      container: 'map',
      style: 'https://maputnik.github.io/osm-liberty/style.json',
      center: [8.538961,47.372476],
      zoom: 5,
      hash: true
  });
  </script>
</body>
</html>
```

## Data Sources

- [OpenMapTiles](http://openmaptiles.org/) as vector data source
- [Natural Earth Tiles](http://naturalearthtiles.org) for relief shading
- [Maki](https://www.mapbox.com/maki-icons/) as icon set

## 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](demo/zoom.gif)](https://maputnik.github.io/osm-liberty/)

## Edit the Style

You can [edit the style directly online in Maputnik](https://maputnik.github.io/editor?style=https://rawgit.com/maputnik/osm-liberty/gh-pages/style.json).

This style actually triggered the need for the development of [Maputnik](https://github.com/maputnik/editor/).

## Icon Design

A [Maki](https://github.com/mapbox/maki) icon set using colors to distinguish between icon categories.

**Color Palette**

Color Name   | Hex Value
-------------|----------
Blue         | `#5d60be`
Light Blue   | `#4898ff`
Orange       | `#d97200`
Red          | `#ba3827`
Brown        | `#725a50`
Green        | `#76a723`

**Modify Icons**

1. Take the `iconset.json` and upload it to the [Maki Editor](https://www.mapbox.com/maki-icons/#editor).
2. Apply your changes and download the fonts and icon set again.
3. Ensure you format the JSON first with `cat iconset.json | jq -MS '.'`
4. Install [spritezero](https://github.com/mapbox/spritezero) `npm install spritezero-cli`
5. Generate the low resolution sprites `spritezero sprites/osm-liberty ./svgs/`
6. Generate the high resolution sprites `spritezero sprites/osm-liberty@2x ./svgs/`
Move from lukasmartinelli/osm-liberty -> maputnik/osm-liberty 6 years ago			`# OSM Liberty [![BSD licensed](https://img.shields.io/badge/license-BSD-blue.svg)](https://github.com/maputnik/osm-liberty/blob/gh-pages/LICENSE.md) [![Build Status](https://travis-ci.org/maputnik/osm-liberty.svg?branch=gh-pages)](https://travis-ci.org/maputnik/osm-liberty)`
Update README.md 6 years ago
Add logo 8 years ago			`<img align="right" alt="OSM Liberty" src="logo.png" />`

Update README.md 6 years ago			`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](https://github.com/openmaptiles/openmaptiles).`
Add demo images 8 years ago
Update README.md 6 years ago			`[Preview OSM Liberty with Maputnik](https://maputnik.github.io/editor/?style=https://rawgit.com/maputnik/osm-liberty/gh-pages/style.json)`
Add HTML sample 8 years ago
			`## Usage`

Update README.md 6 years ago			`You can use the style in your Mapbox GL maps.`

			`By default, the vector tiles are served from [Maptiler Cloud](https://www.maptiler.com/cloud/) and the raster tiles, glyphs and sprites directly from GitHub.`
			`You would need to [subscribe](https://www.maptiler.com/cloud/plans) to Maptiler Cloud to get an access key and replace the placeholder {key} [here](https://github.com/maputnik/osm-liberty/blob/gh-pages/style.json#L19) with your own key.`


			`Another option is to create your own vector tiles with [OpenMapTiles](https://github.com/openmaptiles/openmaptiles) and host the tiles and assets yourself for complete liberty.`
Add HTML sample 8 years ago
			```html
			`<!DOCTYPE html>`
			`<html>`
			`<head>`
			`<meta charset=utf-8 />`
			`<title>OSM Liberty</title>`
			`<meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' />`
			`<style>`
			`body { margin:0; padding:0; }`
			`#map { position:absolute; top:0; bottom:0; width:100%; }`
			`</style>`
Update README.md 6 years ago			`<script src='https://api.tiles.mapbox.com/mapbox-gl-js/v0.48.0/mapbox-gl.js'></script>`
			`<link href='https://api.tiles.mapbox.com/mapbox-gl-js/v0.48.0/mapbox-gl.css' rel='stylesheet' />`
Add HTML sample 8 years ago			`</head>`
			`<body>`
			`<div id='map'></div>`
			`<script>`
			`var map = new mapboxgl.Map({`
			`container: 'map',`
Move from lukasmartinelli/osm-liberty -> maputnik/osm-liberty 6 years ago			`style: 'https://maputnik.github.io/osm-liberty/style.json',`
Add HTML sample 8 years ago			`center: [8.538961,47.372476],`
			`zoom: 5,`
			`hash: true`
			`});`
			`</script>`
			`</body>`
			`</html>`
			```

Add demo images 8 years ago			`## Data Sources`

3D buildings should be before roads 7 years ago			`- [OpenMapTiles](http://openmaptiles.org/) as vector data source`
Add OSM reference 8 years ago			`- [Natural Earth Tiles](http://naturalearthtiles.org) for relief shading`
Add demo images 8 years ago			`- [Maki](https://www.mapbox.com/maki-icons/) as icon set`
Add style 8 years ago
			`## Map Design`

Add HTML sample 8 years ago			`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.`
Add demo images 8 years ago
Move from lukasmartinelli/osm-liberty -> maputnik/osm-liberty 6 years ago			`[![OSM Liberty Map demo](demo/zoom.gif)](https://maputnik.github.io/osm-liberty/)`
Update README.md 8 years ago
Remove interactive 7 years ago			`## Edit the Style`
Add HTML sample 8 years ago
Update edit link 6 years ago			`You can [edit the style directly online in Maputnik](https://maputnik.github.io/editor?style=https://rawgit.com/maputnik/osm-liberty/gh-pages/style.json).`
Add Maputnik link 7 years ago
Update README.md 6 years ago			`This style actually triggered the need for the development of [Maputnik](https://github.com/maputnik/editor/).`
Add HTML sample 8 years ago
Add style 8 years ago			`## Icon Design`

			`A [Maki](https://github.com/mapbox/maki) icon set using colors to distinguish between icon categories.`

			`Color Palette`

			`Color Name \| Hex Value`
			`-------------\|----------`
			Blue \| `#5d60be`
			Light Blue \| `#4898ff`
			Orange \| `#d97200`
			Red \| `#ba3827`
			Brown \| `#725a50`
			Green \| `#76a723`

			`Modify Icons`

3D buildings should be before roads 7 years ago			1. Take the `iconset.json` and upload it to the [Maki Editor](https://www.mapbox.com/maki-icons/#editor).
Regenerate sprites 7 years ago			`2. Apply your changes and download the fonts and icon set again.`
Add style 8 years ago			3. Ensure you format the JSON first with `cat iconset.json \| jq -MS '.'`
Regenerate sprites 7 years ago			4. Install [spritezero](https://github.com/mapbox/spritezero) `npm install spritezero-cli`
			5. Generate the low resolution sprites `spritezero sprites/osm-liberty ./svgs/`
			6. Generate the high resolution sprites `spritezero sprites/osm-liberty@2x ./svgs/`