From 5d353aa3bd83f05bfc0709eb6e3d003479c5e2c9 Mon Sep 17 00:00:00 2001
From: Narasimha-sc <166327228+Narasimha-sc@users.noreply.github.com>
Date: Thu, 22 Oct 2026 19:45:43 +0000
Subject: [PATCH] ci: list the ui-tests workflow in the app tests README

---
 scripts/ci/README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/scripts/ci/README.md b/scripts/ci/README.md
index 7034ea8e7e..b27f1cbd59 100644
--- a/scripts/ci/README.md
+++ b/scripts/ci/README.md
@@ -2,6 +2,15 @@
 
 Three workflows build the apps from a branch's own code and test them, only when asked: `ios-sim` (the iOS app in a simulator on a macOS runner), `desktop-linux` (the desktop app on a Linux runner) and `android-emu` (the Android app in an emulator on a Linux runner). Each runs a scripted smoke test and, on request, a Claude session that follows a test plan, and a test backend (relay, directory, names server, peers). Details: [iOS](ios-sim/README.md), [desktop](desktop-linux/README.md), [Android](android/README.md).
 
+## UI tests
+
+`ui-tests` runs the Compose UI tests (`apps/multiplatform/common/src/uiTestShared`, desktop and Android) with `apps/multiplatform/scripts/uitest.sh` and `uitest-android.sh`: the desktop tests on the runner, the Android tests in android-emu's emulator, each platform in four parallel jobs. It is started by hand like the others, and reuses the core libraries that `desktop-linux` and `android-emu` built on the branch, and they its own. Details: [UI tests](ui-tests/README.md).
+
+```sh
+gh workflow run ui-tests.yml --ref <branch> -f platform=both
+gh workflow run ui-tests.yml --ref <branch> -f platform=android -f tests=chat.simplex.app.ui.main.ChatListRowsTest
+```
+
 ## Starting a run
 
 Pushes start nothing: a run is started by hand, on any branch, with inputs that are off by default and combine.