From ab96a78ec0c311c9ea1d37493b22f7561012f4a3 Mon Sep 17 00:00:00 2001
From: NITISH-R-G <nitishrg.8220psgps2020@gmail.com>
Date: Fri, 31 Jul 2026 18:25:47 +0530
Subject: [PATCH] Explain the accessibility permission before sending the user
 to Settings

The audit's single biggest UX finding: BIND_ACCESSIBILITY_SERVICE is the
scariest permission dialog on Android, the OS prompt explains nothing, and a
first-time user has every reason to bail right there before ever seeing the
product work.

Tapping "Turn on ScreenSaathi screen reader" now shows a plain-language
dialog first - what it reads (foreground screen, as text, never a
screenshot, never background apps), where it goes (Sarvam's cloud service),
and where to find the full accounting (docs/DATA_HANDLING.md) - before
handing off to Settings. The user can back out with "Not now" with nothing
granted.

This is disclosure at the point of decision, not after it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 .../java/com/screensaathi/MainActivity.kt     | 31 ++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/app/src/main/java/com/screensaathi/MainActivity.kt b/app/src/main/java/com/screensaathi/MainActivity.kt
index d97e3a0..21ad91a 100644
--- a/app/src/main/java/com/screensaathi/MainActivity.kt
+++ b/app/src/main/java/com/screensaathi/MainActivity.kt
@@ -12,6 +12,7 @@ import android.text.TextUtils
 import android.view.accessibility.AccessibilityManager
 import android.widget.Button
 import android.widget.TextView
+import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
@@ -53,7 +54,7 @@ class MainActivity : AppCompatActivity() {
         }
 
         findViewById<Button>(R.id.btn_accessibility).setOnClickListener {
-            startActivity(Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS))
+            explainAccessibilityThenOpenSettings()
         }
 
         findViewById<Button>(R.id.btn_start).setOnClickListener {
@@ -117,6 +118,34 @@ class MainActivity : AppCompatActivity() {
         finish()
     }
 
+    /**
+     * `BIND_ACCESSIBILITY_SERVICE` is the single scariest permission dialog on
+     * Android, and the OS prompt explains none of it — the audit that flagged
+     * this called it out as the single biggest reason a first-time user quits
+     * before ever seeing the product work. This dialog is the one screen
+     * between "unexplained scary permission" and an informed decision; the
+     * full accounting lives in docs/DATA_HANDLING.md if that's not enough.
+     */
+    private fun explainAccessibilityThenOpenSettings() {
+        AlertDialog.Builder(this)
+            .setTitle("Why ScreenSaathi needs this")
+            .setMessage(
+                "This lets the app read the text and layout of the screen " +
+                    "you're currently looking at, so it can point at the right " +
+                    "field and button.\n\n" +
+                    "It reads the foreground app only, as text — never a " +
+                    "screenshot, never other apps in the background. That text " +
+                    "is sent to Sarvam's cloud service to decide what to say next.\n\n" +
+                    "On the next screen, find ScreenSaathi under Downloaded " +
+                    "apps or Installed apps and turn it on."
+            )
+            .setPositiveButton("Continue") { _, _ ->
+                startActivity(Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS))
+            }
+            .setNegativeButton("Not now", null)
+            .show()
+    }
+
     private fun refreshStatus() {
         val overlay = if (Settings.canDrawOverlays(this)) "✓" else "✗"
         val mic = if (hasMic()) "✓" else "✗"