# MapMap Nav — nav-app feature gaps (research + build plan)

What a user expects from Google/Apple Maps-grade navigation, audited against
the current app. **Building the ⭐ items this pass** (the ones that make it
feel like a real nav app); the rest are logged for the roadmap.

## Map interaction
- ⭐ **Tap anywhere → drop pin → place card → route there.** Today a map
  tap only fires if a *named* vector feature is under it; empty-map taps do
  nothing. Expected: tap/long-press any point → pin + reverse-geocoded (or
  coordinate) label → "Directions".
- ⭐ **Selected-place pin shown on the Explore map** (only preview/guidance
  drew a pin before).
- ⭐ **Layers control** — a visible button opening toggles for **3D
  buildings**, **POIs**, and **map theme** (light/dark). The layers exist in
  the style but there was no way to turn them on, and the top-down camera
  never revealed 3D.
- ⭐ **Zoom +/- buttons** and **tilt for 3D** (camera pitch when 3D is on).
- Compass-to-north (already via MapLibre control).
- 〽 Long-press vs tap distinction, map rotation gestures (partial).

## Search & places
- ⭐ **Category quick-search chips** (Petrol, Food, Parking, Coffee) on the
  search sheet.
- **Saved places / Home & Work favourites**, recent-search reuse (recents
  exist; no favourites yet).
- **"Search this area" after panning**.

## Routing
- Alternatives + car/bike/walk profiles ✅ (built).
- ⭐ **Add a stop / waypoint** to the active route.
- **Route options**: avoid tolls / motorways / ferries, depart-at time.
- **Steps list** ✅ (built, in guidance).
- **Truck/ADR profile** — MapMap's differentiator (roadmap).

## Guidance
- Banner + "Then" chip, chase camera, reroute, arrival, voice ✅.
- ⭐ **Speed + speed-limit pill** (speed from guidance; limit from tiles/SDK
  where available).
- **Lane guidance** (data in MapMap's OSRM shim; roadmap).
- **ETA share** (roadmap).

## Shell
- Settings, territories, about, online/offline ✅.
- ⭐ **Map theme (light/dark)** wired to the hosted MapMap Light/Dark styles.
- **Report incident**, **night auto-theme** (roadmap).

## Shipped — pass 1
1. ✅ Tap → pin → route there (+ pin on Explore).
2. ✅ Layers sheet: 3D buildings, POIs, map theme, online/offline.
3. ✅ Zoom controls + 3D camera tilt.
4. ✅ Category quick-search chips.
5. ✅ Speed pill in guidance (limit roundel ready).

## Shipped — pass 2
6. ✅ **Truck / ADR routing** — Lorry profile + options sheet (vehicle
   presets, hazmat, ADR tunnel category B–E); dimensions + dangerous goods
   shape the route via `costing:truck`. MapMap's differentiator, verified
   end-to-end on the gateway.
7. ✅ **Route options** — avoid tolls / motorways / ferries.
8. ✅ **Saved places** — Home / Work / favourites (store + search).
9. 〽 Waypoint routing plumbed (contract + gateway); **add-a-stop UI
   deferred** (needs a stop-picker sub-flow) → next pass.

## Shipped — pass 3
10. ✅ **Lane guidance** — active-lane bar beneath the banner.
11. ✅ **Reachable-area isochrones** — clock FAB paints 10/20-min contours
    from `POST /isochrone`. Gateway-verified.

## Next pass (roadmap)
- Add-a-stop UI (waypoint picker on the route).
- Search-along-route ("coffee on the way", `/route/along`).
- Route rationale for truck ("avoided 3.5 m limit"), depart-at time.
- ETA share, report incident, night auto-theme.
