
PMTiles
Single-file archive format for tiled map data, with a JavaScript library that reads it in browsers and Node.js.
PMTiles is a single-file archive format for tiled map data, with a JavaScript library that reads it in browsers and Node.js. An archive holds a tile pyramid in one file that can be hosted on a storage platform such as S3, and the reader fetches only the tiles it needs with HTTP range requests. The format is read-only, so an archive is written again in full when its contents change. The documentation describes the archive concepts and how the library works with map libraries such as MapLibre GL JS, Leaflet and OpenLayers.
Worth knowing
This record covers the format and the library only. The Protomaps project also runs a hosted tile API for its basemap, which is a separate service.
Identity
Rendering and deploy
- Install with
- npm, script tag6
Releases
Adoption
Sources
- 2026-11-16: links
protomaps.com/ - 2026-11-16: links, Written in, GitHub stars
github.com/protomaps/PMTiles - 2026-11-16: links, Categories
docs.protomaps.com/pmtiles/ - 2026-11-16: First release, Last release
registry.npmjs.org/pmtiles - 2026-11-16: Maintainer, Maintained by, License
github.com/protomaps/PMTiles/blob/main/LICENSE - 2026-11-16: Runtime, Install with
github.com/protomaps/PMTiles/blob/main/js/README.md - 2026-11-16: License model
protomaps.com/about - 2026-11-16: Current major version
registry.npmjs.org/pmtiles/latest - 2026-11-16: Contributors
api.github.com/repos/protomaps/PMTiles/contributors?per_page=1 - 2026-11-16: npm downloads a week
api.npmjs.org/downloads/range/2026-11-01:2026-11-07/pmtiles - 2026-11-16: Dependent packages, Dependent repositories
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/pmtiles