# 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](https://git.add-ideas.de/lotobo/toolbox-portal). 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](docs/ARCHITECTURE.md) and [docs/PRIVACY-SECURITY.md](docs/PRIVACY-SECURITY.md).

## Development

Requires Node.js 22 and npm 11.

```sh
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](THIRD_PARTY_NOTICES.md).