GeoLeafMapping library for the web

Interactive maps configured through JSON profiles — built on MapLibre GL JS.

Configured in JSON

GeoJSON layers, styles, themes, POI taxonomy — everything is configured through JSON profiles, with no code to write.

MapLibre GL JS v6 engine — WebGL rendering, native vector tiles, GPU clustering.

XSS protection, DOM sanitisation, CSP-ready — safe by default for production deployments.

Complete types, TSDoc on the public facades, ESM-only.

The core loads at startup; plugins are added to the map one at a time, as needed.

@geoleaf/core and the @geoleaf-plugins/* packages are all MIT licensed.

Three new MIT plugins: @geoleaf-plugins/file-import, @geoleaf-plugins/flatgeobuf, @geoleaf-plugins/cog.

What changed in v3.0.0:

New — @geoleaf-plugins/file-import (MIT) — import GeoJSON, KML, GPX and CSV from the browser
New — @geoleaf-plugins/flatgeobuf (MIT) — streaming reader for FlatGeobuf files
New — @geoleaf-plugins/cog (MIT) — native WebGL rendering of Cloud Optimized GeoTIFF

A major rendering engine migration: Leaflet → MapLibre GL JS v5. WebGL rendering, native GPU clustering, ESM-only.

Key changes:

Breaking — peer dependency leaflet → maplibre-gl, coordinates [lat,lng] → [lng,lat], scope geoleaf → @geoleaf/core
New — @geoleaf-plugins/connector v1.0.0 (MIT) — a universal fetch interceptor for authenticated geospatial sources
Removed — the UMD bundle; distribution is ESM-only
Tests — Jest → Vitest 3 migration, 8,317 tests, 77.97% branch coverage