meshtastic/Meshtastic-Android
1
0
Fork 0
mirror of https://github.com/meshtastic/Meshtastic-Android.git synced 2026-04-20 22:23:37 +00:00
Code Issues Projects Releases Packages Wiki Activity
Meshtastic-Android/app
History
Exact
James Rich 8c6892a4da
chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4791)
2026-03-14 06:44:36 -05:00
..
dependencies feat(wire): migrate from protobuf -> wire (#4401) 2026-02-04 00:01:12 +00:00
src chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4791) 2026-03-14 06:44:36 -05:00
build.gradle.kts fix: fix animation stalls and update dependencies for stability (#4784) 2026-03-13 23:01:17 +00:00
detekt-baseline.xml feat: introduce Desktop target and expand Kotlin Multiplatform (KMP) architecture (#4761) 2026-03-12 21:14:49 +00:00
google-services.json Enable parallel installation of debug and release builds (#3596) 2025-11-02 23:26:50 +00:00
proguard-rules.pro chore(ble): Add Proguard rules for Nordic BLE library (#4618) 2026-02-21 18:28:50 -06:00
README.md chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4773) 2026-03-12 22:15:20 -05:00

README.md

:app

Overview

The :app module is the entry point for the Meshtastic Android application. It orchestrates the various feature modules, manages global state, and provides the main UI shell.

Key Components

1. MainActivity & Main.kt

The single Activity of the application. It hosts the NavHost and manages the root UI structure (Navigation Bar, Rail, etc.).

2. MeshService

The core background service that manages long-running communication with the mesh radio. It runs as a Foreground Service to ensure reliable communication even when the app is in the background.

3. Koin Application

MeshUtilApplication is the Koin entry point, providing the global dependency injection container.

Architecture

The module primarily serves as a "glue" layer, connecting:

  • core:* modules for shared logic.
  • feature:* modules for specific user-facing screens.

Module dependency graph

graph TB
  :app[app]:::android-application
  :app -.-> :core:ble
  :app -.-> :core:common
  :app -.-> :core:data
  :app -.-> :core:database
  :app -.-> :core:datastore
  :app -.-> :core:di
  :app -.-> :core:domain
  :app -.-> :core:model
  :app -.-> :core:navigation
  :app -.-> :core:network
  :app -.-> :core:nfc
  :app -.-> :core:prefs
  :app -.-> :core:proto
  :app -.-> :core:service
  :app -.-> :core:resources
  :app -.-> :core:ui
  :app -.-> :core:barcode
  :app -.-> :feature:intro
  :app -.-> :feature:messaging
  :app -.-> :feature:connections
  :app -.-> :feature:map
  :app -.-> :feature:node
  :app -.-> :feature:settings
  :app -.-> :feature:firmware

classDef android-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef android-application-compose fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef compose-desktop-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef android-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;
classDef android-library fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
classDef android-library-compose fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
classDef android-test fill:#A0C4FF,stroke:#000,stroke-width:2px,color:#000;
classDef jvm-library fill:#BDB2FF,stroke:#000,stroke-width:2px,color:#000;
classDef kmp-library fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;
classDef unknown fill:#FFADAD,stroke:#000,stroke-width:2px,color:#000;