test(maestro): working E2E suite (iOS FlipcashUITests parity) + central tagging + beta-flag launch hook

.github/workflows/maestro.yml

@@ -0,0 +1,104 @@
+name: Maestro E2E
+
+# Real-backend E2E against the shared test account, so it is not wired to every PR by
+# default: run it on demand (choose tags) and nightly (smoke). To gate PRs, add a
+# `pull_request:` trigger below — note it needs the test-account secrets, so it won't run
+# on fork PRs.
+on:
+  workflow_dispatch:
+    inputs:
+      tags:
+        description: "Maestro include-tags (e.g. smoke, tipping, gate)"
+        default: "smoke"
+      exclude_tags:
+        description: "Maestro exclude-tags (side-effecting flows excluded by default)"
+        default: "spends-funds,creates-account"
+  schedule:
+    - cron: "37 7 * * *" # nightly, off the top of the hour
+
+concurrency:
+  group: maestro-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  maestro:
+    name: Maestro E2E (${{ github.event.inputs.tags || 'smoke' }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Setup Java env
+        uses: actions/setup-java@v3
+        with:
+          java-version: "21"
+          distribution: "corretto"
+          cache: "gradle"
+
+      - name: Setup Ruby env
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7.2
+          bundler-cache: true
+
+      # Build prerequisites (same as the unit-test CI job).
+      - name: Decode Google Services JSON file
+        uses: timheuer/base64-to-file@v1
+        with:
+          fileName: google-services.json
+          fileDir: ./apps/flipcash/app/src
+          encodedString: ${{ secrets.FLIPCASH2_GOOGLE_SERVICES }}
+      - name: Setup local.properties API keys
+        run: |
+          {
+            echo "BUGSNAG_API_KEY=\"${{ secrets.FLIPCASH_BUGSNAG_API_KEY }}\""
+            echo "MIXPANEL_API_KEY=\"${{ secrets.FLIPCASH_MIXPANEL_API_KEY }}\""
+            echo "COINBASE_ONRAMP_API_KEY=${{ secrets.COINBASE_ONRAMP_API_KEY }}"
+            echo "GOOGLE_CLOUD_PROJECT_NUMBER=${{ secrets.GOOGLE_CLOUD_PROJECT_NUMBER }}"
+          } >> ./local.properties
+
+      - name: Install Maestro CLI
+        run: |
+          curl -fsSL "https://get.maestro.mobile.dev" | bash
+          echo "$HOME/.maestro/bin" >> "$GITHUB_PATH"
+
+      # KVM is required for a fast x86_64 emulator on GitHub-hosted Linux runners.
+      - name: Enable KVM
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' \
+            | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules
+          sudo udevadm trigger --name-match=kvm
+
+      - name: Run Maestro suite on emulator
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          profile: pixel_6
+          force-avd-creation: false
+          emulator-options: -no-window -gpu swiftshader_indirect -no-snapshot -noaudio -no-boot-anim
+          disable-animations: true
+          script: bundle exec fastlane android flipcash_maestro
+        env:
+          MAESTRO_TAGS: ${{ github.event.inputs.tags || 'smoke' }}
+          MAESTRO_EXCLUDE_TAGS: ${{ github.event.inputs.exclude_tags || 'spends-funds,creates-account' }}
+          # Test-account credentials (map GitHub secrets -> the env vars run.sh reads).
+          SEED_PHRASE: ${{ secrets.MAESTRO_SEED_PHRASE }}
+          LOGIN_DEEPLINK: ${{ secrets.MAESTRO_LOGIN_DEEPLINK }}
+          TIPCARD_DEEPLINK: ${{ secrets.MAESTRO_TIPCARD_DEEPLINK }}
+          USDF_ONLY_DEEPLINK: ${{ secrets.MAESTRO_USDF_ONLY_DEEPLINK }}
+          CONTACT_NAME: ${{ secrets.MAESTRO_CONTACT_NAME }}
+          CONTACT_PHONE: ${{ secrets.MAESTRO_CONTACT_PHONE }}
+
+      - name: Upload Maestro report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: maestro-report
+          path: |
+            maestro-report.xml
+            ~/.maestro/tests/**
+          if-no-files-found: ignore

apps/flipcash/app/src/main/kotlin/com/flipcash/app/MainActivity.kt

@@ -29,6 +29,7 @@ import com.flipcash.app.core.verification.email.EmailCodeChannel
 import com.flipcash.app.core.verification.email.LocalEmailCodeChannel
 import com.flipcash.app.onramp.LocalCoinbaseOnRampController
 import com.flipcash.app.onramp.CoinbaseOnRampController
+import com.flipcash.app.featureflags.FeatureFlag
 import com.flipcash.app.featureflags.FeatureFlagController
 import com.flipcash.app.featureflags.LocalFeatureFlags
 import com.flipcash.app.internal.ui.App
@@ -151,6 +152,8 @@ class MainActivity : FragmentActivity() {
         // the UI thread building the country list.
         lifecycleScope.launch(Dispatchers.Default) { phoneUtils.ensureLoaded() }
 
+        applyBetaFlagLaunchOverrides()
+
         setContent {
             CompositionLocalProvider(
                 LocalResources provides resources,
@@ -187,8 +190,33 @@ class MainActivity : FragmentActivity() {
         }
     }
 
+    /**
+     * Test-only: enable beta flags passed as a launch argument, so flag-gated features
+     * (tipping, blocklist, …) can be exercised in UI tests without toggling them in the
+     * Labs UI. Mirrors iOS's `--beta-flags`. Debug/UI-test builds only.
+     *
+     *   launchApp:
+     *     arguments:
+     *       betaFlags: "tipping_enabled,blocklist_enabled"
+     *
+     * The value is a comma-separated list of [FeatureFlag.key]s.
+     */
+    private fun applyBetaFlagLaunchOverrides() {
+        if (!BuildConfig.UI_TESTABLE) return
+        intent.getStringExtra(BETA_FLAGS)
+            .orEmpty()
+            .split(",")
+            .map { it.trim() }
+            .filter { it.isNotEmpty() }
+            .forEach { key ->
+                FeatureFlag.entries.firstOrNull { it.key == key }
+                    ?.let { featureFlagController.set(it, true) }
+            }
+    }
+
     companion object {
         private const val UI_TEST = "isUiTest"
+        private const val BETA_FLAGS = "betaFlags"
     }
 }
 

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt

@@ -92,7 +92,8 @@ fun appEntryProvider(
     annotatedEntry<AppRoute.Main.InviteContact> { key -> InviteContactScreen(key.phoneNumber) }
 
     // Sheets (inner content — wrapped in Main.Sheet by navigateTo())
-    annotatedEntry<AppRoute.Sheets.Give> { key -> CashScreen(key.mint, key.fromTokenInfo) }
+    // Route type is `Give` but the screen is the Cash/Give screen the flows call cash_screen.
+    annotatedEntry<AppRoute.Sheets.Give>(testTag = "cash_screen") { key -> CashScreen(key.mint, key.fromTokenInfo) }
     annotatedEntry<AppRoute.Sheets.Send> { SendFlowScreen(resultStateRegistry = resultStateRegistry) }
     annotatedEntry<AppRoute.Sheets.Tips> { key ->
         TippingFlowScreen(route = key, resultStateRegistry = resultStateRegistry)
@@ -109,10 +110,12 @@ fun appEntryProvider(
     }
 
     // Tokens
-    annotatedEntry<AppRoute.Token.Info> { key ->
+    annotatedEntry<AppRoute.Token.Info>(testTag = "token_info_screen") { key ->
         TokenInfoScreen(key.mint, key.shortfall, key.fromDeeplink)
     }
-    annotatedEntry<AppRoute.Token.Transactions> { key -> TransactionHistoryScreen(key.mint) }
+    annotatedEntry<AppRoute.Token.Transactions>(testTag = "transaction_history_screen") { key ->
+        TransactionHistoryScreen(key.mint)
+    }
     annotatedEntry<AppRoute.Token.Swap> { key ->
         SwapFlowScreen(route = key, resultStateRegistry = resultStateRegistry)
     }

apps/flipcash/features/login/src/main/kotlin/com/flipcash/app/login/OnboardingFlowScreen.kt

@@ -253,7 +253,9 @@ internal fun resolvePostAccountRoute(
 private fun onboardingEntryProvider(
     route: AppRoute.OnboardingFlow,
 ): (NavKey) -> NavEntry<NavKey> = entryProvider {
-    annotatedEntry<OnboardingStep.Start> { step ->
+    // The pre-login landing; flows/screenshots anchor on `login_screen` rather than
+    // the step-derived `start_screen`.
+    annotatedEntry<OnboardingStep.Start>(testTag = "login_screen") { step ->
         LoginStepContent(step.seed)
     }
     annotatedEntry<OnboardingStep.SeedInput> {

apps/flipcash/features/messenger/src/main/kotlin/com/flipcash/app/messenger/internal/screens/MessengerScreen.kt

@@ -114,8 +114,7 @@ private fun ChatInputScaffold(
     // which made the message list visibly jump on every open and every pop-back.
     SubcomposeLayout(
         modifier = Modifier
-            .imePadding()
-            .testTag("chat_screen"),
+            .imePadding(),
     ) { constraints ->
         val looseConstraints = constraints.copy(minWidth = 0, minHeight = 0)
 

apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/internal/TokenInfoScreen.kt

@@ -24,7 +24,6 @@ import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
-import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.StrokeCap
 import androidx.compose.ui.res.painterResource
@@ -84,7 +83,6 @@ private fun TokenInfoScreen(
             LazyColumn(
                 modifier = Modifier
                     .fillMaxSize()
-                    .testTag("token_info_screen")
                     .padding(
                         start = innerPadding.calculateStartPadding(),
                         end = innerPadding.calculateEndPadding(),

apps/flipcash/features/withdrawal/src/main/kotlin/com/flipcash/app/withdrawal/WithdrawalFlowScreen.kt

@@ -90,13 +90,15 @@ private fun withdrawalEntryProvider(
     annotatedEntry<WithdrawalStep.SelectToken> {
         WithdrawalSelectTokenScreen()
     }
-    annotatedEntry<WithdrawalStep.Amount> { step ->
+    // Explicit tags: step names (Amount/Destination/Confirmation) are generic and collide
+    // with other flows' steps, so give the E2E-targeted steps stable, unambiguous ids.
+    annotatedEntry<WithdrawalStep.Amount>(testTag = "withdraw_entry_screen") { step ->
         WithdrawalEntryScreen(step.mint)
     }
-    annotatedEntry<WithdrawalStep.Destination> {
+    annotatedEntry<WithdrawalStep.Destination>(testTag = "withdraw_destination_screen") {
         WithdrawalDestinationScreen()
     }
-    annotatedEntry<WithdrawalStep.Confirmation> {
+    annotatedEntry<WithdrawalStep.Confirmation>(testTag = "withdraw_confirmation_screen") {
         WithdrawalConfirmationScreen()
     }
 }

apps/flipcash/shared/funding/src/main/kotlin/com/flipcash/app/funding/internal/Buttons.kt

@@ -51,6 +51,7 @@ internal fun purchaseOptions(
                     width = 150.sp,
                     height = 20.sp,
                     tintIcon = false,
+                    testTag = "purchase_method_coinbase",
                     onClick = { onClick(PurchaseMethod.CoinbaseOnRamp) }
                 )
             )
@@ -76,6 +77,7 @@ internal fun purchaseOptions(
                 suffix = resources.getString(R.string.label_phantom),
                 iconPadding = { PaddingValues() },
                 iconRes = R.drawable.ic_phantom_wallet,
+                testTag = "purchase_method_phantom",
                 onClick = { onClick(PurchaseMethod.PhantomWallet) }
             )
         )
@@ -84,6 +86,7 @@ internal fun purchaseOptions(
             add(
                 BottomBarAction(
                     text = resources.getString(R.string.title_onrampProviderOtherWallet),
+                    testTag = "purchase_method_other_wallet",
                     onClick = { onClick(PurchaseMethod.OtherWallet) }
                 )
             )
@@ -111,9 +114,11 @@ private fun buildButtonAction(
         )
     },
     tintIcon: Boolean = true,
+    testTag: String? = null,
     onClick: () -> Unit
 ): BottomBarAction {
     return BottomBarAction(
+        testTag = testTag,
         text = buildAnnotatedString {
             if (prefix != null) {
                 append(prefix)

fastlane/Fastfile

@@ -26,6 +26,17 @@ platform :android do
       )
     end
 
+  desc "Run the Maestro E2E suite on a booted emulator (default tag: smoke)"
+    # Installs the debug build, then runs maestro/run.sh in tag mode. Test-account
+    # creds come from the environment (SEED_PHRASE, LOGIN_DEEPLINK, TIPCARD_DEEPLINK,
+    # USDF_ONLY_DEEPLINK, CONTACT_NAME, CONTACT_PHONE) — supplied by CI secrets or
+    # maestro/.env locally. Filter with MAESTRO_TAGS / MAESTRO_EXCLUDE_TAGS.
+    lane :flipcash_maestro do
+      gradle(task: ":apps:flipcash:app:installDebug")
+      tags = ENV.fetch("MAESTRO_TAGS", "smoke")
+      sh("cd .. && maestro/run.sh --tags #{tags.shellescape}")
+    end
+
 desc "Build a new version of Flipcash"
     lane :build_flipcash do
       gradle(

libs/messaging/src/main/kotlin/com/getcode/manager/BottomBarManager.kt

@@ -12,20 +12,24 @@ data class BottomBarAction(
     val style: BottomBarManager.BottomBarButtonStyle = BottomBarManager.BottomBarButtonStyle.Filled,
     val isUser: Boolean = true,
     val enabled: Boolean = true,
+    // Optional UI-test anchor; surfaced as a resource-id when testTagsAsResourceId is on.
+    val testTag: String? = null,
     val onClick: () -> Unit = { }
 ) {
     constructor(
         text: String,
         style: BottomBarManager.BottomBarButtonStyle = BottomBarManager.BottomBarButtonStyle.Filled,
         isUser: Boolean = true,
         enabled: Boolean = true,
+        testTag: String? = null,
         onClick: () -> Unit = { }
     ) : this(
         text = AnnotatedString(text),
         inlineContentMap = emptyMap(),
         style = style,
         isUser = isUser,
         enabled = enabled,
+        testTag = testTag,
         onClick = onClick
     )