User Guide

🇮🇱 עברית

User Guide

A reference for every interactive element. For a quick tour see Features; to get started fast see Quick Start.

The toolbar

The toolbar (top-left) is a vertical column with five collapsible sections. Behaviour:

• Drag handle (⋯) — drag the toolbar anywhere on the screen. Position is persisted.
• Hamburger toggle (☰) — collapse / expand the whole toolbar. State is persisted across reloads and language switches; default is collapsed on phones.
• Section headers — click a section header to expand or collapse just that section.

Add modes

Two togglable modes; clicking the active button again leaves the mode (so does pressing Esc).

Button	Behaviour
✏️ Add Waypoint	Click the map to drop a numbered waypoint; legs auto-connect to the previous one.
📝 Add Note	Click the map to drop a free-text annotation box.

With no mode active, click or drag any existing element to select / move it. Double-click an existing route leg to insert a blank waypoint at that exact map position.

Routes

Button	Action
⇄ Reverse Route	Reverse direction; swap each leg's altitude pair; rotate name text 180°.
🗑 Clear map	Remove all waypoints and notes (with confirm).
⌖ Fit to screen	Zoom and pan so the entire route fits the visible area.
⬇ Export	Download a JSON file with the full route + notes. Filename includes a timestamp.
⬆ Import	Upload a JSON file. Validates coordinates; rejects garbage rather than blanking the map.
📋 Flight plan	Open the per-leg flight-plan modal. See Flight Plan.
✈️ Open route in Google Earth	Save a .kml tour with per-leg altitudes. See Google Earth.

Waypoint behaviour

• A new waypoint snaps to a nearby published navigation waypoint or airfield when one is within snap radius - both on drop and on drag. Airfields take priority over navigation waypoints.
• A snapped waypoint adopts the published name automatically: localized navigation-waypoint name, or ICAO code for airfields. You can rename it in the inspector.
• The waypoint circle shows the name when "Show Waypoint names" is on, otherwise the sequence number.
• Double-click a leg to split it: NavAid inserts a new WP # waypoint at the clicked coordinate, selects it immediately, and turns the original leg into two legs. The new point is not snapped to published nav-waypoint / airfield data, so you can drag or rename it afterwards.
• Splitting a leg copies the old leg's speed, altitude pair, return / one-way altitude flags, and per-leg VOR reference to both new legs. Leg-marker positions reset to their defaults so the labels fit the new geometry.
• Editing a leg's altitude in the inspector propagates along the same cruise level until a different altitude already exists, so you don't have to click ten legs to change your cruise.
• Deleting a waypoint removes the leg next to it so the remaining altitude / speed pairs stay aligned with the route.

Notes

• Drop with 📝 Add Note, click to select, drag to move.
• Inspector controls: text, colour, shape (rectangle or oval).
• Note background follows the global label transparency slider unless a custom colour is chosen.
• Notes have a 56 px minimum width so empty ovals don't shrink to a vertical ellipse.

Map layers

Switch base layers with the Layer dropdown. Choices:

• CVFR (default)
• Navigation
• Low Alt
• Helicopters
• Satellite (Esri)
• OpenStreetMap

The chosen layer is persisted; previous keys (Nav, Heli, OSM) are migrated automatically. See Map Layers.

Navigation waypoints and airfields

• Toggle Show Navigation Waypoints - overlay all 256 published Israeli VFR reporting points.
• Toggle Show Airfields - overlay 16 published Israeli airfields as blue triangles.
• Toggle Show VOR stations - overlay Israeli VOR/DME stations. The nearby VOR ref selector drives radial/DME readouts even when the station markers are hidden.
• Toggle Show/Add Freq Changes - overlay red ATC-change rings and create/restore editable lightning callouts for route waypoints that match known comm-change points. This toggle defaults on.
• The Legend in the View section explains the airfield triangle, waypoint circle, and red ATC-change ring. It is not included in PNG export.
• A placed waypoint at approximately the same coordinates hides the matching navigation waypoint or airfield marker by proximity, so renaming the placed waypoint still keeps the marker hidden.
• The search box matches navigation-waypoint Hebrew / English names and airfield ICAO / English / Hebrew labels. The dropdown shows primary / alt; click an entry to centre on it.

