mirror of https://github.com/a-nyx/maputnik-with-pmtiles.git synced 2024-12-26 18:30:40 +01:00

A Maputnik fork with the pmtiles protocol.

Find a file

lukasmartinelli a377fcdb7f Explain reason for building in README		2016-09-11 14:25:03 +02:00
src	Example how to display fields from spec	2016-09-10 22:58:15 +02:00
.editorconfig	Initial commit	2016-09-08 19:49:23 +02:00
.gitignore	Initial commit	2016-09-08 19:49:23 +02:00
LICENSE	Change names in package.json and License	2016-09-08 19:52:06 +02:00
mapolo.png	Explain reason for building in README	2016-09-11 14:25:03 +02:00
package.json	Fix build process for mapbox gl	2016-09-10 16:05:04 +02:00
README.md	Explain reason for building in README	2016-09-11 14:25:03 +02:00
webpack.config.js	Fix build process for mapbox gl	2016-09-10 16:05:04 +02:00
webpack.loaders.js	Fix build process for mapbox gl	2016-09-10 16:05:04 +02:00
webpack.production.config.js	Fix build process for mapbox gl	2016-09-10 16:05:04 +02:00

README.md

Mapolo

A free and open visual editor for the Mapbox GL styles targeted at developers and map designers. With Mapolo everyone can design their own custom map!

Features

Completely free and open source
Visual interface for designing maps
Immediate feedback
Edit layers
No vendor lock-in, no proprietary base styles
Easy to deploy as single HTML file

Roadmap

Add new layers
Support all layer types
Choose sources
Filter data from sources
Support zoom level specific values
Faster map feedback with custom diff algorithm
Tests for React components
Make it prettier

Reason

Mapbox GL is one of the biggest innovations the GIS world and is the first cross platform framework to display maps on mobile devices, the browser and the desktop. Maps are styled using a JSON style document with properties described in the Mapbox GL style specification. The style specification is adopted in more and more clients such as Open Layers 3 and therefore the missing piece in the puzzle is a style editor that is easy to use, free and open source!

In constrast to earlier approaches using CartoCSS the format is difficult to edit by hand but much more suitable for generating from an editor. As of today Mapbox GL styles are usually designed within the cloud based Mapbox Studio which is a great example how a style editor should look like.

The big problem is that Mapbox Studio is not open source and you have to upload your data sources to external servers and essentially are locked in the Mapbox ecosystem. By reusing existing proprietary base styles you legally tie your style for use with Mapbox services. It is difficult to use other data source like OSM2VectorTiles, Mapzen or Kartotherian or even your own custom vector tile sources.

This is why I think we should rally behind and build our own style editor for the Mapbox GL style specification!

Develop

Mapolo is written in ES6 and is using React, Immutable.js and Mapbox GL JS.

Install the deps, start the dev server and open the web browser on http://localhost:8888/.

# install dependencies
npm install
# start dev server
npm start

Build a production package for distribution.

npm run build

Lint the JavaScript code.

# install lint dependencies
npm install --save-dev eslint eslint-plugin-react
# run linter
npm run lint