✦ Leaf through your geodata

GeoLeaf
Your territories, mapped.

Built on MapLibre GL JS 5, GeoLeaf renders and styles your geographic data (POI, routes, polygons, GeoJSON) directly in the browser. 100 % frontend · Open source (MIT) · JSON-configurable · Mobile & tablet ready.

See the demo Get started in 5 min →
Why GeoLeaf?

What you can do with GeoLeaf

Visualize, explore and share your business geographic data — with no heavy development, no backend dependency, configurable through simple JSON files.

Visualize your geographic data

Without a single line of code

Display thousands of POI, zones and routes on a WebGL GPU-accelerated map. Automatic clustering, heatmaps, rich popups — all driven by your JSON profiles.

  • ✓Colors, icons, zoom thresholds and custom styles in JSON — no code changes required
  • ✓Automatic marker clustering, heatmaps and category-based groupings
  • ✓Rich POI popups and detail panels: images, links, data tables, action buttons
  • ✓Smooth 60 FPS rendering with 10,000+ simultaneous entities via WebGL

Explore, filter & analyze

Everything is profile-configurable

Offer your users a rich navigation experience — search, combined filters, detailed side panel and table view — with no custom development.

  • ✓Instant text search + filters by category, value or geographic distance
  • ✓Combinable URL-persistent filters — share a filtered view as a single link
  • ✓Multi-column sortable table view with CSV export from any profile
  • ✓100% configurable side panel — sections, fields and layout defined in JSON

Integrate anywhere, no backend needed

Zero proprietary server

GeoLeaf is 100% frontend — an npm import or a CDN tag, a JSON profiles folder and you're ready to go. No backend dependency, no cloud subscription.

  • ✓Compatible with Odoo, WordPress, ERP, REST API, static files or CDN
  • ✓Installable iOS/Android PWA — offline mode with smart cache (Storage Plugin)
  • ✓One profile = one versioned, deployable, hot-swappable JSON folder
  • ✓Full branding configurable: logo, colors, themes, language — no recompilation
Use cases

A cross-industry solution

GeoLeaf adapts to any business context — a single JSON profile is enough to switch from one sector to another.

Tourism & territories

  • Themed circuits and routes
  • Cultural, natural and heritage POI
  • Accommodation, dining and activities
  • Tourist offices, travel agencies

Local government & public services

  • Public facilities and recycling centers
  • Stops, regulated and restricted zones
  • Citizen portal or internal tool
  • Municipalities, intermunicipal bodies

Utilities & energy

  • Street lighting, water, gas, fiber optic
  • Fault and incident localization
  • Real-time equipment status
  • Planned maintenance on map

Mobility & transport

  • Bus lines and service zones
  • Parking and bike-sharing stations
  • Real-time fleet tracking
  • WebSocket plugin for live data

CMMS & asset management

  • Geolocated equipment and sensors
  • Street furniture with status and history
  • Filters by status, date or technician
  • Field tracking and maintenance

Environment & agriculture

  • Agricultural parcels and protected areas
  • Climate measurements and rainfall data
  • IoT sensors on map
  • Time filters and historical data

Logistics & supply chain

  • Delivery and collection rounds
  • Warehouses and service zones
  • Multi-criteria search and filters
  • CSV export of field data

Healthcare & proximity services

  • Healthcare facilities and pharmacies
  • Social and medico-social services
  • Filters by specialty and accessibility
  • Geographic coverage zones

Real estate & urban planning

  • Lots, parcels and zoning areas
  • New developments and listings
  • Developers, agencies and territory clusters
  • Interactive map embedded as iframe or SDK
Core features

A complete mapping foundation

GeoLeaf Core is an open-source (MIT), modular, 100 % frontend mapping framework designed to display, structure and explore business geographic data.

Interface & themes

Light / Dark theme with automatic or forced selection. Customizable color palettes, basemap selector (Street, Topo, Satellite…), legend, data table and on-demand filters.

Business profiles & taxonomy

Multi-profile architecture: one profile = one self-contained, versioned folder. Categories, subcategories and SVG icon sets per domain, configurable in JSON without touching the GeoLeaf core.

Layers & geodata

Native support for points, polylines and polygons, vector tiles (MVT/PBF). Supported formats: business JSON, GeoJSON, GPX. Native MapLibre GL JS high-performance clustering and icon or vector rendering.

Popups & side panel

Configurable tooltips, rich popups (text, images, tags, links), section-structured side panel, data table with sorting, search and CSV export.

Filters & search

