# protomaps/PMTiles

Pyramids of map tiles in a single file on static storage

Repository: https://github.com/protomaps/PMTiles
Canonical: https://ross.abutalabs.com/products/pmtiles
Homepage: https://protomaps.com/docs/pmtiles/
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: serverless, pmtiles
Last push: 2026-08-19T17:09:15+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 2024, "days_push": 14, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3015, forks 196 (observed 2026-08-28T04:07:37.940124+00:00)

## What it is
PMTiles is a single-file archive format for pyramids of map tiles that can be hosted on commodity static storage like S3 and accessed via HTTP Range Requests. It includes libraries (JavaScript, Python, Go, OpenLayers) and a CLI for creating, converting, extracting, and serving tile archives without a custom tile server.

## Use cases
- host map tiles on S3 without a tile server
- convert mbtiles to pmtiles
- extract a regional subset of a planet-wide basemap
- serve vector tiles serverlessly from cloud storage
- display pmtiles archives in MapLibre or Leaflet
- reduce map hosting costs by eliminating tile backends

## When to choose
- you want low-cost, zero-maintenance map hosting on static object storage
- you need a single-file tile archive instead of millions of tile files
- you want to avoid running a tile server or paying a third-party tile provider

## When to avoid
- you need real-time tile generation or frequent tile updates
- your storage or CDN does not support HTTP Range Requests
- you need features of a full tile server like dynamic styling or on-the-fly reprojection

## Facets
- artifact type: library
- maturity: active
- function: geospatial, http-client, cli
- domain: web-development, cloud-computing
- platform: browser, python, go, cloud, serverless
- tags: pmtiles, map-tiles, single-file-archive, static-storage, serverless-maps, range-requests, vector-tiles, gis, file-format, maps, geospatial, web-server, nodejs

## Member repositories
- protomaps/PMTiles (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:37.940124+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:46:58.256839+00:00, confidence not recorded.
  - readme: https://github.com/protomaps/PMTiles (fetched 2026-08-28T04:07:37.940124+00:00, sha d5557bb79f5f)
  - homepage: https://protomaps.com/docs/pmtiles/ (fetched 2026-08-29T09:45:41.714842+00:00, sha c3f4f3231f7a)
  - site_page: https://docs.protomaps.com/guide/getting-started (fetched 2026-08-29T09:45:41.723908+00:00, sha 3bd8fb04f1c7)
- Data as of 2026-08-30T08:39:29.467469+00:00.