Deep Links

The app registers the meshtastic:/// URL scheme. Use Router.route(url:) to handle incoming URLs. Deep links work from Safari, Shortcuts, Siri Intents, and other apps.

Adding a New Deep Link

Add a case to the appropriate *NavigationState enum in Meshtastic/Router/NavigationState.swift.
Update Router's routing helpers in Meshtastic/Router/Router.swift.
Document the URL in the table below.

Messages

URL	Description
`meshtastic:///messages`	Messages tab
`meshtastic:///messages?channelId={channelId}&messageId={messageId}`	Channel messages (`messageId` is optional)
`meshtastic:///messages?userNum={userNum}&messageId={messageId}`	Direct messages (`messageId` is optional)

Connect

URL	Description
`meshtastic:///connect`	Connect tab

Nodes

URL	Description
`meshtastic:///nodes`	Nodes tab
`meshtastic:///nodes?nodenum={nodenum}`	Selected node

Map

URL	Description
`meshtastic:///map`	Map tab
`meshtastic:///map?nodenum={nodenum}`	Node on map
`meshtastic:///map?waypointId={waypointId}`	Waypoint on map

Settings

Settings URLs take no query parameters. The only path variant is localMeshDiscovery/history, which opens Local Mesh Discovery directly to its history view.

URL	Description
`meshtastic:///settings/about`	About Meshtastic
`meshtastic:///settings/appSettings`	App Settings
`meshtastic:///settings/helpDocs`	Help & Documentation
`meshtastic:///settings/localMeshDiscovery`	Local Mesh Discovery
`meshtastic:///settings/localMeshDiscovery/history`	Local Mesh Discovery (history view)
`meshtastic:///settings/routes`	Routes
`meshtastic:///settings/routeRecorder`	Route Recorder
Radio Config
`meshtastic:///settings/lora`	LoRa Config
`meshtastic:///settings/channels`	Channels
`meshtastic:///settings/security`	Security Config
`meshtastic:///settings/shareQRCode`	Share QR Code
Device Config
`meshtastic:///settings/user`	User Config
`meshtastic:///settings/bluetooth`	Bluetooth Config
`meshtastic:///settings/device`	Device Config
`meshtastic:///settings/display`	Display Config
`meshtastic:///settings/network`	Network Config
`meshtastic:///settings/position`	Position Config
`meshtastic:///settings/power`	Power Config
Module Config
`meshtastic:///settings/ambientLighting`	Ambient Lighting
`meshtastic:///settings/audio`	Audio (Codec2, requires LORA_24 region)
`meshtastic:///settings/cannedMessages`	Canned Messages
`meshtastic:///settings/detectionSensor`	Detection Sensor
`meshtastic:///settings/externalNotification`	External Notification
`meshtastic:///settings/mqtt`	MQTT
`meshtastic:///settings/neighborInfo`	Neighbor Info
`meshtastic:///settings/paxCounter`	Pax Counter
`meshtastic:///settings/rangeTest`	Range Test
`meshtastic:///settings/ringtone`	Ringtone
`meshtastic:///settings/serial`	Serial
`meshtastic:///settings/statusMessage`	Status Message
`meshtastic:///settings/storeAndForward`	Store & Forward
`meshtastic:///settings/telemetry`	Telemetry
`meshtastic:///settings/trafficManagement`	Traffic Management
TAK
`meshtastic:///settings/tak`	TAK Server
`meshtastic:///settings/takConfig`	TAK Module Config
Logging
`meshtastic:///settings/debugLogs`	Debug Logs
Developers
`meshtastic:///settings/backupManagement`	Backup Management
`meshtastic:///settings/coreDataBrowser`	Data Browser (DEBUG only)
`meshtastic:///settings/deviceLinks`	Device Links
`meshtastic:///settings/appFiles`	App Files
`meshtastic:///settings/tools`	Tools (iOS 18+)
`meshtastic:///settings/firmwareUpdates`	Firmware Updates