feat: Introduce QuickLens 1.0 with comprehensive documentation, target SDK 36, and accessibility service refactor.

Author: quantavil

README.md

@@ -1,34 +1,136 @@
 # QuickLens 🔍
 
-**QuickLens** involves a "Circle to Search" experience for any Android device. It allows you to instantly search anything on your screen using multiple search engines.
+**QuickLens** brings a "Circle to Search" experience to any Android device. Instantly search anything on your screen using multiple search engines — just like the flagship feature on premium devices, but available everywhere.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Version-1.0-blue?style=for-the-badge" alt="Version 1.0">
+  <img src="https://img.shields.io/badge/Min%20SDK-29-green?style=for-the-badge" alt="Min SDK 29">
+  <img src="https://img.shields.io/badge/Target%20SDK-36-orange?style=for-the-badge" alt="Target SDK 36">
+  <img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="MIT License">
+</p>
+
+---
 
 ## ✨ Features
 
-- **Circle to Search**: Trigger via accessibility shortcut, crop any part of your screen, and search instantly.
-- **Multi-Engine Support**: Seamlessly switch between Google Lens, Bing, and Yandex.
-- **Smart History**: Keeps track of your searches with visual snapshots.
-- **Customizable UI**:
-    - **Premium Aesthetics**: Beautiful "Electric Violet" gradient overlays.
-    - **Dark Mode**: Fully supported.
-    - **Floating Bubble**: Optional floating trigger for easier access.
-- **Privacy Focused**: No data collection, everything stays on your device or goes directly to the search provider.
+### 🎯 Trigger Methods
+- **Default Assistant Gesture** — Long-press the Home button or swipe diagonally from corners to instantly capture and search
+- **Floating Bubble** — Optional draggable trigger bubble for one-tap access (opt-in)
+
+### 🔎 Search Capabilities
+- **Multi-Engine Support** — Seamlessly switch between Google Lens, Bing, and Yandex
+- **Crop & Search** — Select any region of your screenshot to search
+- **Visual Search** — Upload cropped images directly to reverse image search
+
+### 🎨 Customization
+- **Theme Options** — System, Light, and Dark modes
+- **Desktop Mode** — Request desktop versions of search results
+- **Open Links Externally** — Choose to open results in your default browser
+- **Auto-clear History** — Configure automatic history cleanup (Never, 1/7/15/30 days)
+
+### 📱 Smart History
+- Visual snapshots of all your searches
+- Searchable history with timestamps
+- One-tap to re-open previous searches
+
+### 🔒 Privacy First
+- **No data collection** — Everything stays on your device
+- **No background processing** — App only activates on explicit user action
+- **Direct to provider** — Search queries go directly to the search engine
+
+---
 
 ## 🚀 Getting Started
 
-1. **Install the APK**.
-2. **Grant Accessibility Permission**: Required to capture the screen and draw the overlay.
-3. **Double Tap Status Bar** (or use the Floating Bubble) to start searching!
+### Prerequisites
+- Android 10+ (API 29)
+- ~2.5 MB storage space
+
+### Installation
+
+1. **Download** the latest APK from [Releases](../../releases)
+2. **Install** the APK on your device
+3. **Enable Accessibility Service**
+   - Open QuickLens → Tap "Enable Accessibility"
+   - Find QuickLens in the list and enable it
+4. **Set as Default Assistant**
+   - Open QuickLens → Tap "Enable Trigger (Default Assistant)"
+   - Select QuickLens as your digital assistant app
+5. **Start Searching!**
+   - Long-press Home button or swipe diagonally from screen corners
+
+---
+
+## 🎮 How to Use
+
+| Action | Trigger |
+|--------|---------|
+| **Capture Screen** | Long-press Home / Swipe diagonal |
+| **Crop Selection** | Drag on screenshot to select area |
+| **Switch Engine** | Tap engine buttons (Lens/Bing/Yandex) |
+| **View History** | Tap History icon in app |
+| **Close Overlay** | Tap outside the result sheet or swipe down |
+
+---
 
 ## 🛠️ Built With
 
-- **Kotlin** & **Jetpack Compose** - Modern Android UI toolkit.
-- **Coroutines** - Asynchronous programming.
-- **Room Database** - Local history storage.
+| Technology | Purpose |
+|------------|---------|
+| **Kotlin** | Primary language |
+| **Jetpack Compose** | Modern declarative UI |
+| **Material 3** | Design system |
+| **Room Database** | Local history storage |
+| **Coroutines** | Async operations |
+| **VoiceInteractionService** | Assistant trigger integration |
+| **AccessibilityService** | Screen capture capability |
+
+
+---
+
+## 🔧 Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/quantavil/QuickLens.git
+cd QuickLens
+
+# Build debug APK
+./gradlew assembleDebug
+
+# Build release APK
+./gradlew assembleRelease
+```
+
+The release APK will be at: `app/build/outputs/apk/release/app-release.apk`
+
+---
 
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+---
+
 ## 📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Inspired by Google's Circle to Search feature
+- Built with ❤️ using Jetpack Compose
+
+---
+
+<p align="center">
+  <b>QuickLens</b> — Search anything, anywhere, instantly.
+</p>

app/build.gradle.kts

@@ -16,8 +16,8 @@ android {
         applicationId = "com.quantavil.quicklens"
         minSdk = 29
         targetSdk = 36
-        versionCode = 9
-        versionName = "1.8"
+        versionCode = 10
+        versionName = "1.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
@@ -68,7 +68,6 @@ dependencies {
     androidTestImplementation(libs.androidx.compose.ui.test.junit4)
     debugImplementation(libs.androidx.compose.ui.tooling)
     debugImplementation(libs.androidx.compose.ui.test.manifest)
-    debugImplementation(libs.androidx.compose.ui.test.manifest)
     // implementation("androidx.compose.material:material-icons-extended") // Removed to save size
     implementation("androidx.compose.material:material-icons-core")
     implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")

app/src/main/java/com/quantavil/quicklens/QuickLensAccessibilityService.kt

@@ -226,34 +226,24 @@ class QuickLensAccessibilityService : AccessibilityService() {
     override fun onInterrupt() {}
 
     companion object {
-        private var instance: QuickLensAccessibilityService? = null
         var isOverlayActive: Boolean = false
         const val ACTION_TRIGGER_CAPTURE = "com.quantavil.quicklens.ACTION_TRIGGER_CAPTURE"
-
-        fun triggerCapture() {
-            instance?.performCapture()
-        }
 
         fun onOverlayClosed() {
             isOverlayActive = false
         }
     }
 
-    override fun onCreate() {
-        super.onCreate()
-        instance = this
-    }
+
 
     override fun onDestroy() {
         super.onDestroy()
-        instance = null
         try {
             unregisterReceiver(captureReceiver)
         } catch (e: Exception) {
             // Receiver may not be registered
         }
         prefs.unregisterOnSharedPreferenceChangeListener(prefsListener)
-        // triggerView cleanup removed
         hideBubble()
     }
 }

app/src/main/java/com/quantavil/quicklens/utils/UIPreferences.kt

@@ -48,7 +48,7 @@ class UIPreferences(context: Context) {
     }
 
     fun isBubbleEnabled(): Boolean {
-        return prefs.getBoolean(KEY_BUBBLE_ENABLED, true)
+        return prefs.getBoolean(KEY_BUBBLE_ENABLED, false)
     }
 
     fun setBubbleEnabled(isEnabled: Boolean) {

app/src/main/res/xml/accessibility_service_config.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
-    android:accessibilityEventTypes="typeAllMask"
+    android:accessibilityEventTypes="typeWindowStateChanged"
     android:accessibilityFeedbackType="feedbackGeneric"
     android:accessibilityFlags="flagDefault|flagRetrieveInteractiveWindows|flagIncludeNotImportantViews|flagRequestFilterKeyEvents"
     android:canRetrieveWindowContent="true"