A vector map renderer for the web.

npm Test suite minzipped size

This project is a complete web map renderer - including quality label layout, pattern fills, and icons - in as simple as possible of an implementation. It’s an alternative to renderers like Mapbox GL JS in a fraction of the size.


See the docs on what protomaps.js is, what protomaps.js is not


How to use

<script src=""></script>
    const map ='map')
    var layer = protomaps.leafletLayer({url:'FILE.pmtiles OR ENDPOINT/{z}/{x}/{y}.pbf'})

Exports of OpenStreetMap data in PMTiles format can be obtained from

Project Status

The design is still evolving rapidly, so do not expect any kind of stable internal or external-facing API between minor versions. But please do report bugs and discuss requirements in the Issues.

See Also