GeoLibre Roadmap¶

v0.1: Map viewer and GeoJSON¶

[x] Tauri + React + MapLibre shell
[x] GeoJSON load, layer panel, style panel
[x] Attribute table (basic)
[x] Processing UI with local algorithms
[x] Plugin interface + sample plugins

v0.2: Project persistence¶

[x] .geolibre.json save/open
[x] In-session recent project tracking
[x] Feature highlight from attribute table
[x] Optional zoom to selected feature
[x] Recent projects UI and persistence

v0.3: Cloud-native formats¶

[x] GeoParquet import through DuckDB-WASM
[x] FlatGeobuf import through DuckDB-WASM and URL-based Components plugin panel
[x] PMTiles through Components plugin
[x] COG and GeoTIFF raster rendering
[x] Zoom to layer for GeoJSON and source-bounds-aware layer types

v0.4: DuckDB Spatial¶

[x] DuckDB-WASM integration
[x] INSTALL spatial / LOAD spatial
[x] Shapefile, KMZ/KML, GeoPackage, GeoParquet, FlatGeobuf, GML, and related vector import paths

v0.5: Advanced Add Data and plugin-backed layers¶

[x] Add Data dialogs for XYZ, WMS, vector files, GeoJSON URLs, vector tiles, raster tile templates, COG and GeoTIFF rasters, MBTiles, and ArcGIS layers
[x] MapLibre Components plugin with FlatGeobuf, PMTiles, Zarr, LiDAR, and Gaussian splat panels
[x] Desktop MBTiles metadata and tile reads through Tauri commands
[x] Plugin control position controls in the Plugins menu
[x] Layer control integration for GeoLibre-managed layers

v0.6: Project access, web embeds, and expanded integrations¶

[x] Persistent recent projects with desktop file recents and URL-backed web recents
[x] Separate Open Project from File and Open Project from URL flows
[x] Browser demo query options for compact layout, icon-only toolbar, and hidden panels
[x] PostgreSQL layer workflow through desktop Martin server integration
[x] STAC search workflow for adding catalog-backed raster layers
[x] Esri Wayback, GeoAgent, GeoEditor, Street View, and Swipe plugin integrations

v0.7: Add Data expansion, identify, settings, and processing¶

[x] GPX loading from URL or local file, with selectable waypoint, track, and route layers
[x] Delimited text loading from URL or local file using longitude and latitude fields
[x] WFS GetFeature loading through the Add Data dialog
[x] WMS GetFeatureInfo identify support with hardened popup handling
[x] Whitebox toolbox backed by a managed Python sidecar
[x] Inline attribute editing, horizontal table scrolling, and scrollable identify popups
[x] Settings dialog for map preferences and runtime environment variables
[x] Plugin state persistence in project files
[x] Default GeoJSON sample URL and larger identify popup
[x] Local raster file loading fix
[x] Large-file pre-commit guard

v0.8: Viewer, desktop packaging, plugins, and dynamic layers¶

[x] Cloudflare Worker viewer served from viewer.geolibre.app
[x] Browser demo links updated to the production viewer
[x] GPX drag-and-drop split into named waypoint, track, and route layers
[x] Vector layers reprojected to EPSG:4326 on load
[x] Desktop About dialog update check
[x] Dynamic external plugin zip loading from the app data plugins directory
[x] Safe fallback for crypto.randomUUID in non-secure contexts
[x] External plugin manifest support with plugin.json
[x] 3D Tiles layer support through maplibre-gl-3d-tiles
[x] 3D Tiles restoration when reopening projects
[x] GeoParquet panel DuckDB startup fix
[x] MSIX desktop packaging and cleaner build output
[x] External native GeoJSON layers registered from local directories
[x] Raster basemaps registered as external native layers
[x] Text marker labels rendered on GeoJSON layers
[x] Manual and automatic refresh for WFS and GeoJSON URL layers
[x] Multiple DuckDB SQL query-result layers
[x] Desktop diagnostics panel and improved diagnostics/status bar contrast
[x] Toolbar toggles for Colorbar, Legend, and HTML panels

