项目文件夹
Qiusheng Wu
4906f9a028
* fix: support Add Vector Layer on Cesium Bridge the vector control presentation records into store geometry so Cesium can render imports without unsupported MapLibre source calls. Restore vector layers on both engines and recreate detached controls after renderer switches. * Address review feedback - Bound the Cesium materialization of tiled Add Vector Layer records by the documented DuckDB routing limits (100 MB / 100k features) and never read a streamed GeoParquet whole; an oversize layer stays in the panel as 2D-only with a console warning (Claude + CodeRabbit). - Give a materialized tiled record `type: "geojson"` in the store sync so the globe renders the collection through its GeoJSON path instead of the `vector-tiles` kind Cesium excludes (Claude). - Stop `isDrapedLayer` from promising a maplibre-gl-vector tiled record: the drape reuses the 2D sync, which never creates the control's DuckDB source, so the layer panel now flags an unrendered one as 2D-only (Claude). - Stub `hasImage`/`addImage` on the adapter for KML icon sprites; document that the overrides cover every map call maplibre-gl-vector 0.11 makes, which never include `setData` or `setFilter` (Claude). - Document why a source revision that yields no collection stays pending: retrying cannot change the answer until a new source is added (CodeRabbit). - Cover the size guard, the GeoJSON type flip, and the drape exclusion with fake-control tests. * Address review feedback - Preserve unsaved browser-picked vector layers across a control teardown: ensureVectorControl now reads their features out of the departing control into `layer.geojson` (bounded like the Cesium export) before recreating it, so a renderer switch no longer drops a layer with no URL, path, or embedded data (Claude). - Require `externalNativeLayer` alongside the maplibre-gl-vector source kind in the drape exclusion, matching `isVectorControlStoreLayer` (CodeRabbit). - Drop the cached collection when a layer's source revision changes so a reload that comes back oversize or streamed does not keep drawing stale features on the globe (CodeRabbit). - Cover the preserve helper, the flag requirement, and the small-to-oversize transition with tests.
GeoLibre
A free and open-source, lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs everywhere you do, in the web browser, on the desktop, on mobile, and inside Jupyter notebooks, all while keeping your data local and private.
It also ships 1,000+ geoprocessing tools that run entirely in your browser on WebAssembly — terrain, hydrology, LiDAR, remote sensing, and vector analysis with no server, no install, and no data ever leaving your machine.
GeoLibre is built with Tauri v2, React, TypeScript, MapLibre GL JS, DuckDB-WASM Spatial, and deck.gl. The same workspace runs as a native desktop app, native Android and iOS apps, in any modern web browser, and adapts responsively to mobile and small screens.
- Launch GeoLibre Web — the full app in your browser, nothing to install
- Download the desktop app — Windows, macOS, and Linux installers
- Get it on the Mac App Store — the sandboxed macOS build
- Get it on the App Store — the native iOS app for iPhone and iPad
- Get it on Google Play — the native Android app
- Get the Chrome extension — open datasets you find on any webpage in GeoLibre
- Use the Python package — embed and control the full app in Jupyter notebooks
- Use the R package — build interactive maps in RStudio, Quarto, R Markdown, and Shiny
- 1,000+ geoprocessing tools — the full toolbox, in the browser
- Get started — install, run from source, and configure
- Features — the complete feature list
Demos
Click any screenshot to open it at full resolution, or any animation to play the full-quality video.
3D Tiles
NYC buildings and subways
Manhattan building footprints extruded in 3D and colored by construction era, with the MTA subway lines and stations on top and a legend generated automatically from the layers' symbology.
The animation below runs the Time Slider along the buildings' construction year, from 1850 to 2025, so Manhattan fills in era by era. Click it to play the full-quality video.
Planetary basemaps
GeoLibre is not limited to Earth. Planetary basemaps from OpenPlanetaryMap and USGS Astrogeology cover the Moon, Mars, Mercury, Venus, the Galilean moons (Io, Europa, Ganymede, Callisto), Titan, Pluto, and Charon, with a per-project ellipsoid so distance, area, and scale measurements match the body you are mapping. The deep-space starfield behind each globe comes from the Atmosphere Effects plugin.
 |
 |
 |
| Earth | Moon | Mars |
 |
 |
 |
| Mercury | Pluto | Venus |
 |
 |
 |
