chore: upgrade dependencies, clean warnings, and add POEditor translation guidelines

Author: nichu42

.github/FUNDING.yml

@@ -1,3 +1,4 @@
+#file: noinspection YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation,YAMLSchemaValidation
 # These are supported funding model platforms
 
 github: nichu42

CONTRIBUTING.md

@@ -146,10 +146,18 @@ If you want to add a real linter (ktlint is the most popular choice) as a separa
 
 ## Translations / Localization
 
-BoxViewer currently ships English (default) and German (`values-de/`) translations. New languages are welcome and much appreciated.
+BoxViewer uses **POEditor** to collaboratively manage app translations. We welcome contributions for correcting existing strings or translating the app into new languages. 
 
-To add or improve a translation:
+### ✍️ How to Contribute Translations
+1. **Join the Translation Project**: Visit our public join portal on POEditor:
+   👉 **[Translate BoxViewer on POEditor](https://poeditor.com/join/project/3BO0G8m3BZ)**.
+2. **Submit Translations**: You can suggest corrections or translate untranslated strings directly on the web interface.
+3. **Adding a New Language**: You can suggest/request a new target language within the POEditor project portal. Once translations are complete, a developer will update the app's locale configuration and sync workflows to enable it.
+4. **Moderation**: All submitted translations go through a moderation queue to ensure accuracy and prevent spam before they are merged.
 
+*Alternatively, if you prefer editing XML resources directly, you can submit a Pull Request following the guidelines below:*
+
+### 🛠️ Manual Translation Guidelines (via XML)
 1. **Adding a new language:** copy `app/src/main/res/values/strings.xml` to `app/src/main/res/values-<lang>/strings.xml` (e.g., `values-fr/`, `values-es/`, `values-nl/`) and translate every string. The `<lang>` code follows Android's standard ISO 639-1 conventions. Do **not** add a new language by editing the existing `values-de/` directory.
 2. **Improving an existing translation:** edit the file directly in the appropriate `values-<lang>/` directory.
 3. **Do not translate keys, only values.** String keys (`R.string.dashboard_title`, etc.) are referenced from Kotlin code and must stay identical.

README.md

@@ -33,7 +33,7 @@ Crafted with **Kotlin** and **Jetpack Compose** following Material Design 3 guid
 *   **📈 Rich Telemetry Analysis**: Deep telemetry streams visualization including units, last updated timestamps, coordinates, station type, and exposure type (indoor vs. outdoor).
 *   **🔍 Smart Discovery Engine**: Locate public senseBoxes from the openSenseMap community using direct search by name/ID, location address auto-complete, or on-demand GPS discovery.
 *   **🌡️ Local Unit Conversion**: Per-sensor unit switching for temperature (°C/°F/K), pressure (hPa/mbar/Pa/inHg/mmHg), and wind (m/s/km/h/mph/kn) performed entirely on-device.
-*   **🌐 Multi-Language Support**: BoxViewer currently ships in English and German and is prepared for additional languages.
+*   **🌐 Multi-Language Support**: BoxViewer currently ships in English and German and is prepared for additional languages (see below)
 *   **🔗 Quick Sharing & Deep Linking**: Generate local QR codes to share senseBox stations. Recipients scan the code or open a sharing web link to view the station directly inside the BoxViewer app.
 *   **🔋 Battery & API-Friendly**: Seamless local SQLite caching (`SensorCacheEntity`) and awake-on-unlock widget refresh logic ensure you get fresh data without draining your battery or hammering openSenseMap servers.
 *   **🔒 Privacy-First & De-Googled Friendly**: 100% free of Google Play Services (GMS) dependencies in the app code. Core functionality relies on the native Android `LocationManager` and direct openSenseMap APIs. Address search and location labels may use the device’s native geocoder (ROM-dependent backend) or an OpenStreetMap-based fallback; see the Privacy Policy for details. Zero telemetry, analytics, or third-party trackers.
@@ -129,6 +129,16 @@ BoxViewer features a built-in Air Quality Index engine that supports six major i
 
 ---
 
+## 🌐 Translation & Localization
+
+Help make BoxViewer accessible to everyone! We collaboratively translate the app using **POEditor**. You can help translate the app, submit corrections, or suggest new languages on our POEditor project page:
+
+👉 **[Help Translate BoxViewer on POEditor](https://poeditor.com/join/project/3BO0G8m3BZ)**
+
+For more details on translating and how the sync workflow works, check our [CONTRIBUTING.md](./CONTRIBUTING.md#translations--localization).
+
+---
+
 ## 📜 Copyright & License Info
 
 **Copyright (C) 2026 nichu42 and contributors**

app/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
@@ -13,6 +14,7 @@
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:localeConfig="@xml/locale_config"
+        tools:ignore="UnusedAttribute"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
         android:theme="@style/Theme.MyApplication">

app/src/main/java/de/nichu42/boxviewer/MainActivity.kt

@@ -49,7 +49,6 @@ import de.nichu42.boxviewer.util.ApiLogger
 import de.nichu42.boxviewer.util.FontScaleHelper
 import de.nichu42.boxviewer.util.LocaleHelper
 import androidx.compose.ui.res.stringResource
-import de.nichu42.boxviewer.R
 import kotlinx.coroutines.flow.MutableStateFlow
 
 class MainActivity : AppCompatActivity() {

app/src/main/java/de/nichu42/boxviewer/ui/AboutScreen.kt

@@ -352,6 +352,63 @@ fun AboutScreen(
                 }
             }
 
+            // Translation Collaboration Card
+            Card(
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .testTag("about_translation_card"),
+                shape = RoundedCornerShape(12.dp),
+                colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surface)
+            ) {
+                Column(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .padding(16.dp)
+                ) {
+                    Text(
+                        text = stringResource(R.string.about_section_translation),
+                        style = MaterialTheme.typography.labelSmall,
+                        fontWeight = FontWeight.Bold,
+                        color = MaterialTheme.colorScheme.primary
+                    )
+                    Spacer(modifier = Modifier.height(10.dp))
+                    Text(
+                        text = stringResource(R.string.about_translation_description),
+                        style = MaterialTheme.typography.bodyMedium,
+                        color = MaterialTheme.colorScheme.onSurface,
+                        lineHeight = 20.sp
+                    )
+                    Spacer(modifier = Modifier.height(14.dp))
+                    Button(
+                        onClick = {
+                            try {
+                                uriHandler.openUri("https://poeditor.com/join/project/3BO0G8m3BZ")
+                            } catch (e: Exception) {
+                                e.printStackTrace()
+                            }
+                        },
+                        colors = ButtonDefaults.buttonColors(
+                            containerColor = MaterialTheme.colorScheme.primaryContainer,
+                            contentColor = MaterialTheme.colorScheme.onPrimaryContainer
+                        ),
+                        shape = RoundedCornerShape(8.dp),
+                        modifier = Modifier.fillMaxWidth().heightIn(min = 48.dp).testTag("link_poeditor")
+                    ) {
+                        Icon(
+                            imageVector = Icons.Default.Language,
+                            contentDescription = stringResource(R.string.cd_contribute_translations),
+                            modifier = Modifier.size(18.dp)
+                        )
+                        Spacer(modifier = Modifier.width(8.dp))
+                        Text(
+                            text = stringResource(R.string.about_link_translate),
+                            fontSize = 13.sp,
+                            fontWeight = FontWeight.SemiBold
+                        )
+                    }
+                }
+            }
+
             // 3. Data & Attribution Card (openSenseMap platform info)
             Card(
                 modifier = Modifier
@@ -699,7 +756,8 @@ fun LicenseScreen(
     onBack: () -> Unit
 ) {
     val context = LocalContext.current
-    var licenseText by remember { mutableStateOf(context.getString(R.string.about_loading_license)) }
+    val loadingLicenseText = stringResource(R.string.about_loading_license)
+    var licenseText by remember { mutableStateOf(loadingLicenseText) }
     LaunchedEffect(context, LocalConfiguration.current) {
         licenseText = loadLicenseText(context)
     }
@@ -775,7 +833,7 @@ private fun loadLicenseText(context: android.content.Context): String {
         reader.close()
         normalizeLicenseText(text)
     } catch (_: Exception) {
-        context.getString(R.string.about_license_load_error)
+        context.resources.getString(R.string.about_license_load_error)
     }
 }
 

app/src/main/java/de/nichu42/boxviewer/ui/AddBoxConfirmScreen.kt

@@ -17,6 +17,7 @@ import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.platform.LocalLocale
 import de.nichu42.boxviewer.R
 import de.nichu42.boxviewer.data.api.SenseBox
 
@@ -271,8 +272,9 @@ private fun BoxPreviewCard(
                 Spacer(modifier = Modifier.height(4.dp))
             } else {
                 box.currentLocation?.let { loc ->
-                    val latStr = String.format(java.util.Locale.getDefault(), "%.4f", loc.latitude)
-                    val lngStr = String.format(java.util.Locale.getDefault(), "%.4f", loc.longitude)
+                    val locale = LocalLocale.current.platformLocale
+                    val latStr = String.format(locale, "%.4f", loc.latitude)
+                    val lngStr = String.format(locale, "%.4f", loc.longitude)
                     Text(
                         text = "Coords: $latStr, $lngStr",
                         style = MaterialTheme.typography.bodySmall,

app/src/main/java/de/nichu42/boxviewer/ui/ApiLogViewerScreen.kt

@@ -53,6 +53,11 @@ fun ApiLogViewerScreen(
     val clipboard = LocalClipboard.current
     val scope = rememberCoroutineScope()
 
+    val logsClearedMsg = stringResource(R.string.api_log_logs_cleared)
+    val urlCopiedMsg = stringResource(R.string.api_log_url_copied)
+    val responseCopiedMsg = stringResource(R.string.api_log_response_copied)
+    val entryCopiedMsg = stringResource(R.string.api_log_entry_copied)
+
     var diagnostics by remember { mutableStateOf<Map<String, Any>?>(null) }
     var logEntries by remember { mutableStateOf<List<ApiLogger.ApiLogEntry>>(emptyList()) }
     var isLoading by remember { mutableStateOf(true) }
@@ -137,7 +142,7 @@ fun ApiLogViewerScreen(
                             ApiLogger.clearLogs()
                             logEntries = emptyList()
                             diagnostics = null
-                            Toast.makeText(ctx, ctx.getString(R.string.api_log_logs_cleared), Toast.LENGTH_SHORT).show()
+                            Toast.makeText(ctx, logsClearedMsg, Toast.LENGTH_SHORT).show()
                         },
                         modifier = Modifier.testTag("api_log_viewer_clear")
                     ) {
@@ -249,19 +254,19 @@ fun ApiLogViewerScreen(
                         onCopyUrl = {
                             scope.launch {
                                 clipboard.setClipEntry(ClipData.newPlainText("API Request URL", it).toClipEntry())
-                                Toast.makeText(ctx, ctx.getString(R.string.api_log_url_copied), Toast.LENGTH_SHORT).show()
+                                Toast.makeText(ctx, urlCopiedMsg, Toast.LENGTH_SHORT).show()
                             }
                         },
                         onCopyResponse = {
                             scope.launch {
                                 clipboard.setClipEntry(ClipData.newPlainText("API Response", it).toClipEntry())
-                                Toast.makeText(ctx, ctx.getString(R.string.api_log_response_copied), Toast.LENGTH_SHORT).show()
+                                Toast.makeText(ctx, responseCopiedMsg, Toast.LENGTH_SHORT).show()
                             }
                         },
                         onCopyAll = {
                             scope.launch {
                                 clipboard.setClipEntry(ClipData.newPlainText("API Log Item", it).toClipEntry())
-                                Toast.makeText(ctx, ctx.getString(R.string.api_log_entry_copied), Toast.LENGTH_SHORT).show()
+                                Toast.makeText(ctx, entryCopiedMsg, Toast.LENGTH_SHORT).show()
                             }
                         }
                     )
@@ -277,7 +282,6 @@ fun DiagnosticsCollapsiblePanel(
     isExpanded: Boolean,
     onToggle: () -> Unit
 ) {
-    val ctx = LocalContext.current
     Card(
         modifier = Modifier.fillMaxWidth(),
         shape = RoundedCornerShape(12.dp),
@@ -324,10 +328,11 @@ fun DiagnosticsCollapsiblePanel(
                         .fillMaxWidth(),
                     verticalArrangement = Arrangement.spacedBy(4.dp)
                 ) {
-                    val appVer = diagnostics["appVersion"] as? String ?: ctx.getString(R.string.time_unknown)
-                    val device = diagnostics["device"] as? String ?: ctx.getString(R.string.time_unknown)
-                    val sdk = diagnostics["androidSdk"]?.toString() ?: ctx.getString(R.string.time_unknown)
-                    val date = diagnostics["date"] as? String ?: ctx.getString(R.string.time_unknown)
+                    val timeUnknown = stringResource(R.string.time_unknown)
+                    val appVer = diagnostics["appVersion"] as? String ?: timeUnknown
+                    val device = diagnostics["device"] as? String ?: timeUnknown
+                    val sdk = diagnostics["androidSdk"]?.toString() ?: timeUnknown
+                    val date = diagnostics["date"] as? String ?: timeUnknown
 
                     DiagnosticsRow(label = stringResource(R.string.api_log_label_app_version), value = appVer)
                     DiagnosticsRow(label = stringResource(R.string.api_log_label_device_info), value = device)
@@ -751,7 +756,6 @@ fun ApiLogEntryRow(
     entry: ApiLogger.ApiLogEntry,
     onClick: () -> Unit
 ) {
-    val ctx = LocalContext.current
     val methodColor = when (entry.method.uppercase()) {
         "GET" -> Color(0xFF4CAF50)
         "POST" -> Color(0xFF2196F3)