geo-tools/public/README.md

Geo Tools

Inspect, edit, measure and convert geospatial files locally in the browser.

Geo Tools is a standalone local-first application in the add·ideas Toolbox. Inputs are processed in the browser and are not uploaded.

Version 0.1 scope

• Bounded GeoJSON, GPX, KML and coordinate-CSV parsing into a common model with Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon and nested GeometryCollection support
• WGS 84 bounds, point counts, great-circle LineString distance and elevation gain/loss
• Explicit lossy conversion among the four supported formats
• Iterative Douglas–Peucker LineString simplification and decimal-degree/DMS conversion
• A coordinate-only local sketch with no map tiles or projection service
• Full-model GeoJSON geometry replacement, append/delete, nested coordinate editing and line-direction reversal with validation after every edit
• GPX-derived track inventory plus a local two-point distance, initial-bearing and midpoint ruler

Geometry collections are limited to 20,000 geometry nodes, 16 nesting levels and 200,000 coordinates. GPX/CSV conversions flatten geometry grouping and report that loss. Scalar properties are preserved; there is no CRS transformation, basemap request or claim of survey-grade geodesy. See docs/ARCHITECTURE.md and docs/PRIVACY-SECURITY.md.

Development

Requires Node.js 22 and npm 11.

npm ci
npm run check
npm run test:browser

Release

npm run release:artifact creates a deterministic release/geo-tools-0.2.0.zip and checksum sidecar.

Licence

GPL-3.0-or-later. Runtime dependencies retain their own licences; see THIRD_PARTY_NOTICES.md.