Meshtastic-Android/docs/decisions
James Rich 37729c13d8 feat: upgrade to Navigation 3 Beta 01 and implement entry-scoped ViewModels
- Update Navigation 3 to `1.1.0-beta01`, JetBrains Lifecycle to `2.11.0-alpha02`, and Compose Multiplatform to `1.11.0-beta01`.
- Integrate `ViewModelStoreNavEntryDecorator` and `SaveableStateHolderNavEntryDecorator` into `NavDisplay` for both Android and Desktop shells.
- Enable automatic ViewModel scoping where ViewModels obtained via `koinViewModel()` inside `entry<T>` blocks are now tied to the backstack entry's lifetime and cleared on pop.
- Add `jetbrains.lifecycle.viewmodel.navigation3` dependency to support entry-level `ViewModelStore` management.
- Update `AGENTS.md`, `GEMINI.md`, and `copilot-instructions.md` to reflect the transition from Activity/Window-scoped ViewModels to entry-scoped lifecycles.
- Introduce `navigation3-api-alignment-2026-03.md` to document the audit of Navigation 3 Scene architecture and Material 3 Adaptive integration.
- Update `kmp-status.md` and existing decision docs to reflect the new dependency baseline and predictive back handling via `NavigationBackHandler`.
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: upgrade to Navigation 3 Beta 01 and implement entry-scoped ViewModels 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.