ci: add BuildTool and route Android builds through it

.gitea/workflows/android-build.yml

@@ -0,0 +1,84 @@
+name: Android build
+
+permissions:
+  contents: write
+  releases: write
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      - name: Run project build tooling for debug APK
+        if: github.event_name != 'release'
+        shell: bash
+        env:
+          CI_VERSION_CODE: ${{ github.run_number }}
+        run: |
+          set -euxo pipefail
+          chmod +x ./BuildTool.sh
+          ./BuildTool.sh --no-commit --apk-only
+
+      - name: Run project build tooling for release AAB
+        if: github.event_name == 'release'
+        shell: bash
+        env:
+          CI_VERSION_CODE: ${{ github.run_number }}
+          CI_ARTIFACT_TIMESTAMP: ${{ github.run_id }}
+          ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
+          ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
+          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+          ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
+        run: |
+          set -euxo pipefail
+          chmod +x ./BuildTool.sh
+          ./BuildTool.sh --no-commit --with-aab
+
+      - name: Upload debug APK
+        if: github.event_name != 'release'
+        uses: actions/upload-artifact@v3
+        with:
+          name: debug-apk
+          path: dist/*.apk
+          if-no-files-found: error
+
+      - name: Attach release AAB to Gitea release
+        if: github.event_name == 'release'
+        env:
+          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
+          GITHUB_TOKEN: ${{ github.token }}
+        shell: bash
+        run: |
+          set -euxo pipefail
+          token="${GITHUB_TOKEN:-${GITEA_TOKEN:-}}"
+          if [ -z "$token" ]; then
+            echo "::error::No release upload token is available from secrets.GITEA_TOKEN or github.token"
+            exit 1
+          fi
+          release_id="$(python3 -c 'import json, os; print(json.load(open(os.environ["GITHUB_EVENT_PATH"], encoding="utf-8"))["release"]["id"])')"
+          aab="$(find dist -name '*.aab' | head -n 1)"
+          curl --fail-with-body \
+            --request POST \
+            --header "Authorization: token ${token}" \
+            --form "attachment=@${aab}" \
+            "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases/${release_id}/assets?name=$(basename "$aab")"

.gitignore

@@ -3,9 +3,13 @@
 *.iml
 build/
 app/build/
+dist/
+commit-message.txt
+.android-sdk/
 local.properties
 
 # Signing
 keystore/*.jks
 keystore/*.properties
-
+keystore.properties
+.ci-secrets/

BuildTool.sh

@@ -0,0 +1,263 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+APP_NAME="MindMachine"
+MODULE="app"
+API_LEVEL="36"
+BUILD_TOOLS_VERSION="36.0.0"
+DIST_DIR="dist"
+COMMIT_MSG_FILE="commit-message.txt"
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$ROOT_DIR"
+
+export GRADLE_OPTS="${GRADLE_OPTS:-} -Dorg.gradle.daemon=false"
+
+usage() {
+  cat <<EOF
+Usage: ./BuildTool.sh [options]
+
+Options:
+  --setup-only      Check/install build environment and exit
+  --no-commit       Build successfully but do not auto-commit
+  --apk-only        Build debug APK only (default)
+  --with-aab        Also build release AAB
+  --help            Show this help
+
+Behavior:
+  - Disables Gradle daemon
+  - Increments versionCode/versionName for local builds
+  - Honors CI_VERSION_CODE for CI builds
+  - Names CI release AABs with APP_NAME + CI_ARTIFACT_TIMESTAMP when provided
+  - Uses repo secrets from env for release signing when provided
+  - Copies artifacts to dist/
+EOF
+}
+
+SETUP_ONLY=false
+DO_COMMIT=true
+WITH_AAB=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --setup-only) SETUP_ONLY=true ;;
+    --no-commit) DO_COMMIT=false ;;
+    --apk-only) WITH_AAB=false ;;
+    --with-aab) WITH_AAB=true ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown option: $arg" >&2; usage; exit 1 ;;
+  esac
+done
+
+CI_VERSION_CODE="${CI_VERSION_CODE:-}"
+CI_ARTIFACT_TIMESTAMP="${CI_ARTIFACT_TIMESTAMP:-}"
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1 || {
+    echo "Missing required command: $1" >&2
+    exit 1
+  }
+}
+
+ensure_java() {
+  need_cmd java
+  local major
+  major="$(java -version 2>&1 | awk -F[\".] '/version/ {print $2}')"
+  if [[ "${major:-0}" -lt 17 ]]; then
+    echo "Java 17+ is required. Found Java ${major:-unknown}." >&2
+    exit 1
+  fi
+}
+
+ensure_android_sdk() {
+  if [[ -z "${ANDROID_HOME:-}" ]]; then
+    export ANDROID_HOME="$ROOT_DIR/.android-sdk"
+  fi
+  export ANDROID_SDK_ROOT="$ANDROID_HOME"
+  export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$PATH"
+
+  if [[ ! -x "$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" ]]; then
+    need_cmd curl
+    need_cmd unzip
+    mkdir -p "$ANDROID_HOME/cmdline-tools"
+    local zip_path="$ANDROID_HOME/cmdline-tools/commandlinetools.zip"
+    curl -L -o "$zip_path" "https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip"
+    rm -rf "$ANDROID_HOME/cmdline-tools/latest" "$ANDROID_HOME/cmdline-tools/cmdline-tools"
+    unzip -q "$zip_path" -d "$ANDROID_HOME/cmdline-tools"
+    mv "$ANDROID_HOME/cmdline-tools/cmdline-tools" "$ANDROID_HOME/cmdline-tools/latest"
+    rm "$zip_path"
+  fi
+
+  yes | sdkmanager --licenses >/dev/null || true
+  sdkmanager \
+    "platform-tools" \
+    "platforms;android-$API_LEVEL" \
+    "build-tools;$BUILD_TOOLS_VERSION" >/dev/null
+}
+
+ensure_gradle_wrapper() {
+  if [[ ! -x "./gradlew" ]]; then
+    if [[ -f "./gradlew" ]]; then
+      chmod +x ./gradlew
+    else
+      echo "Missing Gradle wrapper ./gradlew" >&2
+      exit 1
+    fi
+  fi
+}
+
+gradle_no_daemon() {
+  ./gradlew --no-daemon -Dorg.gradle.daemon=false "$@"
+}
+
+prepare_optional_release_signing() {
+  local required=(ANDROID_KEYSTORE_BASE64 ANDROID_KEYSTORE_PASSWORD ANDROID_KEY_ALIAS ANDROID_KEY_PASSWORD)
+  local missing=()
+  local key
+  for key in "${required[@]}"; do
+    if [[ -z "${!key:-}" ]]; then
+      missing+=("$key")
+    fi
+  done
+
+  if [[ ${#missing[@]} -eq ${#required[@]} ]]; then
+    return
+  fi
+  if [[ ${#missing[@]} -gt 0 ]]; then
+    printf 'Release signing secrets missing: %s\n' "${missing[*]}" >&2
+    exit 1
+  fi
+
+  mkdir -p .ci-secrets
+  printf '%s' "$ANDROID_KEYSTORE_BASE64" | base64 -d > .ci-secrets/release-keystore.jks
+  cat > keystore.properties <<EOF
+storeFile=.ci-secrets/release-keystore.jks
+storePassword=$ANDROID_KEYSTORE_PASSWORD
+keyAlias=$ANDROID_KEY_ALIAS
+keyPassword=$ANDROID_KEY_PASSWORD
+EOF
+}
+
+ensure_gitignore_entries() {
+  touch .gitignore
+  for entry in \
+    "$COMMIT_MSG_FILE" \
+    ".android-sdk/" \
+    ".gradle/" \
+    "$DIST_DIR/" \
+    "local.properties" \
+    "**/build/" \
+    "*.iml" \
+    ".idea/" \
+  ; do
+    grep -qxF "$entry" .gitignore || echo "$entry" >> .gitignore
+  done
+}
+
+increment_versions() {
+  local gradle_file="$MODULE/build.gradle.kts"
+  python3 - "$gradle_file" "$CI_VERSION_CODE" <<'PY'
+import re
+import sys
+from pathlib import Path
+
+path = Path(sys.argv[1])
+text = path.read_text()
+ci_version_code = sys.argv[2].strip()
+
+m_code = re.search(r'\bversionCode\s*=\s*(\d+)', text)
+m_name = re.search(r'\bversionName\s*=\s*"(\d+(?:\.\d+)*)"', text)
+if not m_code or not m_name:
+    raise SystemExit('Could not find versionCode/versionName in app/build.gradle.kts')
+
+old_code = int(m_code.group(1))
+new_code = int(ci_version_code) if ci_version_code else old_code + 1
+parts = m_name.group(1).split('.')
+parts[-1] = str(int(parts[-1]) + 1)
+new_name = '.'.join(parts)
+
+text = re.sub(r'(\bversionCode\s*=\s*)\d+', rf'\g<1>{new_code}', text, count=1)
+if not ci_version_code:
+    text = re.sub(r'(\bversionName\s*=\s*)"\d+(?:\.\d+)*"', rf'\g<1>"{new_name}"', text, count=1)
+path.write_text(text)
+print(new_code)
+PY
+}
+
+build_artifacts() {
+  gradle_no_daemon clean assembleDebug
+  if [[ "$WITH_AAB" == true ]]; then
+    gradle_no_daemon bundleRelease
+  fi
+}
+
+copy_artifacts() {
+  local version_code="$1"
+  mkdir -p "$DIST_DIR"
+
+  local debug_apk
+  debug_apk="$(find "$MODULE/build/outputs/apk/debug" -name "*.apk" | head -n 1 || true)"
+  [[ -f "$debug_apk" ]] || { echo "Debug APK not found." >&2; exit 1; }
+  cp "$debug_apk" "$DIST_DIR/${APP_NAME}-v${version_code}-debug.apk"
+
+  if [[ "$WITH_AAB" == true ]]; then
+    local release_aab
+    release_aab="$(find "$MODULE/build/outputs/bundle/release" -name "*.aab" | head -n 1 || true)"
+    [[ -f "$release_aab" ]] || { echo "Release AAB not found." >&2; exit 1; }
+    local release_name
+    if [[ -n "$CI_ARTIFACT_TIMESTAMP" ]]; then
+      release_name="${APP_NAME}-${CI_ARTIFACT_TIMESTAMP}-release.aab"
+    else
+      release_name="${APP_NAME}-v${version_code}-release.aab"
+    fi
+    cp "$release_aab" "$DIST_DIR/$release_name"
+  fi
+}
+
+commit_successful_build() {
+  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || return
+  local message
+  if [[ -s "$COMMIT_MSG_FILE" ]]; then
+    message="$(cat "$COMMIT_MSG_FILE")"
+  else
+    message="No Details"
+  fi
+  git add -A
+  git reset -q HEAD -- keystore.properties '.ci-secrets' '*.jks' 2>/dev/null || true
+  if ! git diff --cached --quiet; then
+    git commit -m "$message"
+  fi
+  : > "$COMMIT_MSG_FILE"
+}
+
+main() {
+  need_cmd python3
+  ensure_java
+  ensure_android_sdk
+  ensure_gradle_wrapper
+  ensure_gitignore_entries
+
+  printf 'sdk.dir=%s\n' "$ANDROID_HOME" > local.properties
+
+  if [[ "$SETUP_ONLY" == true ]]; then
+    echo "Build environment setup complete."
+    exit 0
+  fi
+
+  if [[ "$WITH_AAB" == true ]]; then
+    prepare_optional_release_signing
+  fi
+
+  local version_code
+  version_code="$(increment_versions)"
+  build_artifacts
+  copy_artifacts "$version_code"
+
+  if [[ "$DO_COMMIT" == true ]]; then
+    commit_successful_build
+  fi
+
+  echo "Build completed successfully for versionCode $version_code."
+}
+
+main "$@"

