How meshtastic/meshtastic-android works
Meshtastic is a mobile mesh-radio client, with a Compose Desktop counterpart. The principal workflow is a user initiating an operation in the app, which is handled by service and transport layers and communicated to a nearby mesh radio; incoming radio data is processed by the app. Discovery is a distinct workflow that scans radio presets, collects node information, and persists session results. README capabilities such as maps, firmware updates, NFC sharing, Wi-Fi provisioning, and system-AI integration are included where the tree supports a source location. Several feature paths are unsampled, so only documented or indexed relationships are drawn.
Main entry points: RadioInterfaceService.kt Radio transport · DiscoveryScanEngine.kt Discovery scan · SharedRadioInterfaceService.kt Service orchestration · Main.kt App UI
Components 20
App experience
- App UI
androidApp/src/main/kotlin/org/meshtastic/app/ui/Main.kt - Maps and waypoints
androidApp/src/google/kotlin/org/meshtastic/app/map/MapView.kt - Map layers
androidApp/src/main/kotlin/org/meshtastic/app/map/MapLayer.kt - KML import
androidApp/src/main/kotlin/org/meshtastic/app/map/KmlImport.kt
Mesh connectivity
- Service orchestration
core/service/src/commonMain/kotlin/org/meshtastic/core/service/SharedRadioInterfaceService.kt - Mesh queries
core/service/src/commonMain/kotlin/org/meshtastic/core/service/QueryControllerImpl.kt - Radio transport
core/repository/src/commonMain/kotlin/org/meshtastic/core/repository/RadioInterfaceService.kt - Bluetooth transport
core/ble/src/commonMain/kotlin/org/meshtastic/core/ble/BluetoothRepository.kt
Mesh discovery
- Discovery scan
feature/discovery/src/commonMain/kotlin/org/meshtastic/feature/discovery/DiscoveryScanEngine.kt - Discovery ranking
feature/discovery/src/commonMain/kotlin/org/meshtastic/feature/discovery/scan/DiscoveryRankingEngine.kt - Discovery records
core/database/src/commonMain/kotlin/org/meshtastic/core/database/entity/DiscoverySessionEntity.kt
Specialized features
- Firmware updates
feature/firmware/src/commonMain/kotlin/org/meshtastic/feature/firmware/DefaultFirmwareUpdateManager.kt - Meshtastic API
core/network/src/commonMain/kotlin/org/meshtastic/core/network/service/ApiService.kt - NFC sharing
core/nfc/src/main/kotlin/org/meshtastic/core/nfc/MeshtasticHostApduService.kt - Wi-Fi provisioning
feature/wifi-provision/src/commonMain/kotlin/org/meshtastic/feature/wifiprovision/domain/NymeaWifiService.kt - App Functions
androidApp/src/google/kotlin/org/meshtastic/app/ai/appfunctions/MeshtasticAppFunctions.kt - Assistant service
androidApp/src/google/kotlin/org/meshtastic/app/ai/appfunctions/BaseMeshtasticAppFunctionService.kt - AI function provider
core/data/src/commonMain/kotlin/org/meshtastic/core/data/ai/AiFunctionProvider.kt
Other components
- User
- Mesh radio
Connections 21
- User → App UI: uses
README.md - App UI → Service orchestration: starts services
- Service orchestration → Radio transport: orchestrates
- Radio transport → Mesh radio: exchanges radio data
core/repository/src/commonMain/kotlin/org/meshtastic/core/repository/RadioInterfaceService.kt - Radio transport → Bluetooth transport: uses Bluetooth
- Bluetooth transport → Mesh radio: connects
README.md - Service orchestration → Mesh queries: exposes queries
- Mesh queries → Radio transport: sends requests
- User → Discovery scan: starts scan
README.md - Discovery scan → Discovery records: persists sessions
feature/discovery/src/commonMain/kotlin/org/meshtastic/feature/discovery/DiscoveryScanEngine.kt - Discovery scan → Discovery ranking: uses ranking
- Discovery scan → Radio transport: scans presets
- User → Maps and waypoints: views map
README.md - Maps and waypoints → Map layers: displays layers
- User → KML import: imports KML
- User → Firmware updates: updates firmware
- Firmware updates → Meshtastic API: fetches releases
- User → NFC sharing: shares by NFC
README.md - User → Wi-Fi provisioning: provisions Wi-Fi
- Assistant service → App Functions: routes functions
androidApp/src/google/kotlin/org/meshtastic/app/ai/appfunctions/BaseMeshtasticAppFunctionService.kt - App Functions → AI function provider: uses provider
androidApp/src/google/kotlin/org/meshtastic/app/ai/appfunctions/BaseMeshtasticAppFunctionService.kt