GeoLeaf Versioning Policy
Version produit : Platform V2 Baseline SemVer technique : Core @geoleaf/core 2.0.x
Purpose
This policy separates:
- Product/marketing version (what users see):
GeoLeaf Platform V2 - Technical package versions (SemVer, tooling, CI/CD):
2.0.x,2.0.0, etc.
This avoids breaking package history, release pipelines, dependency updates, and compatibility tracking.
Official Mapping
| Product label | Technical SemVer |
|---|---|
GeoLeaf Platform V2 | @geoleaf/core@2.x.x |
V2.0.0 is based on MapLibre GL JS v5 (WebGL, ESM-only).
Documentation Rules
Use Platform V2 in:
- Landing pages and project overviews
- Product positioning sections
- Executive summaries and business-facing documents
Keep technical SemVer in:
package.jsonfilesCHANGELOG.md- release notes and git tags
- CDN/npm installation snippets
- migration and compatibility matrices
SemVer Rules for v2.x
| Change type | Version bump |
|---|---|
| Breaking API change (facade, init signature, etc.) | MAJOR (3.0.0) |
| New feature, new module, new named export (non-breaking) | MINOR (2.X.0) |
| Bug fix, performance patch, security fix | PATCH (2.0.X) |
Plugin Versioning
Commercial plugins follow independent SemVer versioning aligned with core compatibility:
| Plugin | Compatibility |
|---|---|
@geoleaf-plugins/storage | core@^2.0.0 |
@geoleaf-plugins/addpoi | core@^2.0.0 |
Important
As of Platform V2 (March 2026), the technical SemVer baseline is 2.0.x (@geoleaf/core@2.0.0). For future major/minor bumps, update package.json and all relevant documentation consistently.
No further releases are planned on the 1.x branch.