Map & Waypoints

The Map tab shows all nodes that have shared a position, overlaid on an Apple Maps base layer.

Node Pins

Each node that has reported a GPS position appears as a coloured circle pin on the map. The green solid line shows a directly connected node; orange dashed lines show nodes reached via the mesh. A purple star marks a waypoint. Tap a pin to see the node name, last heard time, signal info, and a shortcut to send a direct message.

Pins update automatically when a new position packet is received from the mesh.

Filtering Nodes on the Map

Tap the filter button (funnel icon, line.3.horizontal.decrease.circle) in the bottom-right toolbar to open the Map Filters sheet. When any filter is active, the icon appears filled to indicate filtering is in effect.

Filter	Description
Via LoRa	Show only nodes heard directly over LoRa radio
Via MQTT	Show only nodes bridged through MQTT
Online	Show only nodes heard within the last 2 hours
Encrypted	Show only nodes using PKI encryption
Favorites	Show only nodes you have starred as favourites
Distance	Limit to nodes within a chosen radius of your current location
Hops Away	Slider from All to 7 — restricts by hop count (0 = direct only)
Roles	Filter by one or more device roles (e.g. Router, Client, Repeater)

Tip — Checking LoRa range Enable the Via LoRa filter and disable Via MQTT to see only nodes reachable directly over radio, which is useful for assessing whether a direct LoRa link is feasible.

Map Layers

Tap the layer icon (top-right) to switch between:

Layer	Description
Standard	Default Apple Maps street/satellite hybrid
Satellite	Aerial imagery
GeoJSON Overlays	Custom map layers loaded from `.geojson` files in the app's file storage

Waypoints

Waypoints are named points of interest you can share across the mesh.

Creating a Waypoint

Long press anywhere on the map.
Enter a name, optional description, and lock icon (to limit editing to the creator).
Tap Save — the waypoint broadcasts to all nodes on the primary channel.

Editing a Waypoint

Tap an existing waypoint pin, then tap Edit. Changes broadcast to the mesh immediately.

Deleting a Waypoint

Tap the waypoint, then tap Delete. The deletion broadcasts to all nodes.

Node Trail

When a node has reported multiple positions over time, a trail line connects the historical positions on the map, showing the node's path.

Your Location

Your current GPS position appears as a blue dot (standard iOS location indicator). Enable position broadcasting in Settings → Position to share your location with the mesh.