| Europa | Callisto | Charon |
Switch bodies from the planet switcher in the Layers panel. See Demos for more.
Video tutorials
- GeoLibre 1.0: A Free, Open-Source Cloud-Native GIS That Runs Anywhere (Browser, Desktop & Jupyter)
- Geoprocessing in the Browser: 700+ Free GIS Tools in GeoLibre, Zero Install
- Access Free High-Resolution Disaster Satellite Imagery in Your Browser
- Regularize Building Footprints in the Browser with GeoLibre
- GeoLibre + GeoLens: A Modern GIS Stack for Self-Hosting Geospatial Data
- Create Reusable GIS Workflows with GeoLibre Model Builder and AI Assistant
- Mapping the 2026 Nepal Floods with Free High-Resolution Satellite Imagery
- Building Cloud-Native GIS Workflows with GeoLibre
- Image Georeferencing Using GeoLibre in the Browser
All of them, with chapters and summaries, are on the Video Tutorials page.
Geoprocessing: 1,000+ tools, zero install
Processing → Whitebox Toolbox opens a toolbox of 1,000+ geoprocessing tools that execute in the browser through a WebAssembly runtime with native raster and vector I/O. There is no Python sidecar to install and no server to call — the tools, your data, and the results all stay on your machine, so the full toolbox is available on GeoLibre Web, on the desktop app, and on Android alike.
The tools come from the Whitebox Next Gen suite plus GeoLibre's own WASM tools, and are browsable by category straight from the Processing menu:
| Category | Tools | Examples |
|---|---|---|
| Vector | 313 | overlays, buffers, joins, cleaning, topology, generalization |
| Raster | 256 | algebra, filters, reclassification, zonal and focal statistics |
| Remote sensing | 154 | spectral indices, band math, classification, change detection |
| Hydrology | 100 | flow accumulation, watersheds, stream networks, depression filling |
| Terrain | 99 | slope, aspect, hillshade, curvature, ruggedness, viewsheds |
| LiDAR | 65 | point-cloud filtering, ground classification, DEM/DSM generation |
| Conversion | 49 | format translation to cloud-native GeoParquet, PMTiles, and COG |
| Network | 26 | connectivity, cost distance, and routing analysis |
| Projection | 4 | reprojection for raster and vector data |
Any tool is deep-linkable with a ?tool= URL parameter that preselects it and
pre-fills its form. See the Processing Tools guide
for details, and Geoprocessing in the Browser for
a video walkthrough.
Documentation
Full documentation, including the User Guide and Tutorials, is published at geolibre.app.
- Getting Started - use GeoLibre on the web, desktop, Android, iOS, or in Jupyter; run it from source; run it with Docker; and configure optional credentials.
- Features - the complete, feature-by-feature list of what GeoLibre can do today.
- Demos - a visual tour: 3D Tiles, 3D city data, planetary basemaps, the SQL Workspace, and embeds.
- Downloads - installers and package managers for Windows, macOS, and Linux.
- User Guide - a feature-by-feature reference for the interface, adding data, layers, styling, the attribute table, map controls, processing, the SQL Workspace, data integrations, plugins, settings, and embedding.
- Tutorials - hands-on, end-to-end workflows: your first map, cloud-native data, vector analysis, terrain analysis, spatial SQL, and sharing and embedding.
- Reference
- Architecture
- Android
- iOS
- Project format
- Plugin API
- UI Profiles
- Internationalization
- Python package (Jupyter) — also supports
from geolibre import DashMapfor Dash (installgeolibre[dash]) - R package (RStudio, Quarto, and Shiny)
- Notebook Panel
- Roadmap
- Contributing
- How to Cite
- Become a Sponsor
Contributions are welcome. See the Contributing guide for the development setup, repository layout, and quality gate.
Sponsor
GeoLibre is free and open source, and stays that way. If it is useful to you or your team, sponsorship is the most direct way to keep development, hosting, and cross-platform distribution going.
- GitHub Sponsors - monthly or one-time, billed through your GitHub account.
- Buy Me a Coffee - a quick one-off contribution, no account required.
See the Become a Sponsor page for what sponsorship supports and for other, free ways to help.
Acknowledgements
GeoLibre is built on the free and open-source geospatial and web communities — including MapLibre GL JS, deck.gl, DuckDB-WASM Spatial, Turf.js, Tauri, React, and many more. See the full Acknowledgements page for the complete list of projects and community contributors.
- The Atmosphere Effects plugin (deep-space backdrop, parallax starfield, comets, and the globe atmosphere halo) adapts the technique and visual design from Leonel Dias's article Globe atmosphere, halo, and comets — the layered Canvas 2D approach, the halo gradient and "screen" blend, the limb-sampling that keeps the halo aligned under pitch, and the starfield/comet parameters.
- Community contributors — thanks to Ryanphoenix for many valued contributions, including issue reports, feedback, and improvements.
- Beta testers — thanks to René van der Velde (Netherlands) for early testing, detailed bug reports, and feature requests.
Citation
If you use GeoLibre in your work, please cite it. GeoLibre is archived on Zenodo, which mints a DOI for every release. The concept DOI below always resolves to the latest version.
Wu, Q. (2026). GeoLibre: A lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. Zenodo. https://doi.org/10.5281/zenodo.20785400
You can also use GitHub's "Cite this repository" button (which reads CITATION.cff) to copy a ready-made APA or BibTeX entry. See the How to Cite page for more formats.