DEVELOPMENT.md

@@ -2,6 +2,23 @@
 
 ## Build prerequisites
 
+Use the root build tooling so local builds and Gitea Actions run through the same script:
+
+```bash
+./BuildTool.sh --setup-only
+./BuildTool.sh --no-commit --apk-only
+./BuildTool.sh --no-commit --with-aab
+```
+
+Behavior summary:
+- `--setup-only` prepares the local Android SDK/tooling and exits.
+- `--apk-only` builds the debug APK.
+- `--with-aab` also builds the release AAB.
+- `--no-commit` skips the post-build git commit step.
+- Local builds increment `versionCode` and `versionName`.
+- CI can provide `CI_VERSION_CODE` to force the build version code and `CI_ARTIFACT_TIMESTAMP` to control the release AAB filename.
+- Artifacts are copied into `dist/`.
+
 - JDK 17
 - Android Studio (recommended)
 - Android SDK installed
@@ -108,3 +125,29 @@ Important: **Billing only works reliably when the app is installed from Google P
 6. **Verify in the app**
    - Trigger the subscribe/buy flow and confirm the purchase dialog appears.
    - Confirm acknowledgements/entitlements are applied as expected.
+
+
+## Billing logging (ADB)
+
+Billing logs are written to Android's system log (Logcat), not displayed in the app UI.
+
+To view billing logs:
+
+```bash
+# View only MindMachine billing logs
+adb logcat -s MindMachineBilling:D
+
+# Filter with silence for other tags
+adb logcat -s MindMachineBilling:D *:S
+```
+
+Example log lines you'll see:
+- `Billing setup finished: 0 OK`
+- `Product details loaded: 2 items`
+- `Query purchases returned X items`
+- `Active entitlement: true/false`
+- `Entitlement changed: false -> true`
+
+Billing log tags:
+- `MindMachineBilling` for debug/info messages
+- Errors use `Log.e()` and appear as `E/MindMachineBilling` in logcat