Side filter panel, per-layer and per-field indexing. Simple or combined text search, tag and category filters, geographic proximity search.

Mobile & performance

100 % responsive interface, designed for field use on smartphones and tablets. WebGL GPU-accelerated rendering, 10 000+ markers at 60 FPS, ~35 KB gzipped.

Modular architecture

Driven by JSON files

GeoLeaf is built on a modular architecture cleanly separating the mapping engine, data and business rules — independently versionable and deployable.

Business profiles (profiles/<profile_id>)

Each profile is a folder of self-contained JSON files, independently versionable and deployable from the GeoLeaf core. Activate a profile via the global config to instantly switch from one business domain to another.

  • → profile.json — Profile identity, bounds, initial zoom, padding and map behaviors.
  • → ui.json — Visible controls, language, panels, table, geolocation and permalinks.
  • → layers.json + layers/ — Layer manifest + one file per layer (source, MapLibre style, filters).
  • → taxonomy.json — Categories, subcategories, SVG icons and marker styles.
  • → themes.json — Predefined map themes, business views and activatable layer groups.
  • → basemaps.json — Available base maps (URLs, attributions, zoom levels, default basemap).
  • → mapping.json (optional) — Normalizes heterogeneous sources to GeoLeaf's internal model.
GeoLeaf profile architecture — JSON folders and files
Developer integration

Ready to integrate in 5 minutes

GeoLeaf Core is published as ESM-only on npm. Native TypeScript, 30 named exports, 15 typed events — no build configuration required.

GeoLeaf initialization 
import { GeoLeaf } from '@geoleaf/core';

const map = await GeoLeaf.init({
  container: 'map',
  profile: 'my-profile',
  theme: 'light',
});

map.on('poi:click', ({ feature }) => {
  console.log(feature.properties.name);
});

map.on('filter:apply', ({ filters }) => {
  console.log(filters);
});
TypeScript ESM-only ~35 KB gzip MIT MapLibre GL JS 5 Node ≥18
  • → Full type definitions included (index.d.ts) — complete IntelliSense in VS Code and all LSP IDEs.
  • → 15 typed events: poi:click, filter:apply, layer:toggle and more — fully documented event API.
  • → Modular architecture with 11 lazy-loaded chunks — load only what you need.
  • → Installable iOS/Android PWA, WCAG 2.1 AA compliant — focus trap, aria-modal, i18n ×6 languages.
Plugin ecosystem

Extend GeoLeaf to fit your needs

GeoLeaf Core covers the essentials. Commercial plugins unlock advanced use cases — each is self-contained, activated by a single line of JSON configuration.

Available Commercial

Storage Plugin

Full offline cache with IndexedDB and Service Worker. Two-way sync, quota management, quota alerts and transparent offline mode.

Request a quote
Available Commercial

AddPOI Plugin

Full CRUD form to create, edit and delete POI directly on the map. Touch placement mode, real-time validation, photo upload.

Request a quote
Roadmap Q3 2026 MIT

Annotation & Measure Plugin

Add text and graphic annotations on the map. Distance and area measurement. Exportable as GeoJSON.

Coming soon
Roadmap Q3 2026 Commercial

Geometry Editing Plugin

Interactive editing of geometries (points, lines, polygons) directly on the map. Topological validation and change history.

Coming soon
Roadmap 2026 Commercial

GPS Plugin

Real-time GPS tracking with route recording. Field-optimized mode, GPX trace and automatic server sync.

Coming soon
Roadmap 2026 Commercial

Charts Plugin

Charts embedded in popups and side panels. Histograms, time series and pie charts driven by business attributes.

Coming soon
Roadmap 2026 Commercial

QGIS 4 Plugin

Direct export from QGIS 4 to GeoLeaf format. Styles, layers and data converted automatically — zero manual re-entry.

Coming soon
Roadmap

What's coming to GeoLeaf

Roadmap prioritized based on user feedback. Core items are MIT; commercial plugins are listed separately.

✅ Delivered

01 — @geoleaf/connector v1.0.0

Universal fetch interceptor for authenticated sources (WFS, OGC, FlatGeobuf, Bearer tokens). Available on npm.

MIT Plugin

Q2 2026

02 — Lightweight authentication layer

Integration of a lightweight auth layer in Plugin Connector: sessions, roles and per-layer permissions.

Plugin Connector

Q2 2026

03 — Performance profiling dashboard

Built-in performance metrics dashboard — render time, memory usage, number of displayed entities.

Core

Q2 2026

04 — Profile & JSON — In-app configurator