[x] SQL Workspace for running DuckDB Spatial SQL against loaded layers, local files, and remote URLs, with sample queries, query history, and adding results to the map or exporting them
[x] Planetary Computer panel for browsing and loading STAC data
[x] Earth Engine panel for browsing and loading datasets
[x] Overture Maps plugin for loading Overture data themes
[x] Time Slider plugin for animating time series raster and vector data, powered by maplibre-gl-time-slider
[x] Web Services menu with four federal data plugins
[x] Add Raster Layer powered by the maplibre-gl-raster plugin
[x] Add Vector Layer powered by the maplibre-gl-vector plugin
[x] Identify, selection, and attribute table support for DuckDB layers
[x] Conversion menu under Processing for Vector to GeoParquet/FlatGeobuf/PMTiles, CSV to GeoParquet, and Raster to COG, backed by a hardened conversion sidecar with a path allowlist
[x] Vector menu under Processing with common geometry tools (buffer, centroids, convex hull, dissolve, bounding box, simplify, clip, intersection, difference, union) running client-side with Turf.js, plus an optional GeoPandas sidecar engine
[x] Raster menu under Processing with common raster tools (hillshade, slope, aspect, reproject, resample, clip by extent, clip by mask layer, polygonize, contour) backed by a rasterio sidecar, path in and path out
[x] Drag and drop vector and GeoTIFF/COG raster files onto the map to add them as layers
[x] Whitebox batch tools run against a selected input directory
[x] Controls menu with Measure, Bookmark, Minimap, and View State tools
[x] Print menu backed by PrintControl
[x] Project menu consolidating New, Open, Save, and Save As
[x] Layout settings with per-panel visibility toggles
[x] Insert before dropdown for placing layers in the stack
[x] Component panels persisted and controls reset on new project
[x] Plugins can declare and handle URL query parameters
[x] maponly query parameter for chrome-free map embeds
[x] theme query parameter to set the initial light/dark theme for embeds
[x] Docker support for the browser app
[x] VITE_DUCKDB_SPATIAL_EXTENSION_PATH for offline spatial extension loading

v1.0: Processing pipelines, external plugin system, and stable prototype¶

[x] GDAL / Rasterio / GeoPandas pipelines
[x] Buffer, reproject, and export GeoJSON processing tools
[x] Expanded WhiteboxTools coverage
[x] External plugin package distribution workflow
[x] Plugin marketplace / registry design (see Plugin marketplace and registry)
[x] Plugin marketplace MVP: curated registry plus browse and install UI
[x] Plugin update (in-place re-fetch) and uninstall with confirmation
[x] Project menu Share action that uploads to share.geolibre.app using a personal API token
[x] Python package (geolibre) for Jupyter notebooks: embeds the full app as an anywidget with a leafmap-style API (add_geojson, add_tile_layer, add_cog) and two-way .geolibre.json project sync
[x] Performance tuning and test suite
[x] Cross-platform installers
[x] Documentation and tutorials

v1.1: Vector styling, attribute table management, and atmosphere effects¶

[x] In-browser GeoPandas engine for the Vector tools via Pyodide (no server, same results as the optional sidecar)
[x] Host deck.gl exposed to external plugins via app.getDeckGL(), so plugins render on the shared instance instead of bundling their own copy
[x] Style panel support for Add Vector Layer (maplibre-gl-vector) layers, including single, categorized, graduated, and expression symbology applied to the control's native layers
[x] Rename layers from the layer panel by double-clicking the name or from the layer actions menu
[x] Open attribute table and Export actions added to the layer actions menu
[x] Manual and automatic (timed) refresh extended to Add Vector Layer URL layers
[x] Attribute table column management: rename, delete, hide/show, and reorder fields, persisted with the project
[x] Atmosphere Effects plugin: deep-space backdrop, parallax starfield, comets, and a globe atmosphere halo at low zoom (toggled from the Controls menu)
[x] conda-forge install instructions and a video tutorial in the documentation
[x] MIT license
[x] CSP allowance for cdn.jsdelivr.net so DuckDB-WASM loads its bundles in the browser build

v1.2: New data sources, attribute analytics, routing, and platform polish¶

[x] OpenStreetMap PBF file loading parsed in-browser with osmix
[x] Cloud-Optimized NetCDF/HDF layers loaded via kerchunk references
[x] Authenticated 3D Tiles tilesets via custom request headers
[x] Georeferenced video overlay layers
[x] Deck.gl Layer builder for composing deck.gl overlays from uploaded files and remote URLs
[x] In-browser PostGIS SQL engine via PGlite, alongside the DuckDB Spatial SQL Workspace
[x] Attribute table add-field and field-calculator tools
[x] Attribute table Charts panel (histogram, scatter, bar, line, box)
[x] Spatial join added to the Vector tools
[x] Select by value and Select by location tools
[x] H3 tools to create hexagonal grids and bin points into H3 cells
[x] Point heatmap renderer and clustering, including for Add Vector Layer point layers
[x] Directions plugin for interactive routing via maplibre-gl-directions, with a one-time privacy notice before enabling it
[x] Undo/redo for layer and style operations
[x] Command palette (Ctrl/Cmd + K) and global keyboard shortcuts with a ? cheat sheet
[x] Print layout composer with PNG and PDF export
[x] Installable, offline-capable Progressive Web App (PWA) build
[x] Internationalization framework (react-i18next) with extracted string catalogs and a ?locale/?lang embed language parameter
[x] Accessibility pass with axe checks across key screens
[x] App, section, and plugin React error boundaries
[x] Playwright end-to-end smoke tests and a CI job
[x] Expanded Python Map API covering more Add Data layer types
[x] CDN-loaded PGlite/PostGIS to shrink the Jupyter wheel and the desktop binary

