Meshtastic-Android/docs/decisions
James Rich 829aecd888 feat: implement MeshtasticNavDisplay and centralize Navigation 3 configuration
- Introduce `MeshtasticNavDisplay` in `core:ui` to encapsulate shared Navigation 3 configuration, including entry decorators, scene strategies, and transitions.
- Integrate `rememberViewModelStoreNavEntryDecorator` to provide entry-scoped `ViewModelStoreOwner` support, ensuring ViewModels are automatically cleared when their backstack entry is popped.
- Configure `DialogSceneStrategy` to enable navigation-driven dialogs that respect backstack lifecycle and predictive back gestures.
- Implement a standardized 350 ms crossfade transition for both forward and pop navigation across all platforms.
- Refactor `app` and `desktop` host modules to utilize `MeshtasticNavDisplay`, removing redundant manual configuration of `NavDisplay` and decorators.
- Update `core:ui` dependencies to include `lifecycle-viewmodel-navigation3` and move it away from platform-specific host modules.
- Update architectural documentation (`AGENTS.md`, `GEMINI.md`, and decision logs) to reflect the adoption of centralized navigation and ViewModel scoping patterns.
2026-03-27 09:31:31 -05:00
..
architecture-review-2026-03.md Refactor command handling, enhance tests, and improve discovery logic (#4878) 2026-03-22 05:42:27 +00:00
ble-strategy.md refactor: null safety, update date/time libraries, and migrate tests (#4900) 2026-03-23 23:17:50 +00:00
koin-migration.md refactor: null safety, update date/time libraries, and migrate tests (#4900) 2026-03-23 23:17:50 +00:00
navigation3-api-alignment-2026-03.md feat: implement MeshtasticNavDisplay and centralize Navigation 3 configuration 2026-03-27 09:31:31 -05:00
navigation3-parity-2026-03.md feat: upgrade to Navigation 3 Beta 01 and implement entry-scoped ViewModels 2026-03-27 09:31:31 -05:00
README.md docs: summarize KMP migration progress and architectural decisions (#4770) 2026-03-13 02:23:25 +00:00
testing-consolidation-2026-03.md feat: Integrate Mokkery and Turbine into KMP testing framework (#4845) 2026-03-18 18:33:37 -05:00
testing-in-kmp-migration-context.md feat: Integrate Mokkery and Turbine into KMP testing framework (#4845) 2026-03-18 18:33:37 -05:00

Decision Records

Architectural decision records and reviews. Each captures context, decision, and consequences.

Decision File Status
Architecture review (March 2026) architecture-review-2026-03.md Active
Navigation 3 parity strategy (Android + Desktop) navigation3-parity-2026-03.md Active
BLE KMP strategy (Nordic Hybrid) ble-strategy.md Decided
Hilt → Koin migration koin-migration.md Complete

For the current KMP migration status, see docs/kmp-status.md. For the forward-looking roadmap, see docs/roadmap.md.