VecGeo Viewer

A simple web-based vector geospatial dataset viewer powered by DuckDB-WASM.

VecGeo Viewer is a lightweight single-page web application (or SPA) that does not need any backend services. Everything is more or less done in the web browser including loading the datasets and rendering the maps. Handling the data is done using DuckDB-WASM, and the visualization is done using Leaflet JavaScript library.

Compared to similar tools, like Kepler.gl, VecGeo Viewer is much simpler and lighter. It is mainly intended as a tool to visualize and inspect geospatial data fast and easily without the need for any special setup.

Note

Report bugs and feature requests on the issues page.

Important

This application needs a working internet connection to work properly.

Features

• Load GeoJSON, Shapefile, and Parquet/GeoParquet files
• Interactive map visualization
• Color mapping by numeric or categorical columns
• Object filtering and transformations using DuckDB SQL
• Export filtered data as GeoJSON
• Light and dark theme support
• Keyboard shortcuts for navigation

---

Getting Started

Visit the live app: VecGeo Viewer

Run with Docker

You can also run the application using the pre-built Docker image:

docker run -d -p 8080:80 --rm ghcr.io/cogitatortech/vecgeo-viewer:latest

Then open http://localhost:8080 in your browser.

Run Locally (for development)

1. Clone the repository:

   git clone https://github.com/CogitatorTech/vecgeo-viewer.git
   cd vecgeo-viewer

2. Start the local HTTP server:

   bash scripts/start_server.sh

3. Open http://localhost:8085/index.html in your browser.

---

Contributing

See CONTRIBUTING.md for details on how to make a contribution.

License

This project is licensed under the MIT License (LICENSE)