v1.3: Analysis depth, real-time collaboration, story maps, scripting, and an AI assistant¶

[x] Spatial Statistics toolbox under Processing
[x] Vector tools: Smooth, Regular grid, and Voronoi/Delaunay
[x] IDW / kriging interpolation (point layer → continuous raster surface)
[x] Attribute (table) join vector tool, joining a table's fields by a matching key
[x] Raster analysis tools: zonal statistics, raster calculator, reclassify, mosaic, and focal statistics
[x] Client-side raster processing fallback that runs in the browser when the Python sidecar is unavailable
[x] Single-band pseudocolor with classification and RGB band combination for raster styling
[x] Batch run and model/pipeline chaining for processing tools
[x] Network analysis: isochrones, service areas, and origin–destination cost matrices
[x] Collapsible layer groups/folders in the layer panel
[x] glTF/GLB 3D model layers placed at coordinates
[x] Client-side vector tiling for large local vector layers
[x] Warning before loading very large vector files
[x] Transparent rewrite of public S3, GCS, and Azure cloud-storage URLs in SQL queries
[x] Shapefile and GeoPackage export
[x] Apache Sedona as an additional SQL Workspace engine
[x] Batch geocoding and reverse geocoding tools, with a multi-provider geocoding abstraction
[x] Real-time multi-user collaboration (MVP) backed by a Cloudflare Worker
[x] Scroll-driven story map builder, presenter, and standalone HTML export
[x] User-editable legend for the print layout
[x] Field statistics summary panel in the attribute table
[x] AI Segmentation toolbox via segment-geospatial (SamGeo) and Meta's SAM 3, proxied through the sidecar to a separate samgeo-api model server
[x] Natural-language GIS assistant (Strands agent) that turns plain-English requests into auditable, undoable GeoLibre operations
[x] Python automation API and an in-app Python Console
[x] Python package: local raster, marker/cluster, and choropleth APIs; split_map, add_legend, and add_colorbar helpers; typed read-back of selected/drawn features; and to_html export
[x] Homebrew Cask packaging for macOS
[x] Native Android app from the same codebase via Tauri v2 mobile, with a CI workflow that builds signed, per-ABI release APKs (~40 MB) — see Android
[x] isMobile() feature-gating that hides desktop-process tools (Whitebox, Raster, Conversion, AI Segmentation, PostgreSQL/Martin) on Android so nothing is shown that cannot run
[x] Responsive, touch-friendly mobile layout: Layers/Style panels overlay the map as slide-over sheets on phones, pointer-event (touch) panel resizing, and safe-area insets so the toolbar clears the system status bar
[x] Download Offline Area tool that pre-caches the current map view's basemap tiles into the service-worker cache
[x] Service-worker caching of the CDN-loaded Pyodide and PGlite/PostGIS engines so browser SQL and Python keep working offline after first use

v1.4: Jupyter beside the map, spectral indices, georeferencing, and field collection (current)¶

[x] Resizable, collapsible Notebook panel docked beside the map: the web build embeds a self-hosted JupyterLite site (in-browser Pyodide kernel) and the desktop build launches a uv-managed JupyterLab server, both seeded with a runnable Welcome tour. Notebook cells drive the live map through the shared scripting bridge via an auto-loaded geolibre client, and the JupyterLite theme follows the app theme — see Notebook Panel
[x] Spectral Index toolbox under Processing → Raster (NDVI, GNDVI, NDWI, NDMI, NDBI, NBR, EVI, and SAVI) with Sentinel-2, Landsat 8-9, NAIP, and custom band layouts and a reflectance-scale knob, evaluated client-side via geotiff.js or on the rasterio sidecar through the existing raster calculator
[x] Raster Georeferencer (Processing → Georeferencing): pin a non-georeferenced image to the map with ground control points, using a least-squares affine fit and per-GCP and RMS residuals, added as a corner-pinned overlay that persists in the project and works offline
[x] Field Collection tool (Controls menu) for capturing point, line, and polygon observations with a per-layer custom form (text/number/date/choice fields and an optional inline photo), placed by device GPS or by tapping the map, with a floating quick-open control; captures are written to a tagged GeoJSON layer that flows into the attribute table, export, and offline use
[x] Runtime overrides for VITE_PYODIDE_INDEX_URL and VITE_DUCKDB_SPATIAL_EXTENSION_PATH through the existing runtime-environment system, so air-gapped or corporate deployments can point Pyodide and the DuckDB Spatial extension at internal mirrors without rebuilding the app

