GeoLibre Desktop Architecture¶

Overview¶

GeoLibre Desktop is an npm workspaces monorepo. The UI is a React app hosted by Tauri v2. Map rendering uses MapLibre GL JS in the browser webview. Application state lives in a Zustand store (@geolibre/core).

flowchart LR
  UI[React UI] --> Store[Zustand Store]
  Store --> MapPkg[MapController]
  MapPkg --> ML[MapLibre GL JS]
  UI --> Tauri[Tauri Plugins]
  Tauri --> FS[File System]
  Proc[Processing] --> Store
  Proc -.-> Sidecar[FastAPI optional]

Packages¶

Package	Responsibility
`@geolibre/core`	Domain types, project JSON schema, global store
`@geolibre/map`	MapLibre lifecycle, layer sync, GeoJSON styling
`@geolibre/ui`	Shared UI primitives (shadcn-style)
`@geolibre/processing`	Client-side algorithm registry
`@geolibre/plugins`	Plugin interface and built-in plugins
`geolibre-desktop`	Shell layout, Tauri I/O, composition

State flow¶

User adds GeoJSON through the Tauri dialog or browser file picker.
Parsed GeoJSON is passed to addGeoJsonLayer in the store.
MapCanvas subscribes to layers, then MapController.syncLayers updates MapLibre sources and layers.
Style panel updates layer.style, then sync updates paint properties.
Desktop save uses projectFromStore and writes .geolibre.json to disk.

DuckDB-WASM¶

Reserved for v0.4 (@duckdb/duckdb-wasm dependency in app). Planned flow:

INSTALL spatial;
LOAD spatial;

Query results will register as duckdb-query layer placeholders, then full layer support in v0.4.

Python sidecar (v0.5)¶

The FastAPI app in backend/geolibre_server is planned to run as a Tauri external binary:

Bundle geolibre-server in src-tauri/bin/.
Spawn on first processing request needing GDAL/GeoPandas.
Communicate via HTTP on 127.0.0.1:8765.

Not required for the MVP UI.

Security¶

Tauri CSP allowlists tile and style hosts (OpenFreeMap, CARTO).
File access uses dialog-selected paths only.