= MapTool
:toc:
:toclevels: 2
:source-highlighter: rouge

A mapping application written in Ruby with Sinatra.

The project's shape is still open — this is the initial scaffold.

== Status

Early scaffold. The web application serves a vector map (MapLibre GL
JS), with an online style and an optional offline style backed by a local
PMTiles file, an animated RainViewer radar overlay, GPX
upload/display (points and tracks, organized in folders), and a live
position marker from a local GNSS receiver via gpsd.

== Requirements

* Ruby (see `.ruby-version`) and Bundler

== Getting started

[source,shell]
----
bundle install
bundle exec puma -C config/puma.rb
----

Then open http://127.0.0.1:4567 in a browser.

== Documentation

* link:docs/architecture.adoc[Architecture]
* link:docs/development.adoc[Development guide]
* link:docs/third-party-notices.adoc[Third-party notices]
* link:docs/nps-resources.adoc[National Park Service mapping resources]