Frequency changes

• A frequency callout is added only when the route waypoint is snapped to, or remains within about 18 px of, a known comm-change point.
• The lightning callout can be dragged around the waypoint: the point stays near the waypoint and the far tail controls rotation and distance.
• Selecting the callout opens Waypoint, Call sign, and Frequency fields. The call-sign dropdown fills its default primary frequency; the frequency stays editable.
• Deleting a waypoint deletes its linked frequency callout. Deleting the frequency callout leaves the waypoint in place.

See Frequency Changes.

VOR and radial/DME

• Select VOR ref in the View section, or click a VOR station marker and choose Use as reference VOR.
• The selected VOR drives the separate bottom readout, inspector radial/DME rows and Flight Plan Radial/DME columns.
• The Flight Plan calculates Radial/DME to each leg's start point and allows a per-leg VOR override in the Radial cell.

See VOR and Radial/DME.

Per-leg display toggles

Toggle	What it does
Show return path	Adds an outbound-direction tick / arrow on each leg.
Show leg dist	Yellow badge with the leg distance at the midpoint.
Highlight alt/speed diff	Purple halo on legs whose altitude or speed differs from the adjacent leg.

Display sliders

Control	Range	Persists?	Notes
Label Transparency	0-100	Yes	Background opacity for label backgrounds (waypoint name, leg distance, notes).
Map opacity	10-100	Yes	Base-map brightness on screen and in PNG export.
Waypoint size	0.6 – 2.0	Yes	Waypoint circle and name size.
Leg arrow size	0.3 – 2.0	Yes	Leg info marker (heading / altitude / time) size.

Developer preview only: add ?tune=1 to the URL to open the hidden tuning panel. It exposes drawing constants, including frequency-callout size, bends, rotation, and text settings. These preview values are not persisted.

Airfield charts

When you select a waypoint whose name matches an airfield ICAO code (e.g. LLBG), and that airfield has published charts in the BYOP dataset, the inspector shows a Charts section.

The charts are grouped by category:

Category	Meaning
Approach	Instrument approach plates (ILS, LOC, VOR, NDB)
SID	Standard Instrument Departures
STAR	Standard Terminal Arrivals
Ground	Ground movement / parking diagrams
VFR / Airport	VFR aerodrome chart, circuit pattern, text info
Other	ATC / SMAC documents

Click a chip (e.g. ILS 30) to open the PDF in the charts viewer modal:

• Close or Esc — dismiss the viewer.
• Download — save the PDF to your device.
• Open in new tab — view in a separate browser tab.

The viewer fetches the PDF from GitHub's LFS CDN via fetch() (CORS is enabled), wraps it in a blob: URL to bypass x-frame-options: deny, and renders in the browser's built-in PDF viewer.

Magnetic variation

Field is a number with the value-added-to-true sign convention. For Israel use −5 (i.e. magnetic = true − 5).

A small hint to the right of the input shows the equivalent in the conventional (5°E) form. Range is clamped to ±30°.

Page frames and PNG export

• A3 / A4 buttons toggle a dashed page-frame rectangle at 1:250 000.
• A modal asks for Landscape or Portrait orientation the first time.
• Drag the frame to position your route inside it.
• ⬇ Save PNG renders the framed map + route as a high-resolution PNG, at the chosen layer's max native tile zoom. It includes enabled Navigation Waypoints / Airfields overlays and locks map interaction while exporting. See Print and Export.

Status footer

Below the toolbar sections you'll see live totals - Waypoints, Legs, Distance (NM), Total time (HH:MM) - the app version, and GitHub / Wiki links.

Hidden features / tips

• Long-press a waypoint on touch devices selects it without adding a new one (when in Add mode, briefly leave the mode by pressing Esc).
• Esc clears the current selection / inspector.
• Map rotation dial — drag for any bearing; tap to cycle 0° / 90° / 180° / 270°.
• The toolbar hamburger remembers separate state per language? No — collapse state is shared across languages.
• The flight plan modal uses change (not input) for editable cells, so you can type freely; commit on blur or Tab.