app/build.gradle.kts

@@ -1,45 +1,63 @@
+import java.util.Properties
+
 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
+    id("org.jetbrains.kotlin.plugin.serialization")
+    id("org.jetbrains.kotlin.plugin.compose")
 }
 
-import java.util.Properties
+val keystorePropertiesFile = rootProject.file("keystore.properties")
+val keystoreProperties = Properties()
+if (keystorePropertiesFile.exists()) {
+    keystorePropertiesFile.inputStream().use { keystoreProperties.load(it) }
+}
+val hasReleaseSigning = listOf(
+    "storeFile",
+    "storePassword",
+    "keyAlias",
+    "keyPassword",
+).all { !keystoreProperties.getProperty(it).isNullOrBlank() }
 
 android {
     namespace = "solutions.tretter.mindmachine"
-    compileSdk = 35
+    compileSdk = 36
 
     defaultConfig {
         applicationId = "solutions.tretter.mindmachine"
         minSdk = 26
-        targetSdk = 35
+        targetSdk = 36
-        versionCode = 6
+        versionCode = 18
-        versionName = "1.0.1"
+        versionName = "1.0.13"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
 
-    buildTypes {
     signingConfigs {
+        if (hasReleaseSigning) {
             create("release") {
-                val propsFile = rootProject.file("keystore/upload-keystore.properties")
+                storeFile = rootProject.file(keystoreProperties.getProperty("storeFile"))
-                if (propsFile.exists()) {
+                storePassword = keystoreProperties.getProperty("storePassword")
-                    val props = Properties().apply { propsFile.inputStream().use { this.load(it) } }
+                keyAlias = keystoreProperties.getProperty("keyAlias")
-                    storeFile = rootProject.file(props.getProperty("storeFile"))
+                keyPassword = keystoreProperties.getProperty("keyPassword")
-                    storePassword = props.getProperty("storePassword")
-                    keyAlias = props.getProperty("keyAlias")
-                    keyPassword = props.getProperty("keyPassword")
             }
         }
     }
 
+    buildTypes {
+        debug {
+            buildConfigField("boolean", "DEBUG_AD_FREE", "true")
+        }
         release {
+            if (hasReleaseSigning) {
                 signingConfig = signingConfigs.getByName("release")
+            }
             isMinifyEnabled = false
             proguardFiles(
                 getDefaultProguardFile("proguard-android-optimize.txt"),
                 "proguard-rules.pro"
             )
+            buildConfigField("boolean", "DEBUG_AD_FREE", "false")
         }
     }
     compileOptions {
@@ -51,9 +69,10 @@ android {
     }
     buildFeatures {
         compose = true
+        buildConfig = true
     }
     composeOptions {
-        kotlinCompilerExtensionVersion = "1.5.14"
+        kotlinCompilerExtensionVersion = "2.1.0"
     }
     packaging {
         resources {
@@ -81,9 +100,8 @@ dependencies {
     implementation("androidx.compose.material:material-icons-extended")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")
 
-    // Monetization
     implementation("com.google.android.gms:play-services-ads:23.1.0")
-    implementation("com.android.billingclient:billing-ktx:7.1.1")
+    implementation("com.android.billingclient:billing-ktx:8.0.0")
 
     testImplementation("junit:junit:4.13.2")
     testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.8.1")

app/src/main/java/com/mindmachine/mvp/MainActivity.kt

@@ -13,6 +13,7 @@ import android.util.Log
 import android.view.View
 import android.view.WindowManager
 import androidx.activity.ComponentActivity
+import solutions.tretter.mindmachine.BuildConfig
 import androidx.activity.compose.BackHandler
 import androidx.activity.compose.setContent
 import androidx.activity.viewModels
@@ -48,6 +49,7 @@ import androidx.compose.foundation.Image
 import androidx.compose.foundation.Image
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Add
+import androidx.compose.material.icons.filled.Close
 import androidx.compose.material.icons.filled.Delete
 import androidx.compose.material.icons.filled.PlayArrow
 import androidx.compose.material.icons.filled.Settings
@@ -158,9 +160,8 @@ class MainActivity : ComponentActivity() {
             onNoAdsEntitlementChanged = { hasNoAds ->
                 lifecycleScope.launch { settingsRepo.updateNoAds(hasNoAds) }
             },
-        )
+        ).also { it.start() }
     }
-
     private val vm: MainViewModel by viewModels {
         MainViewModel.Factory(
             settingsRepo,
@@ -173,7 +174,9 @@ class MainActivity : ComponentActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
+        if (!BuildConfig.DEBUG_AD_FREE) {
             MobileAds.initialize(this) {}
+        }
         setContent {
             MaterialTheme(colorScheme = MindMachineColors) {
                 App(vm, billingManager)
@@ -228,7 +231,7 @@ fun App(vm: MainViewModel = viewModel(), billingManager: solutions.tretter.mindm
         composable("home") {
             var confirmDeleteProgramId by remember { mutableStateOf<String?>(null) }
             var confirmDeleteProgramName by remember { mutableStateOf("") }
-            val interstitial = rememberInterstitialController(enabled = !ui.settings.noAds)
+            val interstitial = rememberInterstitialController(enabled = !ui.settings.noAds && !BuildConfig.DEBUG_AD_FREE)
 
             Column(
                 Modifier
@@ -343,11 +346,13 @@ fun App(vm: MainViewModel = viewModel(), billingManager: solutions.tretter.mindm
                     }
                 }
 
+                if (!BuildConfig.DEBUG_AD_FREE) {
                     AdBanner(
                         enabled = !ui.settings.noAds,
                         modifier = Modifier.fillMaxWidth()
                     )
                 }
+            }
 
             if (confirmDeleteProgramId != null) {
                 AlertDialog(
@@ -376,7 +381,7 @@ fun App(vm: MainViewModel = viewModel(), billingManager: solutions.tretter.mindm
             }
         }
         composable("setup") {
-            val interstitial = rememberInterstitialController(enabled = !ui.settings.noAds)
+            val interstitial = rememberInterstitialController(enabled = !ui.settings.noAds && !BuildConfig.DEBUG_AD_FREE)
             SetupScreen(
                 vm = vm,
                 onStart = {
@@ -598,6 +603,8 @@ fun ActiveSessionScreen(vm: MainViewModel, onFinish: () -> Unit, onBackToEntry:
     }
     var brightnessOverlayVisible by remember { mutableStateOf(false) }
     var brightnessOverlayToken by remember { mutableIntStateOf(0) }
+    var stopButtonVisible by remember { mutableStateOf(false) }
+    var stopButtonToken by remember { mutableIntStateOf(0) }
     val timingLogTag = "MindMachineTiming"
 
     LaunchedEffect(brightnessOverlayToken) {
@@ -643,12 +650,24 @@ fun ActiveSessionScreen(vm: MainViewModel, onFinish: () -> Unit, onBackToEntry:
                 detectTapGestures {
                     brightnessOverlayVisible = true
                     brightnessOverlayToken++
+                    if (ui.settings.showImmersiveStopButton && immersiveFullscreen) {
+                        stopButtonVisible = true
+                        stopButtonToken++
+                    }
                     if (!immersiveFullscreen) {
                         showOverlay = !showOverlay
                     }
                 }
             }
     ) {
+        // Auto-hide stop button after 3 seconds of visibility
+        LaunchedEffect(stopButtonToken) {
+            if (stopButtonVisible) {
+                delay(3000)
+                stopButtonVisible = false
+            }
+        }
+
         if (isVisualMode) {
             AndroidView(
                 modifier = Modifier.fillMaxSize(),
@@ -716,6 +735,26 @@ fun ActiveSessionScreen(vm: MainViewModel, onFinish: () -> Unit, onBackToEntry:
             }
         }
 
+        // Stop button in immersive mode (top-right)
+        if (stopButtonVisible && ui.settings.showImmersiveStopButton) {
+            IconButton(
+                onClick = {
+                    vm.stop()
+                    onFinish()
+                },
+                modifier = Modifier
+                    .align(Alignment.TopEnd)
+                    .padding(top = 16.dp, end = 16.dp)
+            ) {
+                Icon(
+                    imageVector = Icons.Filled.Close,
+                    contentDescription = "Stop",
+                    tint = Color.White,
+                    modifier = Modifier.size(28.dp)
+                )
+            }
+        }
+
         if (showOverlay) {
             Column(
                 Modifier
@@ -1037,6 +1076,7 @@ private class SplitFlashRenderView(context: Context) : View(context) {
 
     private fun paletteColor(color: solutions.tretter.mindmachine.session.FlashPaletteColor): Int = when (color) {
         solutions.tretter.mindmachine.session.FlashPaletteColor.BLACK -> android.graphics.Color.BLACK
+        solutions.tretter.mindmachine.session.FlashPaletteColor.WHITE -> android.graphics.Color.WHITE
         solutions.tretter.mindmachine.session.FlashPaletteColor.RED -> android.graphics.Color.RED
         solutions.tretter.mindmachine.session.FlashPaletteColor.GREEN -> android.graphics.Color.GREEN
         solutions.tretter.mindmachine.session.FlashPaletteColor.YELLOW -> android.graphics.Color.YELLOW
@@ -1233,6 +1273,18 @@ fun SettingsScreen(vm: MainViewModel, onRemoveAds: () -> Unit) {
             Text("Show immersive bottom progress bar", color = MaterialTheme.colorScheme.onBackground)
         }
 
+        Row(verticalAlignment = Alignment.CenterVertically) {
+            Checkbox(checked = ui.settings.showImmersiveStopButton, onCheckedChange = vm::updateShowImmersiveStopButton)
+            Column {
+                Text("Show stop button in immersive mode", color = MaterialTheme.colorScheme.onBackground)
+                Text(
+                    "If off, swipe from edge to display back button",
+                    style = MaterialTheme.typography.bodySmall,
+                    color = MaterialTheme.colorScheme.onBackground.copy(alpha = 0.7f)
+                )
+            }
+        }
+
         Row(verticalAlignment = Alignment.CenterVertically) {
             Checkbox(checked = ui.settings.preferLowestRefreshRate, onCheckedChange = vm::updatePreferLowestRefreshRate)
             Text("Prefer lowest display refresh rate during sessions", color = MaterialTheme.colorScheme.onBackground)
@@ -1255,7 +1307,6 @@ fun RemoveAdsScreen(billingManager: solutions.tretter.mindmachine.billing.Billin
     val ui by vm.ui.collectAsStateWithLifecycle()
     val activity = LocalContext.current as? Activity
     val details by billingManager.productDetails.collectAsStateWithLifecycle()
-    val logs by billingManager.logs.collectAsStateWithLifecycle()
 
     val subDetails = details[solutions.tretter.mindmachine.billing.BillingProducts.SUB_REMOVE_ADS_MONTHLY]
     val subPrice = subDetails
@@ -1307,21 +1358,6 @@ fun RemoveAdsScreen(billingManager: solutions.tretter.mindmachine.billing.Billin
             "Note: Purchases only work when the app is installed from Google Play (Internal testing/Production). Debug sideloaded builds won’t complete real billing flows.",
             color = MaterialTheme.colorScheme.onBackground.copy(alpha = 0.8f)
         )
-
-        // Debug logs
-        Text("Billing logs:", style = MaterialTheme.typography.titleMedium, color = MaterialTheme.colorScheme.onBackground)
-        Column(
-            Modifier
-                .weight(1f)
-                .fillMaxWidth()
-                .verticalScroll(rememberScrollState())
-                .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = 0.2f))
-                .padding(8.dp)
-        ) {
-            logs.forEach { log ->
-                Text(log, color = MaterialTheme.colorScheme.onBackground, style = MaterialTheme.typography.bodySmall)
-            }
-        }
     }
 }
 

app/src/main/java/com/mindmachine/mvp/billing/BillingManager.kt

@@ -2,13 +2,15 @@ package solutions.tretter.mindmachine.billing
 
 import android.app.Activity
 import android.content.Context
+import android.util.Log
 import com.android.billingclient.api.AcknowledgePurchaseParams
 import com.android.billingclient.api.BillingClient
 import com.android.billingclient.api.BillingClientStateListener
 import com.android.billingclient.api.BillingFlowParams
 import com.android.billingclient.api.BillingResult
 import com.android.billingclient.api.ProductDetails
-import com.android.billingclient.api.ProductDetailsResponseListener
+import com.android.billingclient.api.QueryProductDetailsResult
+import com.android.billingclient.api.PendingPurchasesParams
 import com.android.billingclient.api.Purchase
 import com.android.billingclient.api.PurchasesResponseListener
 import com.android.billingclient.api.QueryProductDetailsParams
@@ -16,9 +18,6 @@ import com.android.billingclient.api.QueryPurchasesParams
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.asStateFlow
-import java.text.SimpleDateFormat
-import java.util.Date
-import java.util.Locale
 
 class BillingManager(
     context: Context,
@@ -32,15 +31,12 @@ class BillingManager(
     private val _productDetails = MutableStateFlow<Map<String, ProductDetails>>(emptyMap())
     val productDetails: StateFlow<Map<String, ProductDetails>> = _productDetails.asStateFlow()
 
-    private val _logs = MutableStateFlow<List<String>>(emptyList())
-    val logs: StateFlow<List<String>> = _logs.asStateFlow()
-
     private fun log(message: String) {
-        val timestamp = SimpleDateFormat("HH:mm:ss.SSS", Locale.getDefault()).format(Date())
+        Log.d("MindMachineBilling", message)
-        _logs.value = _logs.value + "[$timestamp] $message"
-        if (_logs.value.size > 50) {
-            _logs.value = _logs.value.takeLast(50)
     }
+
+    private fun logError(message: String) {
+        Log.e("MindMachineBilling", message)
     }
 
     private val billingClient: BillingClient = BillingClient.newBuilder(appContext)
@@ -49,27 +45,48 @@ class BillingManager(
                 handlePurchases(purchases)
             }
         }
-        .enablePendingPurchases()
+        .enablePendingPurchases(
+	    PendingPurchasesParams.newBuilder()
+                .enableOneTimeProducts()
+                .build()
+	)
         .build()
 
+    @Volatile
+    private var isConnecting = false
+
     fun start() {
-        log("BillingManager.start()")
+        log("BillingManager.start() - isReady=${billingClient.isReady}, isConnecting=$isConnecting")
+
         if (billingClient.isReady) {
             log("Billing client already ready")
             refresh()
             return
         }
+
+        if (isConnecting) {
+            log("Billing client connection already in progress")
+            return
+        }
+
+        isConnecting = true
+        log("Calling startConnection()")
+
         billingClient.startConnection(object : BillingClientStateListener {
             override fun onBillingSetupFinished(result: BillingResult) {
+                isConnecting = false
                 log("Billing setup finished: ${result.responseCode} ${result.debugMessage}")
+
                 if (result.responseCode == BillingClient.BillingResponseCode.OK) {
 		    refresh()
+                } else {
+                    logError("Billing setup failed: ${result.responseCode} ${result.debugMessage}")
                 }
             }
 
             override fun onBillingServiceDisconnected() {
+                isConnecting = false
                 log("Billing service disconnected")
-                // No-op, will retry on next call.
             }
         })
     }
@@ -120,7 +137,11 @@ class BillingManager(
             .build()
 
         val result = billingClient.launchBillingFlow(activity, params)
-        log("launchBillingFlow result: ${result.responseCode} ${result.debugMessage}")
+        if (result.responseCode == BillingClient.BillingResponseCode.OK) {
+            log("launchBillingFlow succeeded")
+        } else {
+            logError("launchBillingFlow failed: ${result.responseCode} ${result.debugMessage}")
+        }
     }
 
     private fun queryProductDetails() {
@@ -130,28 +151,60 @@ class BillingManager(
             return
         }
 
-        val products = listOf(
+        val featureResult = billingClient.isFeatureSupported(BillingClient.FeatureType.PRODUCT_DETAILS)
-            QueryProductDetailsParams.Product.newBuilder()
+        log("PRODUCT_DETAILS support: ${featureResult.responseCode} ${featureResult.debugMessage}")
-                .setProductId(BillingProducts.SUB_REMOVE_ADS_MONTHLY)
+        if (featureResult.responseCode != BillingClient.BillingResponseCode.OK) {
-                .setProductType(BillingClient.ProductType.SUBS)
+            logError("PRODUCT_DETAILS feature not supported")
-                .build(),
+            return
-            QueryProductDetailsParams.Product.newBuilder()
+        }
-                .setProductId(BillingProducts.INAPP_REMOVE_ADS_FOREVER)
+
-                .setProductType(BillingClient.ProductType.INAPP)
+        queryProductDetailsForType(
-                .build(),
+            productType = BillingClient.ProductType.SUBS,
+            productIds = listOf(BillingProducts.SUB_REMOVE_ADS_MONTHLY)
         )
 
+        queryProductDetailsForType(
+            productType = BillingClient.ProductType.INAPP,
+            productIds = listOf(BillingProducts.INAPP_REMOVE_ADS_FOREVER)
+        )
+    }
+
+    private fun queryProductDetailsForType(
+        productType: String,
+        productIds: List<String>
+    ) {
+        try {
+            log("Querying $productType product details for $productIds")
+
+            val products = productIds.map { productId ->
+                QueryProductDetailsParams.Product.newBuilder()
+                    .setProductId(productId)
+                    .setProductType(productType)
+                    .build()
+            }
+
             val params = QueryProductDetailsParams.newBuilder()
                 .setProductList(products)
                 .build()
 
-        billingClient.queryProductDetailsAsync(params, ProductDetailsResponseListener { result, detailsList ->
+            billingClient.queryProductDetailsAsync(params) { billingResult, queryResult ->
-            log("queryProductDetails result: ${result.responseCode} ${result.debugMessage}")
+                log("queryProductDetailsAsync($productType) result: ${billingResult.responseCode} ${billingResult.debugMessage}")
-            if (result.responseCode == BillingClient.BillingResponseCode.OK) {
+
-                _productDetails.value = detailsList.associateBy { it.productId }
+                val detailsList = queryResult.productDetailsList
-                log("Product details loaded: ${detailsList.size} items")
+                log("Fetched $productType products: ${detailsList?.map { it.productId } ?: emptyList()}")
+
+                if (queryResult.unfetchedProductList.isNotEmpty()) {
+                    logError("Unfetched $productType products: ${queryResult.unfetchedProductList}")
+                }
+
+                if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+                    _productDetails.value = _productDetails.value + (detailsList?.associateBy { it.productId } ?: emptyMap())
+                    log("Product details cache now has: ${_productDetails.value.keys}")
+                }
+            }
+        } catch (t: Throwable) {
+            Log.e("MindMachineBilling", "Exception querying $productType product details", t)
         }
-        })
     }
 
     private fun queryActivePurchases() {
@@ -162,9 +215,11 @@ class BillingManager(
         }
 
         val listener = PurchasesResponseListener { result, purchases ->
-            log("Query purchases result: ${result.responseCode} ${result.debugMessage}")
             if (result.responseCode == BillingClient.BillingResponseCode.OK) {
+                log("Query purchases returned ${purchases.size} items")
                 handlePurchases(purchases)
+            } else {
+                logError("Query purchases failed: ${result.responseCode} ${result.debugMessage}")
             }
         }
 
@@ -179,7 +234,7 @@ class BillingManager(
     }
 
     private fun handlePurchases(purchases: List<Purchase>) {
-        log("handlePurchases() count=${purchases.size}")
+        log("handlePurchases count=${purchases.size}")
         val active = purchases.any { p ->
             p.purchaseState == Purchase.PurchaseState.PURCHASED &&
                 p.products.any { it == BillingProducts.SUB_REMOVE_ADS_MONTHLY || it == BillingProducts.INAPP_REMOVE_ADS_FOREVER }
@@ -199,7 +254,13 @@ class BillingManager(
                 val params = AcknowledgePurchaseParams.newBuilder()
                     .setPurchaseToken(purchase.purchaseToken)
                     .build()
-                billingClient.acknowledgePurchase(params) { /* no-op */ }
+                billingClient.acknowledgePurchase(params) { billingResult ->
+                    if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+                        log("Purchase acknowledged successfully")
+                    } else {
+                        logError("Failed to acknowledge purchase: ${billingResult.responseCode} ${billingResult.debugMessage}")
+                    }
+                }
             }
     }
 }

app/src/main/java/com/mindmachine/mvp/data/SettingsRepository.kt

@@ -20,6 +20,7 @@ class SettingsRepository(private val context: Context) {
         val countdownSeconds = intPreferencesKey("countdown_seconds")
         val forceAudioWithoutHeadphones = booleanPreferencesKey("force_audio_without_headphones")
         val showImmersiveProgressBar = booleanPreferencesKey("show_immersive_progress_bar")
+        val showImmersiveStopButton = booleanPreferencesKey("show_immersive_stop_button")
         val preferLowestRefreshRate = booleanPreferencesKey("prefer_lowest_refresh_rate")
         val monochromeFlashMode = booleanPreferencesKey("monochrome_flash_mode")
         val immersiveBrightnessPercent = intPreferencesKey("immersive_brightness_percent")
@@ -36,6 +37,7 @@ class SettingsRepository(private val context: Context) {
                 ?: 5,
             forceAudioWithoutHeadphones = p[Keys.forceAudioWithoutHeadphones] ?: false,
             showImmersiveProgressBar = p[Keys.showImmersiveProgressBar] ?: true,
+            showImmersiveStopButton = p[Keys.showImmersiveStopButton] ?: true,
             preferLowestRefreshRate = p[Keys.preferLowestRefreshRate] ?: true,
             monochromeFlashMode = p[Keys.monochromeFlashMode] ?: false,
             immersiveBrightnessPercent = (p[Keys.immersiveBrightnessPercent] ?: 50).coerceIn(5, 100),
@@ -58,6 +60,9 @@ class SettingsRepository(private val context: Context) {
             if (prefs[Keys.preferLowestRefreshRate] == null) {
                 prefs[Keys.preferLowestRefreshRate] = true
             }
+            if (prefs[Keys.showImmersiveStopButton] == null) {
+                prefs[Keys.showImmersiveStopButton] = true
+            }
         }
     }
 
@@ -80,6 +85,10 @@ class SettingsRepository(private val context: Context) {
         it[Keys.showImmersiveProgressBar] = value
     }
 
+    suspend fun updateShowImmersiveStopButton(value: Boolean) = context.dataStore.edit {
+        it[Keys.showImmersiveStopButton] = value
+    }
+
     suspend fun updatePreferLowestRefreshRate(value: Boolean) = context.dataStore.edit {
         it[Keys.preferLowestRefreshRate] = value
     }

app/src/main/java/com/mindmachine/mvp/domain/Models.kt

@@ -42,6 +42,7 @@ data class AppSettings(
     val countdownSeconds: Int = 5,
     val forceAudioWithoutHeadphones: Boolean = false,
     val showImmersiveProgressBar: Boolean = true,
+    val showImmersiveStopButton: Boolean = true,
     val preferLowestRefreshRate: Boolean = true,
     val monochromeFlashMode: Boolean = false,
     // Default used only before DataStore emits (and as a fallback).

app/src/main/java/com/mindmachine/mvp/session/FlashSequence.kt

@@ -2,6 +2,7 @@ package solutions.tretter.mindmachine.session
 
 enum class FlashPaletteColor {
     BLACK,
+    WHITE,
     RED,
     GREEN,
     YELLOW,

app/src/main/java/com/mindmachine/mvp/session/FlashSequenceEditor.kt

@@ -164,6 +164,7 @@ private fun FlashPaletteColor.next(): FlashPaletteColor {
 
 private fun FlashPaletteColor.previewColor(): Color = when (this) {
     FlashPaletteColor.BLACK -> Color.Black
+    FlashPaletteColor.WHITE -> Color.White
     FlashPaletteColor.RED -> Color(0xFFD32F2F)
     FlashPaletteColor.GREEN -> Color(0xFF2E7D32)
     FlashPaletteColor.YELLOW -> Color(0xFFF9A825)

app/src/main/java/com/mindmachine/mvp/session/MainViewModel.kt

@@ -304,6 +304,7 @@ class MainViewModel(
         settingsRepository.updateForceAudioWithoutHeadphones(value)
     }
     fun updateShowImmersiveProgressBar(value: Boolean) = viewModelScope.launch { settingsRepository.updateShowImmersiveProgressBar(value) }
+    fun updateShowImmersiveStopButton(value: Boolean) = viewModelScope.launch { settingsRepository.updateShowImmersiveStopButton(value) }
     fun updatePreferLowestRefreshRate(value: Boolean) = viewModelScope.launch { settingsRepository.updatePreferLowestRefreshRate(value) }
     fun updateMonochromeFlashMode(value: Boolean) = viewModelScope.launch { settingsRepository.updateMonochromeFlashMode(value) }
     fun updateImmersiveBrightnessPercent(value: Int) = viewModelScope.launch {

app/src/main/java/com/mindmachine/mvp/session/ParameterRanges.kt

@@ -13,5 +13,5 @@ object ParameterRanges {
     const val CARRIER_HZ_MAX = 1200f
 
     const val BINAURAL_HZ_MIN = 0.5f
-    const val BINAURAL_HZ_MAX = 30f
+    const val BINAURAL_HZ_MAX = 20f
 }

app/src/main/java/com/mindmachine/mvp/session/TimelineEditorScreen.kt

@@ -266,18 +266,28 @@ internal fun TimelineGraph(
             (context as? android.app.Activity)?.window?.decorView?.performHapticFeedback(HapticFeedbackConstants.KEYBOARD_TAP)
         }
 
-        val yLabels = if (isVisual) {
+        // Y-axis labels - dynamic based on which curve is selected. For audio: carrier (left) or binaural (right). For visual: flash interval.
+        val yAxisLabels = if (isVisual) {
             listOf(
                 formatMsLabel(ParameterMapping.logMap01(1f, ParameterRanges.FLASH_INTERVAL_MS_MIN, ParameterRanges.FLASH_INTERVAL_MS_MAX)),
                 formatMsLabel(ParameterMapping.logMap01(0.5f, ParameterRanges.FLASH_INTERVAL_MS_MIN, ParameterRanges.FLASH_INTERVAL_MS_MAX)),
                 formatMsLabel(ParameterMapping.logMap01(0f, ParameterRanges.FLASH_INTERVAL_MS_MIN, ParameterRanges.FLASH_INTERVAL_MS_MAX)),
             )
         } else {
+            // Audio: switch labels based on selected side
+            if (selectedLeft) {
                 listOf(
                     formatHzLabel(ParameterMapping.logMap01(1f, ParameterRanges.CARRIER_HZ_MIN, ParameterRanges.CARRIER_HZ_MAX)),
                     formatHzLabel(ParameterMapping.logMap01(0.5f, ParameterRanges.CARRIER_HZ_MIN, ParameterRanges.CARRIER_HZ_MAX)),
                     formatHzLabel(ParameterMapping.logMap01(0f, ParameterRanges.CARRIER_HZ_MIN, ParameterRanges.CARRIER_HZ_MAX)),
                 )
+            } else {
+                listOf(
+                    formatHzLabel(ParameterMapping.logMap01(1f, ParameterRanges.BINAURAL_HZ_MIN, ParameterRanges.BINAURAL_HZ_MAX)),
+                    formatHzLabel(ParameterMapping.logMap01(0.5f, ParameterRanges.BINAURAL_HZ_MIN, ParameterRanges.BINAURAL_HZ_MAX)),
+                    formatHzLabel(ParameterMapping.logMap01(0f, ParameterRanges.BINAURAL_HZ_MIN, ParameterRanges.BINAURAL_HZ_MAX)),
+                )
+            }
         }
         val xStart = formatTimeLabel(viewport.startSec)
         val xMid = formatTimeLabel(viewport.startSec + viewport.secondsPerScreen / 2f)
@@ -288,12 +298,13 @@ internal fun TimelineGraph(
             horizontalArrangement = Arrangement.spacedBy(8.dp),
             verticalAlignment = Alignment.CenterVertically,
         ) {
+            // Left Y-axis labels
             Column(
                 modifier = Modifier.height(190.dp).width(48.dp),
                 verticalArrangement = Arrangement.SpaceBetween,
                 horizontalAlignment = Alignment.End,
             ) {
-                yLabels.forEach { label ->
+                yAxisLabels.forEach { label ->
                     Text(
                         text = label,
                         color = MaterialTheme.colorScheme.onSurface.copy(alpha = 0.75f),
@@ -414,7 +425,7 @@ internal fun TimelineGraph(
                                             height = h,
                                             curveId = curveId,
                                         )
-                                        val updated = targetCurve.movePointVerticalWithPropagation(pointIndex, constrainedY, h)
+                                        val updated = targetCurve.movePointVertical(pointIndex, constrainedY, h)
                                         if (curveId == leftId) curveLeft = updated else curveRight = updated
                                         currentOnUpdateCurve(curveId, updated)
                                         onCurveEditedHaptic()

app/src/main/java/com/mindmachine/mvp/session/TimelineParameters.kt

@@ -35,7 +35,7 @@ object TimelineParameters {
         ParameterId.BRIGHTNESS to Range(min = 0.0001f, max = 1.0f, logScale = true, units = "%"),
         ParameterId.BLINK_RATE to Range(min = 0.1f, max = 30f, logScale = true, units = "Hz"),
         ParameterId.CARRIER_FREQUENCY to Range(min = 200f, max = 1200f, logScale = true, units = "Hz"),
-        ParameterId.BINAURAL_BEAT to Range(min = 0.5f, max = 30f, logScale = true, units = "Hz"),
+        ParameterId.BINAURAL_BEAT to Range(min = 0.5f, max = 20f, logScale = true, units = "Hz"),
     )
 
     fun parameterForCurve(curve: TimelineEditorState.ActiveCurve): ParameterId {

build.gradle.kts

@@ -1,5 +1,6 @@
 plugins {
-    id("com.android.application") version "8.5.2" apply false
+    id("com.android.application") version "8.10.0" apply false
-    id("org.jetbrains.kotlin.android") version "1.9.24" apply false
+    id("org.jetbrains.kotlin.android") version "2.1.0" apply false
-    id("org.jetbrains.kotlin.plugin.serialization") version "1.9.24" apply false
+    id("org.jetbrains.kotlin.plugin.serialization") version "2.1.0" apply false
+    id("org.jetbrains.kotlin.plugin.compose") version "2.1.0" apply false
 }

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME