Implement plug-and-play debug drawer integration

🚀 MAJOR ENHANCEMENT: True Plug-and-Play Integration

✨ What's New:
- DebugDrawerApplication: Extend instead of Application for auto-setup
- Gesture-based activation: Long press or double tap anywhere to open
- Zero MainActivity code required: No manual setup needed
- Auto-initialization: Works across all activities automatically
- DebugDrawerUtils: Simple static methods for manual control

🔧 New Classes:
- DebugDrawerAutoSetup: Handles automatic initialization and module registration
- DebugDrawerInitializer: Annotation-based setup detection
- DebugDrawerApplication: Base Application class with auto-setup
- DebugDrawerUtils: Static utility methods for manual control
- @EnableDebugDrawer: Annotation for automatic setup

📱 Developer Experience Revolution:
- Before: 6+ @Inject declarations + manual setup + cleanup
- After: 1 line: extend DebugDrawerApplication
- Gesture activation: No button required
- Auto-cleanup: No manual lifecycle management
- Zero boilerplate: True plug-and-play experience

🎯 Integration Examples:
- Super Simple: Extend DebugDrawerApplication
- Advanced: Use DebugDrawerInitializer manually
- Manual Control: Use DebugDrawerUtils static methods

📚 Updated README with comprehensive examples and comparison table

Author: mabualzait

README.md

@@ -126,8 +126,9 @@ For contributing or custom modifications:
 
 ### 2. Setup
 
-#### **Prerequisites**
-Ensure you have Hilt set up in your project. If not, add to your `build.gradle.kts`:
+#### **🚀 Super Simple Integration (Recommended)**
+
+**Step 1:** Add Hilt to your project (if not already added):
 ```kotlin
 plugins {
     id("com.google.dagger.hilt.android")
@@ -140,70 +141,96 @@ dependencies {
 }
 ```
 
-#### **Application Setup**
+**Step 2:** Update your Application class:
 ```kotlin
 @HiltAndroidApp
-class MyApplication : Application() {
-    @Inject
-    lateinit var debugDrawer: com.abualzait.debugdrawer.DebugDrawer
-
-    override fun onCreate() {
-        super.onCreate()
-        // Debug drawer auto-initializes when first accessed
-    }
+class MyApplication : com.abualzait.debugdrawer.DebugDrawerApplication() {
+    // That's it! No additional code needed!
 }
 ```
 
-#### **Activity Integration**
+**Step 3:** Your MainActivity requires ZERO debug drawer code:
 ```kotlin
 @AndroidEntryPoint
 class MainActivity : AppCompatActivity() {
-    
-    @Inject lateinit var debugDrawer: com.abualzait.debugdrawer.DebugDrawer
-    @Inject lateinit var appInfoModule: com.abualzait.debugdrawer.modules.AppInfoModule
-    @Inject lateinit var networkModule: com.abualzait.debugdrawer.modules.NetworkModule
-    @Inject lateinit var logsModule: com.abualzait.debugdrawer.modules.LogsModule
-    @Inject lateinit var featureFlagsModule: com.abualzait.debugdrawer.modules.FeatureFlagsModule
-    @Inject lateinit var settingsModule: com.abualzait.debugdrawer.modules.SettingsModule
-    @Inject lateinit var clipboardModule: com.abualzait.debugdrawer.modules.ClipboardModule
-
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
-        setupDebugDrawer()
+        // No debug drawer setup needed!
     }
-    
-    private fun setupDebugDrawer() {
-        debugDrawer.initialize(this)
-        
-        // Add modules (pick only what you need)
-        debugDrawer.addModule(appInfoModule)
-        debugDrawer.addModule(networkModule)
-        debugDrawer.addModule(logsModule)
-        debugDrawer.addModule(featureFlagsModule)
-        debugDrawer.addModule(settingsModule)
-        debugDrawer.addModule(clipboardModule)
-        
-        // Add toggle button
-        findViewById<Button>(R.id.btn_toggle_debug)?.setOnClickListener {
-            debugDrawer.toggle()
-        }
+}
+```
+
+**🎉 Done!** The debug drawer is now automatically available with:
+- **Gesture activation:** Long press or double tap anywhere on screen
+- **All modules included:** App info, network monitoring, logcat, feature flags, settings, clipboard
+- **Auto-initialization:** Works across all activities
+- **Zero boilerplate:** No manual setup required
+
+#### **✨ What Changed - Developer Experience Revolution**
+
+| **Before (Old Way)** | **After (New Way)** |
+|---------------------|-------------------|
+| ❌ 6+ @Inject declarations | ✅ 0 declarations needed |
+| ❌ Manual initialization | ✅ Automatic initialization |
+| ❌ Manual module registration | ✅ Auto-registered modules |
+| ❌ Manual cleanup in onDestroy | ✅ Automatic cleanup |
+| ❌ 20+ lines of setup code | ✅ 1 line: extend DebugDrawerApplication |
+| ❌ Button required for activation | ✅ Gesture-based activation |
+| ❌ Complex integration | ✅ True plug-and-play |
+
+#### **🔧 Advanced Integration (Optional)**
+
+If you need custom control, you can still use the traditional approach:
+
+```kotlin
+@HiltAndroidApp
+class MyApplication : Application() {
+    @Inject
+    lateinit var debugDrawerInitializer: com.abualzait.debugdrawer.DebugDrawerInitializer
+
+    override fun onCreate() {
+        super.onCreate()
+        debugDrawerInitializer.initializeIfEnabled(this)
     }
 }
 ```
 
