Docs/Introduction

Introduction

Hexagone UI, c’est « shadcn/ui pour la cartographie française » : des composants React drop-in, déjà câblés sur les données officielles (IGN/Géoplateforme, BAN, cadastre, PLU, DVF, Géorisques), installables via la CLI shadcn.

1 Le principe

On ne vend pas la donnée — elle est ouverte, gratuite et sans clé sur data.geopf.fr. On vend le fait d’éviter la douleur de l’intégrer : projections Lambert-93 ↔ Web Mercator, quirks WFS de la Géoplateforme, styles, légendes, attribution légale, et surtout la maintenance face aux changements d’API gouvernementales.

Le moat = la maintenance, pas le code

Quand l’IGN casse quelque chose (la bascule Géoplateforme l’a prouvé), on pousse le correctif dans @geekles007/core — un simple npx shadcn add le récupère.

2 OSS & Pro

Le registry est open-core, distribué sous le scope @geekles :

OSS @geekles — OSS, MIT, gratuit

MapFR, AddressSearch, LayerControl et les hooks useGeoplateforme / useGeocodeFR. Aucune clé requise.

Pro @geekles-pro — abonnement

CadastreLayer, PLULayer, ParcelReport : les composants « pénibles à faire soi-même », gatés par clé API et tenus à jour contre les migrations d’API.

3 Comment ça marche

Comme shadcn : la CLI copie le code dans votre projet. Vous le lisez, le modifiez, il vit dans votre repo — pas dans un node_modules opaque. Le registry OSS est public ; le registry Pro est résolu via un header Authorization: Bearer à partir de votre components.json.

4 Étapes suivantes

Prêt à intégrer ?