feat(language): add language selection to onboarding

cmp-android/dependencies/prodReleaseRuntimeClasspath.tree.txt

@@ -3240,6 +3240,40 @@
 |    |    +--- org.jetbrains.compose.material3:material3:1.9.0-beta03 (*)
 |    |    +--- org.jetbrains.compose.components:components-resources:1.9.3 (*)
 |    |    \--- org.jetbrains.compose.components:components-ui-tooling-preview:1.9.3 (*)
+|    +--- project :feature:onboarding-language
+|    |    +--- androidx.lifecycle:lifecycle-runtime-compose:2.9.2 -> 2.9.4 (*)
+|    |    +--- androidx.lifecycle:lifecycle-viewmodel-compose:2.9.2 -> 2.9.4 (*)
+|    |    +--- androidx.tracing:tracing-ktx:1.3.0 (*)
+|    |    +--- io.insert-koin:koin-bom:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-android:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-androidx-compose:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-androidx-navigation:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-core-viewmodel:4.1.1 (*)
+|    |    +--- org.jetbrains.kotlin:kotlin-stdlib:2.2.21 (*)
+|    |    +--- io.insert-koin:koin-core:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-annotations:2.1.0 (*)
+|    |    +--- project :core:ui (*)
+|    |    +--- project :core:designsystem (*)
+|    |    +--- project :core:data (*)
+|    |    +--- io.insert-koin:koin-compose:4.1.1 (*)
+|    |    +--- io.insert-koin:koin-compose-viewmodel:4.1.1 (*)
+|    |    +--- org.jetbrains.compose.runtime:runtime:1.9.3 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-runtime-compose:2.9.6 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-compose:2.9.6 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel:2.9.6 (*)
+|    |    +--- org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-savedstate:2.9.6 (*)
+|    |    +--- org.jetbrains.androidx.savedstate:savedstate:1.4.0 (*)
+|    |    +--- org.jetbrains.androidx.core:core-bundle:1.0.1 (*)
+|    |    +--- org.jetbrains.androidx.navigation:navigation-compose:2.9.1 (*)
+|    |    +--- org.jetbrains.kotlinx:kotlinx-collections-immutable:0.4.0 (*)
+|    |    +--- org.jetbrains.kotlinx:kotlinx-serialization-json:1.9.0 (*)
+|    |    +--- org.jetbrains.compose.ui:ui:1.9.3 (*)
+|    |    +--- org.jetbrains.compose.foundation:foundation:1.9.3 (*)
+|    |    +--- org.jetbrains.compose.material3:material3:1.9.0-beta03 (*)
+|    |    +--- org.jetbrains.compose.components:components-resources:1.9.3 (*)
+|    |    +--- org.jetbrains.compose.components:components-ui-tooling-preview:1.9.3 (*)
+|    |    +--- project :core:datastore (*)
+|    |    \--- project :core-base:designsystem (*)
 |    \--- org.jetbrains.kotlin:kotlin-parcelize-runtime:2.2.21 (*)
 +--- project :core:data (*)
 +--- project :core:ui (*)

cmp-android/dependencies/prodReleaseRuntimeClasspath.txt

@@ -27,6 +27,7 @@
 :feature:mpay-qr
 :feature:mpay-qr-scan
 :feature:notification
+:feature:onboarding-language
 :feature:payments
 :feature:profile
 :feature:receipt

cmp-android/src/main/AndroidManifest.xml

@@ -44,6 +44,7 @@
         <activity
             android:name=".MainActivity"
             android:exported="true"
+            android:configChanges="locale|layoutDirection"
             android:theme="@style/Theme.MifosSplash"
             android:windowSoftInputMode="adjustResize">
             <intent-filter>

cmp-android/src/main/kotlin/org/mifospay/MainActivity.kt

@@ -10,12 +10,14 @@
 package org.mifospay
 
 import android.os.Bundle
-import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
+import androidx.appcompat.app.AppCompatActivity
+import androidx.appcompat.app.AppCompatDelegate
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.setValue
+import androidx.core.os.LocaleListCompat
 import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
 import androidx.core.view.WindowCompat
 import androidx.lifecycle.Lifecycle
