🚀 [Release v4.11.0]

.gitignore

@@ -46,4 +46,5 @@ service-data.json
 canary-file.json
 
 # Claude
-.claude/
+.claude/
+CLAUDE.local.md

README.md

@@ -73,6 +73,29 @@ For the full, up-to-date changelog see [GitHub Releases](https://github.com/grun
 
 ---
 
+### **v4.11.0**  [PR [#259](https://github.com/gruntsoftware/android/pull/259)]
+---
+#### 🎮 Fallinmoji v1.6.0 — Ready, Set, GO!
+Tapping **Play** (or **Play Again** from the end screen) now runs a short intro sequence before the round begins instead of dropping straight into gameplay:
+- **Ready dialog** — shows the round's 3 target emojis on star icons alongside the bonus-scoring rules for ~4.8s
+- **3-2-1-GO! countdown** — a rewired full-screen countdown over a looping 6-frame ray-burst flipbook and center star accent, replacing the old libGDX `ParticleEffect`-driven burst for more reliable screen coverage and consistent timing
+- Main menu button artwork polished (Play / How-To buttons)
+
+#### 🧪 Test Coverage
+Added 48 new unit tests across 7 new test classes, closing coverage gaps on previously-untested pure-logic utilities and the `gameinterface` package:
+- `Base58Test`, `TypesConverterTest`, `BytesUtilTest`, `BRCompressorTest`, `BRDateUtilTest` — encode/decode round-trips, gzip/bz2 compression round-trips, and relative-time formatting edge cases
+- `GameKoinModuleTest` — verifies the `gameModule` Koin DI wiring resolves `GameSlot` to `GdxGameSlot` as a singleton
+- `GdxGameViewTest` — covers `GameExitData` JSON parsing (defaults, unknown-key tolerance) and the social-share dispatch logic in `handleGameExit` (Twitter/Instagram screenshot sharing, missing/empty screenshots, malformed JSON, unrecognized networks)
+
+#### 🔧 Chores
+- Added `skills-lock.json` to track installed Claude Code skills (`aso`, `mobile-android-design`)
+- `.gitignore`: also exclude `CLAUDE.local.md`
+- Version bumped: **v4.10.6 (202506345) → v4.11.0 (202506346)**
+
+**Full Changelog**: https://github.com/gruntsoftware/android/compare/v4.10.6...v4.11.0
+
+---
+
 ### **v4.10.6**  [PR [#253](https://github.com/gruntsoftware/android/pull/253)]
 ---
 #### 🐛 Crash Fixes

app/build.gradle.kts

@@ -31,8 +31,8 @@ android {
         applicationId = "ltd.grunt.brainwallet"
         minSdk = 29
         targetSdk = 35
-        versionCode = 202506345
-        versionName = "v4.10.6"
+        versionCode = 202506347
+        versionName = "v4.11.0"
         multiDexEnabled = true
         base.archivesName.set("${defaultConfig.versionName}(${defaultConfig.versionCode})")
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"

app/src/main/java/com/brainwallet/appreview/InAppReviewService.kt

@@ -20,7 +20,7 @@ class InAppReviewService(
     public fun showInAppReviewDialogIfNeeded() {
         val activity = activityProvider() ?: return
         if (!BRSharedPrefs.isInAppReviewDone(app) &&
-            BRSharedPrefs.getSendTransactionCount(app) > 2
+            BRSharedPrefs.getSendTransactionCount(app) > 1
         ) {
             val manager = ReviewManagerFactory.create(app)
             val request = manager.requestReviewFlow()

app/src/main/java/com/brainwallet/di/AppModule.kt

@@ -1,8 +1,11 @@
 package com.brainwallet.di
 
+import android.app.Activity
 import android.content.Context
 import android.content.SharedPreferences
+import com.brainwallet.BrainwalletApp
 import com.brainwallet.BuildConfig
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.data.repository.TxRepository
 import com.brainwallet.data.source.RemoteApiSource
 import com.brainwallet.tools.sqlite.CurrencyDataSource
@@ -45,6 +48,7 @@ object AppModule {
         single<SharedPreferences> { provideSharedPreferences(context = androidApplication()) }
         single<TxRepository> { TxRepositoryImpl(get()) }
         single { SyncThreadManager(get(), get()) }
+        single { InAppReviewService(androidApplication()) { BrainwalletApp.breadContext as? Activity } }
     }
 
     private fun provideSharedPreferences(

app/src/main/java/com/brainwallet/gameinterface/GdxGameView.kt

@@ -35,7 +35,7 @@ import org.koin.compose.viewmodel.koinViewModel
 import timber.log.Timber
 
 @Serializable
-private data class GameExitData(
+internal data class GameExitData(
     @SerialName("social_network") val socialNetwork: String = "none",
     val timestamp: Long = 0L,
     @SerialName("total_score") val totalScore: Int = 0,
@@ -102,7 +102,7 @@ private fun removeFragment(fm: FragmentManager, tag: String) {
     }
 }
 
-private fun handleGameExit(
+internal fun handleGameExit(
     jsonString: String,
     bytes: ByteArray?,
     gameHubViewModel: GameHubViewModel,

app/src/main/java/com/brainwallet/ui/bentosections/balancebento/BalanceBentoScreen.kt

@@ -32,6 +32,7 @@ import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableIntStateOf
 import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
@@ -51,6 +52,7 @@ import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.compose.LifecycleEventEffect
 import androidx.lifecycle.viewmodel.compose.viewModel
 import com.brainwallet.R
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.presenter.entities.TxItem
 import com.brainwallet.tools.manager.AnalyticsManager
 import com.brainwallet.ui.screens.main.MainScreenEvent
@@ -61,6 +63,9 @@ import com.brainwallet.ui.theme.IBMPlexSans
 import com.brainwallet.ui.theme.balanceGameBentoSurface
 import com.brainwallet.ui.theme.blurWhen
 import kotlinx.collections.immutable.ImmutableList
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.launch
+import org.koin.compose.koinInject
 import org.koin.compose.viewmodel.koinViewModel
 import java.math.BigDecimal
 
@@ -107,8 +112,10 @@ fun BalanceBentoScreen(
     onDebugStatusUpdate: () -> Unit = {},
     onDebugTxAdded: () -> Unit = {},
     onDebugBalanceChanged: () -> Unit = {},
+    inAppReviewService: InAppReviewService = koinInject(),
 ) {
     val context = LocalContext.current
+    val coroutineScope = rememberCoroutineScope()
     val infiniteTransition = rememberInfiniteTransition()
     var previousBalance by remember { mutableStateOf(BigDecimal.ZERO) }
     val boingAudioPlayer = remember { MediaPlayer.create(context, R.raw.boingspringmouthharp042013) }
@@ -183,6 +190,12 @@ fun BalanceBentoScreen(
                         isSwapped = !isSwapped
                         boingAudioPlayer.start()
                         AnalyticsManager.logCustomEventWithParams("did_toggle_fiat_ltc", null)
+                        if (isSwapped) {
+                            coroutineScope.launch {
+                                delay(800L)
+                                inAppReviewService.showInAppReviewDialogIfNeeded()
+                            }
+                        }
                     }
             ) {
                 // ──────── MY BALANCE LABEL ────────
@@ -255,9 +268,14 @@ fun BalanceBentoScreen(
                         .clickable(
                             interactionSource = remember { MutableInteractionSource() },
                         ) {
-                            AnalyticsManager.logCustomEventWithParams("did_toggle_balance_visibility", null)
-
                             onEvent(BalanceBentoEvent.OnToggleBalanceVisibility)
+                            AnalyticsManager.logCustomEventWithParams("did_toggle_balance_visibility", null)
+                            if (state.balanceHidden) {
+                                coroutineScope.launch {
+                                    delay(800L)
+                                    inAppReviewService.showInAppReviewDialogIfNeeded()
+                                }
+                            }
                         }
                         .blurWhen(!mainState.isInternetReachable),
                     painter = iconImage,

app/src/main/java/com/brainwallet/ui/bentosections/tutorials/send/TutorialSendPage2.kt

@@ -10,6 +10,7 @@ import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.layout.wrapContentWidth
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Color
@@ -21,15 +22,21 @@ import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.ui.composable.CalloutWithPointers
 import com.brainwallet.ui.composable.Pointer
 import com.brainwallet.ui.theme.IBMPlexSans
+import org.koin.compose.koinInject
 
 @Composable
 fun TutorialSendPage2(
     darkMode: Boolean,
-    modifier: Modifier = Modifier
+    modifier: Modifier = Modifier,
+    inAppReviewService: InAppReviewService = koinInject()
 ) {
+    LaunchedEffect(Unit) {
+        inAppReviewService.showInAppReviewDialogIfNeeded()
+    }
     Box(
         modifier = Modifier
             .fillMaxWidth()

app/src/main/java/com/brainwallet/ui/bentosections/tutorials/walkthrough/TutorialWalkthroughPage3.kt

@@ -9,6 +9,7 @@ import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.layout.wrapContentWidth
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Color
@@ -20,15 +21,22 @@ import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.ui.composable.CalloutWithPointers
 import com.brainwallet.ui.composable.Pointer
 import com.brainwallet.ui.theme.IBMPlexSans
+import org.koin.compose.koinInject
 
 @Composable
 fun TutorialWalkthroughPage3(
     darkMode: Boolean,
-    modifier: Modifier = Modifier
+    modifier: Modifier = Modifier,
+    inAppReviewService: InAppReviewService = koinInject()
 ) {
+    LaunchedEffect(Unit) {
+        inAppReviewService.showInAppReviewDialogIfNeeded()
+    }
+
     Box(
         modifier = Modifier
             .fillMaxWidth()

app/src/main/java/com/brainwallet/ui/screens/gamehub/GameHubViewModel.kt

@@ -7,11 +7,15 @@ import android.graphics.BitmapFactory
 import android.os.Bundle
 import android.os.Environment
 import androidx.core.content.FileProvider
+import androidx.lifecycle.viewModelScope
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.tools.manager.AnalyticsManager
 import com.brainwallet.ui.BrainwalletViewModel
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.launch
 import kotlinx.serialization.json.Json
 import kotlinx.serialization.json.jsonObject
 import kotlinx.serialization.json.jsonPrimitive
@@ -22,6 +26,7 @@ import java.io.FileOutputStream
 @KoinViewModel
 class GameHubViewModel(
     private val app: Application,
+    private val inAppReviewService: InAppReviewService,
 ) : BrainwalletViewModel<GameHubEvent>() {
     private val _state =
         MutableStateFlow(GameHubState())
@@ -115,6 +120,12 @@ class GameHubViewModel(
                         }
                     )
                 }
+
+                AnalyticsManager.logCustomEventWithParams("did_play_game", null)
+                viewModelScope.launch {
+                    delay(800L)
+                    inAppReviewService.showInAppReviewDialogIfNeeded()
+                }
             }
         }
     }

app/src/main/java/com/brainwallet/ui/screens/send/SendViewModel.kt

@@ -3,6 +3,7 @@ package com.brainwallet.ui.screens.send
 import android.app.Application
 import androidx.lifecycle.viewModelScope
 import com.brainwallet.R
+import com.brainwallet.appreview.InAppReviewService
 import com.brainwallet.constants.BWConstants
 import com.brainwallet.data.repository.SettingRepository
 import com.brainwallet.data.repository.TxRepository
@@ -46,6 +47,7 @@ class SendViewModel(
     private val txRepository: TxRepository,
     private val settingRepository: SettingRepository,
     private val currencyDataGetter: CurrencyDataGetter,
+    private val inAppReviewService: InAppReviewService,
     private val isWalletCreated: () -> Boolean = { BRWalletManager.getInstance().isCreated() },
     private val validateAddress: (String) -> Boolean = { BRWalletManager.getInstance().validateAddress(it) },
     private val getBalance: () -> Long = { BRWalletManager.getInstance().getBalance(app) },
@@ -57,7 +59,6 @@ class SendViewModel(
     val state: StateFlow<SendState> = _state.asStateFlow()
     private val _effect = MutableSharedFlow<SendEffect>(extraBufferCapacity = 1)
     val effect: SharedFlow<SendEffect> = _effect.asSharedFlow()
-
     init {
         viewModelScope.launch {
             settingRepository.currentSettings.collect { currentSettings ->
@@ -281,8 +282,10 @@ class SendViewModel(
                             _effect.emit(SendEffect.DismissSheet)
                             AnalyticsManager.logCustomEvent(BWConstants._20191105_DSL)
                             BRSharedPrefs.incrementSendTransactionCount(app)
+                            delay(800L)
+                            inAppReviewService.showInAppReviewDialogIfNeeded()
                         }
-                        is BWSendResult.Error.InsufficientFunds -> {
+                        is Error.InsufficientFunds -> {
                             _state.update {
                                 it.copy(
                                     errorResultString = String.format(
@@ -293,7 +296,7 @@ class SendViewModel(
                                 )
                             }
                         }
-                        is BWSendResult.Error.AmountTooSmall -> {
+                        is Error.AmountTooSmall -> {
                             _state.update {
                                 it.copy(
                                     errorResultString = String.format(
@@ -304,9 +307,9 @@ class SendViewModel(
                                 )
                             }
                         }
-                        BWSendResult.Error.AlreadySending,
-                        BWSendResult.Error.TimedOut,
-                        is BWSendResult.Error.Unknown -> {
+                        Error.AlreadySending,
+                        Error.TimedOut,
+                        is Error.Unknown -> {
                             Timber.e("Send unknown error: $result")
                             _state.update {
                                 it.copy(