iOS Wi-Fi Heatmap & Site Survey — Full Feature

[jbcrane13]

Epic: iOS Wi-Fi Heatmap & Site Survey

Bring the full Wi-Fi heatmap survey feature to iOS, matching the macOS Phase 1 Blueprint Walk Survey capability. Unlocked via Apple Shortcuts "Get Network Details" action (iOS 17+) — provides real RSSI (dBm), noise floor, channel, and link speed for the connected network.

Spec

• docs/iOS-WiFi-Heatmap-Spec.md — iOS signal acquisition technical spec
• docs/WiFi-Heatmap-PRD.md — Full PRD (v1.1, Phases 2 & 3 reinstated)

Signal Acquisition Approach

Primary: Shortcuts "Get Network Details" via ShortcutsWiFiProvider (URL scheme + App Group shared container)
Fallback: NEHotspotNetwork.fetchCurrent() (SSID/BSSID only, no RSSI)
Reference: nOversight app uses identical approach, live on App Store

Scope

• Shortcuts-based Wi-Fi signal measurement on iOS (RSSI, noise, channel, TX/RX rate)
• Full walk survey UI (floor plan import, calibration, tap-to-measure, heatmap overlay)
• Integration with existing RoomPlan scanner as floor plan source
• Reuse of shared NetMonitorCore infrastructure (HeatmapRenderer, WiFiMeasurementEngine, models)
• Project save/load (.netmonsurvey format)
• Active scan mode (speed test + ping at each point)
• Export (image, .netmonsurvey file)

Sub-Issues

• Explore iOS Shortcuts Wi-Fi signal measurement approaches #125 — Explore Shortcuts Wi-Fi measurement approaches (P0 blocker) ✅ COMPLETED
• iOS Heatmap Phase A: Foundation — IOSHeatmapService & Shortcuts integration #126 — Phase A: Foundation (IOSHeatmapService, ShortcutsWiFiProvider implementation)
• iOS Heatmap Phase B: Core Survey UI — views, viewmodel, canvas #127 — Phase B: Core Survey UI (views, viewmodel, canvas, calibration)
• iOS Heatmap Phase C: Integration & Polish — RoomPlan, persistence, styling #128 — Phase C: Integration & Polish (RoomPlan, save/load, live HUD, styling)
• iOS Heatmap Phase D: Testing & Validation #129 — Phase D: Testing & Validation (unit tests, UI tests, device validation)

Reference

• Original PRD: docs/WiFi-Heatmap-PRD.md
• macOS implementation: fully operational (reference for parity)
• Disabled iOS tests: Tests/NetMonitor-iOSTests/HeatmapSurveyViewModelTests.swift

[traycerai]

Warning

Ticket Assist will be discontinued on May 1, 2026. After that date, the feature will no longer be available. We suggest installing the Traycer IDE Extension for continued AI-powered, spec-driven development. Thank you for choosing Traycer!

Warning

Insufficient credits. Please purchase more credits or upgrade your plan to continue using Traycer.

[jbcrane13]

Research Complete: iOS Wi-Fi Signal via Shortcuts (#125)

Key Finding

iOS can read real Wi-Fi RSSI (dBm), noise floor, channel, TX/RX rates via the Shortcuts "Get Network Details" action (iOS 17+). This is the same approach used by nOversight (Numerous Networks), which is live on the App Store.

Recommended Approach: URL Scheme + App Group

1. App invokes companion Shortcut via shortcuts://x-callback-url/run-shortcut
2. Shortcut runs "Get Network Details" → writes JSON to App Group shared container
3. Shortcut returns to app via netmonitor://wifi-result URL scheme
4. App reads Wi-Fi data from shared container

iOS Capability (with Shortcuts)

Field	Available
RSSI (dBm)	Yes
Noise Floor (dBm)	Yes
SNR (calculated)	Yes
Channel	Yes
Band (inferred)	Yes
TX/RX Rate	Yes
SSID/BSSID	Yes
Visible AP scan	No (macOS-only)

Impact on Epic

• Phases 2 & 3 REINSTATED — AR modes are now viable with Shortcuts-based signal
• iOS gets 7 of 8 heatmap visualization types (only Channel Overlap remains macOS-exclusive)
• Measurement latency: ~1.5-2.5s per reading (URL scheme round-trip)
• One-time user setup: install companion Shortcut (guided flow in app)

Documents Updated

• Created: docs/iOS-WiFi-Heatmap-Spec.md — full technical specification
• Updated: docs/WiFi-Heatmap-PRD.md — v1.1, corrected iOS capabilities, reinstated Phases 2 & 3
• Updated: CLAUDE.md — added heatmap docs + platform differences

Architecture

ShortcutsWiFiProvider → IOSHeatmapService → HeatmapSurveyViewModel
(with NEHotspotNetwork fallback for users without the Shortcut installed)