+#### **🎮 Manual Control (When Needed)**
+
+```kotlin
+// Show/hide programmatically
+com.abualzait.debugdrawer.DebugDrawerUtils.toggle(context)
+com.abualzait.debugdrawer.DebugDrawerUtils.show(context)
+com.abualzait.debugdrawer.DebugDrawerUtils.hide(context)
+
+// Check visibility
+val isVisible = com.abualzait.debugdrawer.DebugDrawerUtils.isVisible(context)
+```
+
 ### 3. Usage
 
-#### **Opening the Debug Drawer**
+#### **🎮 Activation Methods**
+
+**Automatic Gestures (Zero Code Required):**
+- **Long press** anywhere on the screen
+- **Double tap** anywhere on the screen
+
+**Programmatic Control (When Needed):**
 ```kotlin
-// Programmatically
-debugDrawer.toggle()  // Show/hide
-debugDrawer.show()    // Show only
-debugDrawer.hide()    // Hide only
+// Show/hide programmatically
+com.abualzait.debugdrawer.DebugDrawerUtils.toggle(context)
+com.abualzait.debugdrawer.DebugDrawerUtils.show(context)
+com.abualzait.debugdrawer.DebugDrawerUtils.hide(context)
+
+// Check visibility
+val isVisible = com.abualzait.debugdrawer.DebugDrawerUtils.isVisible(context)
+```
 
-// Via UI button
+**UI Button (Optional):**
+```kotlin
 findViewById<Button>(R.id.btn_toggle_debug)?.setOnClickListener {
-    debugDrawer.toggle()
+    com.abualzait.debugdrawer.DebugDrawerUtils.toggle(this)
 }
 ```
 

debugdrawer/src/main/java/com/abualzait/debugdrawer/DebugDrawer.kt

@@ -115,12 +115,12 @@ internal class DebugOverlay(
     private var currentModule: DebugModule? = null
     private var moduleAdapter: DebugModuleAdapter? = null
 
-    fun addModule(module: DebugModule) {
+    fun addModule(_module: DebugModule) {
         // Module will be added to the adapter when it's shown
         moduleAdapter?.notifyDataSetChanged()
     }
 
-    fun removeModule(module: DebugModule) {
+    fun removeModule(_module: DebugModule) {
         // Module will be removed from the adapter when it's shown
         moduleAdapter?.notifyDataSetChanged()
     }

debugdrawer/src/main/java/com/abualzait/debugdrawer/DebugDrawerApplication.kt

@@ -0,0 +1,42 @@
+package com.abualzait.debugdrawer
+
+import android.app.Application
+import com.abualzait.debugdrawer.annotations.EnableDebugDrawer
+import com.abualzait.debugdrawer.utils.Logger
+import dagger.hilt.android.HiltAndroidApp
+import javax.inject.Inject
+
+/**
+ * Base Application class that automatically sets up the debug drawer.
+ * 
+ * Usage:
+ * 1. Extend this class instead of Application
+ * 2. Add @HiltAndroidApp annotation to your class
+ * 3. The debug drawer will be automatically initialized
+ * 
+ * Example:
+ * ```kotlin
+ * @HiltAndroidApp
+ * class MyApplication : DebugDrawerApplication() {
+ *     // No additional code needed!
+ * }
+ * ```
+ */
+@EnableDebugDrawer
+abstract class DebugDrawerApplication : Application() {
+    
+    @Inject
+    lateinit var debugDrawerInitializer: DebugDrawerInitializer
+    
+    @Inject
+    lateinit var logger: Logger
+
+    override fun onCreate() {
+        super.onCreate()
+        
+        // Automatically initialize debug drawer
+        debugDrawerInitializer.initializeIfEnabled(this)
+        
+        logger.d("DebugDrawerApplication", "Application started with debug drawer auto-setup")
+    }
+}