@@ -35,7 +37,7 @@ import org.mifospay.shared.MainUiState
 import org.mifospay.shared.MifosPaySharedApp
 import org.mifospay.shared.MifosPayViewModel
 
-class MainActivity : ComponentActivity() {
+class MainActivity : AppCompatActivity() {
     private val networkMonitor: NetworkMonitor by inject()
     private val timeZoneMonitor: TimeZoneMonitor by inject()
     private val viewModel: MifosPayViewModel by viewModel()
@@ -57,7 +59,31 @@ class MainActivity : ComponentActivity() {
         lifecycleScope.launch {
             lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
                 viewModel.uiState
-                    .onEach { uiState = it }
+                    .onEach { state ->
+                        uiState = state
+                        if (state is MainUiState.Success) {
+                            val languageTag = state.language.localName
+                            val currentAppLocales = AppCompatDelegate.getApplicationLocales()
+
+                            val isRequestedDefault = languageTag.isNullOrBlank()
+                            val isCurrentDefault = currentAppLocales.isEmpty
+
+                            val shouldUpdate = if (isRequestedDefault) {
+                                !isCurrentDefault
+                            } else {
+                                languageTag != currentAppLocales.toLanguageTags()
+                            }
+
+                            if (shouldUpdate) {
+                                val appLocale: LocaleListCompat = if (isRequestedDefault) {
+                                    LocaleListCompat.getEmptyLocaleList()
+                                } else {
+                                    LocaleListCompat.forLanguageTags(languageTag)
+                                }
+                                AppCompatDelegate.setApplicationLocales(appLocale)
+                            }
+                        }
+                    }
                     .collect()
             }
         }

cmp-shared/build.gradle.kts

@@ -58,6 +58,7 @@ kotlin {
             implementation(projects.feature.fastMpay)
             implementation(projects.feature.merchants)
             implementation(projects.feature.upiSetup)
+            implementation(projects.feature.onboardingLanguage)
         }
 
         desktopMain.dependencies {

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/MifosPayApp.kt

@@ -24,6 +24,7 @@ import org.mifospay.core.data.util.NetworkMonitor
 import org.mifospay.core.data.util.TimeZoneMonitor
 import org.mifospay.core.designsystem.component.MifosDialogBox
 import org.mifospay.core.designsystem.theme.MifosTheme
+import org.mifospay.feature.onboarding.language.navigation.ONBOARDING_LANGUAGE_ROUTE
 import org.mifospay.shared.MainUiState.Success
 import org.mifospay.shared.navigation.MifosNavGraph.LOGIN_GRAPH
 import org.mifospay.shared.navigation.MifosNavGraph.PASSCODE_GRAPH
@@ -79,7 +80,9 @@ private fun MifosPayApp(
 
     val navDestination = when (uiState) {
         is MainUiState.Loading -> LOGIN_GRAPH
-        is Success -> if ((uiState as Success).userData.authenticated) {
+        is Success -> if ((uiState as Success).showOnboarding) {
+            ONBOARDING_LANGUAGE_ROUTE
+        } else if ((uiState as Success).userData.authenticated) {
             PASSCODE_GRAPH
         } else {
             LOGIN_GRAPH

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/MifosPayViewModel.kt

@@ -13,19 +13,24 @@ import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import kotlinx.coroutines.flow.SharingStarted
 import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.combine
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import org.mifospay.core.datastore.UserPreferencesRepository
+import org.mifospay.core.model.LanguageConfig
 import org.mifospay.core.model.user.UserInfo
 import proto.org.mifos.library.passcode.data.PasscodeManager
 
 class MifosPayViewModel(
     private val userDataRepository: UserPreferencesRepository,
     private val passcodeManager: PasscodeManager,
 ) : ViewModel() {
-    val uiState: StateFlow<MainUiState> = userDataRepository.userInfo.map {
-        MainUiState.Success(it)
+    val uiState: StateFlow<MainUiState> = combine(
+        userDataRepository.userInfo,
+        userDataRepository.language,
+        userDataRepository.showOnboarding,
+    ) { userInfo, language, showOnboarding ->
+        MainUiState.Success(userInfo, language, showOnboarding)
     }.stateIn(
         scope = viewModelScope,
         initialValue = MainUiState.Loading,
@@ -42,5 +47,9 @@ class MifosPayViewModel(
 
 sealed interface MainUiState {
     data object Loading : MainUiState
-    data class Success(val userData: UserInfo) : MainUiState
+    data class Success(
+        val userData: UserInfo,
+        val language: LanguageConfig,
+        val showOnboarding: Boolean,
+    ) : MainUiState
 }

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/di/KoinModules.kt

@@ -36,6 +36,7 @@ import org.mifospay.feature.merchants.di.MerchantsModule
 import org.mifospay.feature.mpay.qr.di.MpayQrModule
 import org.mifospay.feature.mpay.qr.scan.di.MpayQrScanModule
 import org.mifospay.feature.notification.di.NotificationModule
+import org.mifospay.feature.onboarding.language.di.onboardingLanguageModule
 import org.mifospay.feature.payments.di.PaymentsModule
 import org.mifospay.feature.profile.di.ProfileModule
 import org.mifospay.feature.receipt.di.ReceiptModule
@@ -94,6 +95,7 @@ object KoinModules {
             FastMpayModule,
             MerchantsModule,
             UpiSetupModule,
+            onboardingLanguageModule,
         )
     }
     private val LibraryModule = module {

cmp-shared/src/commonMain/kotlin/org/mifospay/shared/navigation/RootNavGraph.kt

@@ -20,6 +20,8 @@ import androidx.navigation.compose.NavHost
 import androidx.navigation.compose.composable
 import org.mifospay.core.data.util.NetworkMonitor
 import org.mifospay.core.data.util.TimeZoneMonitor
+import org.mifospay.feature.onboarding.language.navigation.ONBOARDING_LANGUAGE_ROUTE
+import org.mifospay.feature.onboarding.language.navigation.onboardingLanguageScreen
 import org.mifospay.shared.instance.InstanceSelectorScreen
 import org.mifospay.shared.ui.MifosApp
 
@@ -45,6 +47,16 @@ internal fun RootNavGraph(
             onShowInstanceSelector = { showInstanceSelector = true },
         )
 
+        onboardingLanguageScreen(
+            onNavigateToNext = {
+                navHostController.navigate(MifosNavGraph.LOGIN_GRAPH) {
+                    popUpTo(ONBOARDING_LANGUAGE_ROUTE) {
+                        inclusive = true
+                    }
+                }
+            },
+        )
+
         passcodeNavGraph(navHostController)
 
         composable(MifosNavGraph.MAIN_GRAPH) {

core/datastore/src/commonMain/kotlin/org/mifospay/core/datastore/UserPreferencesDataSource.kt

@@ -26,6 +26,7 @@ import kotlinx.serialization.builtins.serializer
 import org.mifospay.core.datastore.UserPreferencesDataSource.Companion.DEFAULT_ACCOUNT
 import org.mifospay.core.datastore.model.ClientPreferences
 import org.mifospay.core.datastore.model.UserInfoPreferences
+import org.mifospay.core.model.LanguageConfig
 import org.mifospay.core.model.account.DefaultAccount
 import org.mifospay.core.model.client.Client
 import org.mifospay.core.model.client.UpdatedClient
@@ -38,6 +39,8 @@ private const val CLIENT_INFO_KEY = "clientInfo"
 private const val SELECTED_INSTANCE_KEY = "selectedInstance"
 private const val SELECTED_INTERBANK_INSTANCE_KEY = "selectedInterbankInstance"
 private const val ACCOUNT_EXTERNAL_IDS_KEY = "accountExternalIds"
+private const val LANGUAGE_KEY = "language"
+private const val SHOW_ONBOARDING_KEY = "showOnboarding"
 
 @OptIn(ExperimentalSerializationApi::class)
 class UserPreferencesDataSource(
@@ -91,6 +94,24 @@ class UserPreferencesDataSource(
         ),
     )
 
+    private val _language = MutableStateFlow(
+        settings.decodeValue(
+            key = LANGUAGE_KEY,
+            serializer = LanguageConfig.serializer(),
+            defaultValue = settings.decodeValueOrNull(
+                key = LANGUAGE_KEY,
+                serializer = LanguageConfig.serializer(),
+            ) ?: LanguageConfig.DEFAULT,
+        ),
+    )
+
+    private val _showOnboarding = MutableStateFlow(
+        settings.getBoolean(
+            key = SHOW_ONBOARDING_KEY,
+            defaultValue = true,
+        ),
+    )
+
     private val _accountExternalIds = MutableStateFlow(
         settings.decodeValueOrNull(
             key = ACCOUNT_EXTERNAL_IDS_KEY,
@@ -113,6 +134,10 @@ class UserPreferencesDataSource(
 
     val selectedInterbankInstance = _selectedInterbankInstance
 
+    val language = _language
+
+    val showOnboarding = _showOnboarding
+
     val accountExternalIds = _accountExternalIds
 
     suspend fun updateClientInfo(client: Client) {
@@ -186,6 +211,20 @@ class UserPreferencesDataSource(
         }
     }
 
+    suspend fun setLanguage(language: LanguageConfig) {
+        withContext(dispatcher) {
+            settings.putLanguage(language)
+            _language.value = language
+        }
+    }
+
+    suspend fun setShowOnboarding(showOnboarding: Boolean) {
+        withContext(dispatcher) {
+            settings.putBoolean(SHOW_ONBOARDING_KEY, showOnboarding)
+            _showOnboarding.value = showOnboarding
+        }
+    }
+
     suspend fun updateAccountExternalIds(accountExternalIds: Map<Long, String>) {
         withContext(dispatcher) {
             settings.putAccountExternalIds(accountExternalIds)
@@ -199,7 +238,18 @@ class UserPreferencesDataSource(
 
     suspend fun clearInfo() {
         withContext(dispatcher) {
+            val currentLanguage = _language.value
+            val currentShowOnboarding = _showOnboarding.value
+
             settings.clear()
+
+            settings.putLanguage(currentLanguage)
+            settings.putBoolean(SHOW_ONBOARDING_KEY, currentShowOnboarding)
+
+            _userInfo.value = UserInfoPreferences.DEFAULT
+            _clientInfo.value = ClientPreferences.DEFAULT
+            _defaultAccount.value = DefaultAccount.DEFAULT
+            _accountExternalIds.value = emptyMap()
         }
     }
 
@@ -249,6 +299,14 @@ private fun Settings.putSelectedInterbankInstance(instance: InterbankServer) {
     )
 }
 
+private fun Settings.putLanguage(language: LanguageConfig) {
+    encodeValue(
+        key = LANGUAGE_KEY,
+        serializer = LanguageConfig.serializer(),
+        value = language,
+    )
+}
+
 private fun Settings.putAccountExternalIds(accountExternalIds: Map<Long, String>) {
     encodeValue(
         key = ACCOUNT_EXTERNAL_IDS_KEY,

core/datastore/src/commonMain/kotlin/org/mifospay/core/datastore/UserPreferencesRepository.kt

@@ -12,6 +12,7 @@ package org.mifospay.core.datastore
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.StateFlow
 import org.mifospay.core.common.DataState
+import org.mifospay.core.model.LanguageConfig
 import org.mifospay.core.model.account.DefaultAccount
 import org.mifospay.core.model.client.Client
 import org.mifospay.core.model.client.UpdatedClient
@@ -38,6 +39,10 @@ interface UserPreferencesRepository {
 
     val selectedInterbankInstance: StateFlow<InterbankServer?>
 
+    val language: StateFlow<LanguageConfig>
+
+    val showOnboarding: StateFlow<Boolean>
+
     val accountExternalIds: StateFlow<Map<Long, String>>
 
     suspend fun updateToken(token: String): DataState<Unit>
@@ -54,6 +59,10 @@ interface UserPreferencesRepository {
 
     suspend fun updateSelectedInterbankInstance(instance: InterbankServer): DataState<Unit>
 
+    suspend fun setLanguage(language: LanguageConfig): DataState<Unit>
+
+    suspend fun setShowOnboarding(showOnboarding: Boolean): DataState<Unit>
+
     suspend fun updateAccountExternalIds(accountExternalIds: Map<Long, String>): DataState<Unit>
 
     fun getAccountExternalId(accountId: Long): String?