Plugin marketplace and registry (design)¶

This captures the design for the v1.0 "Plugin marketplace / registry" item. It builds on the existing external-plugin foundation, the plugin.json manifest contract, HTTPS manifest-URL loading, the desktop app data plugins/ scan, and the bundled public/plugins/ drop-in mechanism, and it relates to the "External plugin package distribution workflow" item.

Goal¶

Let users discover, install, update, and remove trusted external plugins from a curated registry without hand-entering manifest URLs, on both the desktop and web builds, while keeping the existing trust model in which plugins are trusted code.

Registry¶

A curated, versioned index published as static JSON (for example registry.json hosted on geolibre.app, or generated from a GitHub repository of submissions). No live backend is required for the MVP.
Each entry carries id, name, version, description, author, homepage, manifestUrl, categories, minGeoLibreVersion, and optional screenshots.
The index is fetched over HTTPS and cached; entries point at the same plugin.json manifests the existing loader already understands.

Browse and install UI¶

A standalone Manage Plugins dialog (Settings menu > Manage Plugins), modeled on QGIS, has All / Installed / Not installed / Upgradeable / Settings sections. The four browse sections list registry entries with search and per-entry install, installed, and update states; the Settings section manages plugin sources.
Install reuses the current external-plugin loader: it resolves the entry's manifestUrl, validates it, and registers the plugin.
Desktop: download the bundle into the app data plugins/<id>/ directory so it persists and loads on startup through the existing scan.
Web: record the entry's manifestUrl in desktop settings (and, for shared projects, in the project plugins.manifestUrls) so it loads on next open.
Remove drops the recorded manifest URL and unregisters the plugin at runtime (tearing down any active control), so the change takes effect without a restart. (The MVP records manifest URLs rather than downloading bundles; the desktop bundle-download path above is a later enhancement.)

Updates and versioning¶

Compare the installed version against the registry entry, surface an update available state, and offer a one-click update that re-fetches the bundle.
Honor minGeoLibreVersion so incompatible plugins are flagged, not installed.

Trust and security¶

The registry is an allowlist; only curated entries are offered for install.
HTTPS-only manifests (the existing isAllowedPluginManifestUrl rule).
Explicit user consent on install, because plugin entries execute as trusted code (the desktop CSP permits blob: script execution by design).
The curated registry and explicit install consent are the primary controls.

Relationship to bundled plugins¶

Bundled public/plugins/<id>/ drop-ins remain the zero-config way to ship first-party or private plugins inside a build. The marketplace covers discoverable, user-installed third-party plugins; the two are complementary and share the same plugin.json contract and loader.

Phasing¶

Curated static registry plus browse and install through manifest URLs (reuses the current loader; records the manifest URL in settings). Done.
Version checks, update and removal flows.
Submission workflow for third-party authors.

Implementation (phase 1)¶

The MVP ships in the desktop app and, because the same frontend serves the web build, works in both:

apps/geolibre-desktop/src/lib/plugin-registry.ts fetches and normalizes a registry ({ "plugins": [...] }), resolving each entry's manifestUrl against the registry location. The registry URL is VITE_GEOLIBRE_PLUGIN_REGISTRY_URL or, by default, the hosted registry at https://plugins.geolibre.app/plugin-registry.json.
apps/geolibre-desktop/src/components/layout/ManagePluginsDialog.tsx is a standalone dialog (Settings menu > Manage Plugins) with All / Installed / Not installed / Upgradeable / Settings sections: search, install, a confirm step before uninstall, an Update action when a newer version is published, minGeoLibreVersion compatibility checks, and inline error handling. The Settings section manages additional local directories and manual manifest URLs. All actions apply immediately (live).
Installing records the entry's manifest URL in the plugin manifest URL list, so the existing external-plugin loader fetches and registers it. No new trust path is introduced. Uninstalling (after confirmation) unregisters the plugin at runtime — tearing down any active map control — so the Plugins menu updates without a reload. Update re-fetches the manifest URL and re-registers the published version in place, fetching the new version before tearing down the old one so a failed update leaves the installed plugin intact.
The registry and plugin bundles live in the opengeos/geolibre-plugins repo, published to GitHub Pages at plugins.geolibre.app; it ships a sample/ template and maintainers add curated entries there.