In-app configuration interface for the profile folder — create and edit JSON files (profile, ui, layers, taxonomy, themes, basemaps), create a new profile in a few clicks, without file manipulation.

Commercial Plugin

Q2 2026

05 — Geocoding & address search

Address search and geocoding directly in the map interface, with configurable providers (Nominatim, IGN…).

Core

Q2 2026

06 — First-connection tutorial

Interactive onboarding flow for new users — step-by-step guide with contextual tooltips.

Core

Q3 2026

07 — Geometry editing

Interactive editing of vector geometries (points, lines, polygons) with topological validation.

Commercial Plugin

Q3 2026

08 — Annotation & measure

Text and graphic annotations on the map. Distance and area measurement, GeoJSON export.

MIT Plugin

Q3 2026

09 — Print & PDF capture

Map capture with configured layout. High-resolution PDF export with legend and north arrow.

Core (capture) Commercial Plugin (PDF)

Q3 2026

10 — Additional basemap providers

Pre-configured providers (IGN, Stamen, CartoDB, ESRI) and simplified WMS/WMTS tile support.

Core

Q3 2026

11 — User data import

Drag & drop GeoJSON and KML files directly onto the map — instant display without reconfiguration.

Core

Q3 2026

12 — WebSocket Plugin — Real-time POI

Real-time POI updates via WebSocket — live positions, geographic alerts, IoT streams.

MIT Plugin

2026+

13 — View sharing & QR Code

Generate a short link or QR Code sharing the current map state (position, zoom, active layers, filters).

Core

2026+

14 — Extended export (CSV, Excel, KML)

New export formats for map data — native Excel, enriched KML, profile-configurable CSV.

Core

2026+

15 — GPS module & route tracking

Real-time GPS tracking with route recording, GPX trace and automatic server sync.

Commercial Plugin

2026+

16 — Route calculation (routing)

Optimized route calculation with configurable providers (OSRM, Valhalla, ORS). Walking, cycling, driving modes.

Commercial Plugin

2026+

17 — Legend-only print

Export and print the map legend independently from the map — for field sheets and reports.

Core

2026+

18 — Charts Plugin

Charts embedded in popups and side panels — histograms, time series, pie charts.

Commercial Plugin

2026+

19 — QGIS 4 Plugin

Direct export from QGIS 4 to GeoLeaf format — styles, layers and data converted automatically.

Commercial Plugin
Core (MIT) MIT Plugin Commercial Plugin
Open source license

GeoLeaf Core — Free Forever (MIT)

Free for any use, including commercial, with no subscription or usage restrictions.

⭐ Open source — MIT License
GeoLeaf Core
Free Forever MIT

Modern, modular and independent frontend mapping framework to display and explore your business geographic data.

  • Free for any use, including commercial
  • Modification and redistribution allowed
  • No proprietary backend dependency
  • Compatible with Odoo, SaaS, API, static files
  • Full public documentation
  • Branding configurable in JSON to support the project
  • @geoleaf/connector — MIT fetch interceptor (npm install @geoleaf/connector)
Download on GitHub
Plugins & extensions

Offline storage, AddPOI, GPS, Charts, Geometry editing, QGIS 4…
Discover all available plugins and their license.

View plugins →
Frequently asked questions

Everything you need to know about GeoLeaf

Yes. GeoLeaf Core is released under the MIT license. It can be freely used, including in professional or commercial projects, as long as the copyright notice and license text are retained upon redistribution.
No. GeoLeaf is a 100 % frontend library, built on MapLibre GL JS, that consumes JSON data. It can be used with Odoo, another ERP, a CMS, a custom API or static files, with no imposed server dependency.
The basemap selector controls only the background map (tiles). Business layers (POI, GeoJSON, routes, overlays) are managed separately via the legend and layer manager, to allow precise control over displayed data.
Yes. GeoLeaf Core includes an offline mode via its Service Worker, enabling reuse of already-loaded resources (assets and profile resources).
Yes. GeoLeaf Core lets you start with a simple setup (frontend scripts and static data), then progressively evolve towards more advanced use cases: backend integration, complex business profiles, field features or optional modules as needed.
Contact

Need help with GeoLeaf ?

GeoLeaf is an open source framework. If you need assistance with integration, designing a business profile, adapting it to your architecture (ERP, API, CMS) or developing specific features, describe your context. We respond within 48h.

Website

www.mp-i.pro

LinkedIn

Mattieu Pottier

Availability

Mon – Fri, 9am – 6pm CET