# GeoLeaf — client cartographique open source (MIT)

> GeoLeaf JS est une bibliothèque cartographique JavaScript et TypeScript open source (licence MIT), bâtie sur MapLibre GL JS 6. Une application cartographique entière se décrit par un profil JSON — couches, styles, thèmes, taxonomie des points d'intérêt — sans code applicatif. Paquet npm `@geoleaf/core` (version 3.4.0), dépôt public github.com/geoleaf/geoleaf-js. Éditée par MP-i (Mattieu Pottier), qui édite aussi GeoLeaf Suite, les modules cartographiques pour Odoo.

GeoLeaf ajoute une carte interactive à n'importe quel site ou application, sans backend dédié : c'est une bibliothèque 100 % frontend qui consomme des données JSON (Odoo, autre ERP, CMS, API ou fichiers statiques). Architecture en trois couches : un noyau de 13 sous-systèmes toujours présents, 21 capacités in-core autonomes activées par `modules.<id>` dans le profil, et 12 plugins MIT branchés au démarrage sur `GeoLeaf.*`, sans couplage à la compilation. Un drapeau de configuration désactive une capacité ; seul le choix au build retire son code du fichier téléchargé — l'intégrateur écrit son entrée et le reste est tree-shaké, CSS compris. Mesuré le 09/08/2026 : 181,6 → 148,0 Ko gzip au démarrage en passant de 21 à 6 capacités.

Les 12 plugins : connecteur authentifié, éditeur de géométries, impression PDF, mesure, tableau, géocodage, interface hors ligne, import de fichiers (GPX/KML/CSV/TopoJSON), FlatGeobuf, COG raster, couches temps réel et transport WebSocket. Le moteur hors ligne est intégré au cœur (Service Worker, cache des tuiles et des données, synchronisation via IndexedDB) ; les saisies faites hors réseau sont enregistrées puis rejouées de façon idempotente.

Installation : `npm install @geoleaf/core maplibre-gl`. MapLibre GL JS 6 est une peer dependency : il n'est pas embarqué, il est ESM-only et exige WebGL2. Node 22 ou plus n'est requis que pour la chaîne de build. Sécurité : Content Security Policy stricte (style-src sans 'unsafe-inline'), échappement du HTML et validation des URL au rendu, jetons CSRF, blocage de la prototype-pollution.

## Pages

- [Accueil (FR)](https://www.geoleaf.dev/) : présentation, cas d'usage, galerie, architecture des profils, fonctionnalités, plugins, licence, FAQ, contact
- [Home (EN)](https://www.geoleaf.dev/en/) : la même page, en anglais
- [Démo interactive](https://demo.geoleaf.dev/) : carte de démonstration en ligne

## Documentation (en anglais)

- [Sommaire](https://www.geoleaf.dev/docs/)
- [Getting Started](https://www.geoleaf.dev/docs/GETTING_STARTED.html) : installation, première carte
- [Quickstart Tutorial](https://www.geoleaf.dev/docs/QUICKSTART_TUTORIAL.html)
- [CDN / NPM usage](https://www.geoleaf.dev/docs/usage-cdn.html)
- [Configuration Guide](https://www.geoleaf.dev/docs/CONFIGURATION_GUIDE.html)
- [Profiles Guide](https://www.geoleaf.dev/docs/PROFILES_GUIDE.html) et [Profile JSON Reference](https://www.geoleaf.dev/docs/PROFILE_JSON_REFERENCE.html)
- [API Reference](https://www.geoleaf.dev/docs/API_REFERENCE.html) et [Events API](https://www.geoleaf.dev/docs/EVENTS_API.html)
- [Plugin Configuration](https://www.geoleaf.dev/docs/PLUGIN_CONFIGURATION_GUIDE.html) et [Plugin Development](https://www.geoleaf.dev/docs/PLUGIN_DEVELOPMENT_GUIDE.html)
- [Security (CSP)](https://www.geoleaf.dev/docs/SECURITY.html)
- [FAQ](https://www.geoleaf.dev/docs/FAQ.html) et [Changelog](https://www.geoleaf.dev/docs/CHANGELOG.html)
- [Référence TypeDoc](https://www.geoleaf.dev/docs/api/) : référence d'API générée depuis le code

## Texte intégral

- [llms-full.txt](https://www.geoleaf.dev/llms-full.txt) : le contenu des pages du site et des guides de la documentation, concaténé. Fichier généré depuis le site, donc toujours à jour.

## Code et paquets

- [Dépôt GitHub](https://github.com/geoleaf/geoleaf-js) : monorepo — cœur, plugins et bibliothèques partagées
- [Paquet npm @geoleaf/core](https://www.npmjs.com/package/@geoleaf/core)

## Écosystème

- [GeoLeaf Suite](https://geoleaf-suite.dev/) : quinze modules cartographiques pour Odoo 19 (licence OPL-1), conçus pour Odoo 19 Enterprise, avec une variante Community
- [MP-i](https://www.mp-i.pro/) : éditeur de GeoLeaf — ingénierie de process, Odoo, SIG et cartographie

## Contact

- Email : contact@geoleaf.dev — réponse sous 48 h
- [Formulaire d'accompagnement](https://www.geoleaf.dev/#contact) : intégration, profil métier, développement spécifique
- LinkedIn : https://www.linkedin.com/in/mattieupottier/

## Mentions

- [Mentions légales](https://www.geoleaf.dev/mentions-legales.html)
- [Politique de confidentialité](https://www.geoleaf.dev/politique-confidentialite.html)
- Mesure d'audience : Umami auto-hébergé, sans cookie, aucun traceur tiers.