Meshtastic-Android/feature/settings
James Rich 5aabf58576 refactor: consolidate metric formatting through MetricFormatter
Replace 11 inline formatString("%.Nf ...") metric display calls with
MetricFormatter helpers in core/common. Adds two new helpers (windSpeed,
rainfall) for m/s and mm readings.

Migrated (11 sites):
- feature/node EnvironmentMetrics.kt: humidity, pressure, voltage,
  current, wind_speed, wind_gust, wind_lull, rainfall_1h, rainfall_24h
- feature/settings LoadingOverlay.kt, PacketResponseStateDialog.kt:
  progress percent indicators

New helpers in MetricFormatter:
- windSpeed(metersPerSecond, decimalPlaces = 1) -> "X.X m/s"
- rainfall(millimeters, decimalPlaces = 1) -> "X.X mm"

Intentionally left alone:
- core/model DistanceExtensions.kt: specialized unit-conversion helpers,
  which are themselves the canonical distance/speed formatters
- feature/node PositionLogComponents.kt, MetricsViewModel.kt: GPS
  coordinates and heading-angle formatters (not metric display strings)
- feature/node TracerouteChart, HostMetricsChart, EnvironmentCharts,
  PaxMetrics valueFormatter lambdas: chart-library axis callbacks with
  format strings scoped to the chart lib contract
- feature/node TracerouteLog.kt, HostMetricsLog.kt: generic
  "label: value" log rows, not metric displays
- feature/node CompassBottomSheet.kt: one-off %.0f° angle
- EnvironmentMetrics.kt lux, UV-lux, gas resistance, radiation, and
  wind-with-direction formats: one-off specialized units not worth a
  dedicated helper

Also adds detekt @Suppress("TooManyFunctions") on MetricFormatter
(11 helpers now exceeds the default threshold) and unit tests for the
new windSpeed/rainfall helpers.

Validation: ./gradlew spotlessApply, :core:common:jvmTest,
:core:common:detekt, spotlessCheck, and kmpSmokeCompile all pass.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-04-17 11:04:13 -05:00
..
src refactor: consolidate metric formatting through MetricFormatter 2026-04-17 11:04:13 -05:00
build.gradle.kts chore: review-cleanup fleet (audit + fix + hardening) (#5158) 2026-04-17 00:02:59 +00:00
detekt-baseline.xml feat: Implement iOS support and unify Compose Multiplatform infrastructure (#4876) 2026-03-21 23:19:13 +00:00
README.md refactor: BLE transport and UI for Kotlin Multiplatform unification (#4911) 2026-03-25 02:15:51 +00:00

:feature:settings

Overview

The :feature:settings module manages all application and radio-side configurations. This includes user preferences, channel configuration, and advanced radio settings.

Key Components

1. SettingsScreen

The main entry point for application-wide settings.

2. RadioConfigViewModel

Handles the complex logic of reading and writing configuration to the Meshtastic device over the radio link (BLE, USB, or TCP).

3. AboutScreen

Displays version information, licenses, and project links.

Features

  • Channel Configuration: Manage encryption keys, channel names, and radio frequency settings.
  • Node Database Management: Options to clear or prune the local and remote node databases.
  • App Preferences: Theme selection, unit system (metric/imperial), and notification settings.

Module dependency graph

graph TB
  :feature:settings[settings]:::kmp-feature

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;