Meshtastic-Android/app
James Rich 26aa8377c5 refactor: streamline main screen navigation and ViewModel injection
- Update `MainScreen` (Android) and `DesktopMainScreen` to manage their own `NavBackStack` initialization internally.
- Refactor `MainScreen` to obtain `UIViewModel` via Koin injection instead of receiving it as a parameter from `MainActivity`.
- Remove default bottom padding from `MeshtasticAppShell` and associated screen-level modifiers to allow for more flexible layout orchestration.
- Simplify `DesktopMainScreen` by moving backstack management inside the composable and cleaning up the navigation provider logic.
- Remove redundant lint suppressions in `Main.kt` following the simplification of the main screen composable structure.
- Clean up imports and normalize the usage of `MeshtasticNavDisplay` and `MeshtasticNavigationSuite` across platforms.
2026-03-27 09:31:31 -05:00
..
src refactor: streamline main screen navigation and ViewModel injection 2026-03-27 09:31:31 -05:00
build.gradle.kts feat: implement MeshtasticNavDisplay and centralize Navigation 3 configuration 2026-03-27 09:31:31 -05:00
detekt-baseline.xml feat: Implement iOS support and unify Compose Multiplatform infrastructure (#4876) 2026-03-21 23:19:13 +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 feat: Migrate networking to Ktor and enhance multiplatform support (#4890) 2026-03-23 16:48:10 +00:00
README.md refactor: BLE transport and UI for Kotlin Multiplatform unification (#4911) 2026-03-25 02:15:51 +00:00

: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. While it is declared in the :app manifest for system visibility, its implementation resides in the :core:service module. 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
  :app -.-> :feature:widget

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-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;
classDef kmp-library-compose fill:#FFC1CC,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;