Native Android App Shortcuts Integration

android/app/src/main/AndroidManifest.xml

@@ -24,10 +24,14 @@
                  the Android process has started. This theme is visible to the user
                  while the Flutter UI initializes. After that, this theme continues
                  to determine the Window background behind the Flutter UI. -->
-            <meta-data
+            <!-- <meta-data
               android:name="io.flutter.embedding.android.NormalTheme"
               android:resource="@style/NormalTheme"
-              />
+              /> -->
+              <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcuts"/>
+
             <intent-filter>
                 <action android:name="android.intent.action.MAIN"/>
                 <category android:name="android.intent.category.LAUNCHER"/>
@@ -44,6 +48,8 @@
         </activity>
         <!-- Don't delete the meta-data below.
              This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
+
+
         <meta-data
             android:name="flutterEmbedding"
             android:value="2" />

android/app/src/main/kotlin/org/aossie/ell_ena/MainActivity.kt

@@ -1,5 +1,86 @@
 package org.aossie.ell_ena
 
+import android.content.Intent
+import android.net.Uri
+import android.os.Bundle
+import android.util.Log
 import io.flutter.embedding.android.FlutterActivity
+import io.flutter.embedding.engine.FlutterEngine
+import io.flutter.plugin.common.MethodChannel
 
-class MainActivity : FlutterActivity() 
+class MainActivity : FlutterActivity() {
+    private val CHANNEL = "app_shortcuts"
+    private var pendingRoute: String? = null
+    private var methodChannel: MethodChannel? = null
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        handleIntent(intent)
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        handleIntent(intent)
+        setIntent(intent) // Important: update the current intent
+
+        // ✅ Send route to Flutter immediately when app is resumed
+        sendRouteToFlutter()
+    }
+
+    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
+        super.configureFlutterEngine(flutterEngine)
+
+        methodChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
+
+        // Setup method call handler
+        methodChannel?.setMethodCallHandler { call, result ->
+            when (call.method) {
+                "getInitialRoute" -> {
+                    result.success(pendingRoute)
+                    pendingRoute = null // Clear after sending
+                }
+                else -> result.notImplemented()
+            }
+        }
+
+        // Try to send initial route immediately if Flutter is ready
+        sendRouteToFlutter()
+    }
+
+    private fun handleIntent(intent: Intent?) {
+        // Method 1: Try to get route from deep link (app://shortcut/chat)
+        val uri: Uri? = intent?.data
+
+        if (uri != null && uri.scheme == "app" && uri.host == "shortcut") {
+            val route = uri.path?.removePrefix("/") // Remove leading "/"
+            pendingRoute = route
+            return
+        }
+
+        // Method 2: Try to get screen index from extras (fallback)
+        val screenIndex = intent?.getIntExtra("screen", -1)
+        if (screenIndex != -1) {
+            pendingRoute = when (screenIndex) {
+                0 -> "dashboard"
+                1 -> "calendar"
+                2 -> "workspace"
+                3 -> "chat"
+                4 -> "profile"
+                else -> null
+            }
+        }
+    }
+
+    private fun sendRouteToFlutter() {
+        if (pendingRoute != null && methodChannel != null) {
+            try {
+                methodChannel?.invokeMethod("navigate", pendingRoute)
+                pendingRoute = null
+            } catch (e: Exception) {
+                // ✅ Added logging for observability
+                Log.w("MainActivity", "Failed to send pendingRoute to Flutter: ${e.message}")
+                // Flutter might not be ready yet, route will be sent when getInitialRoute is called
+            }
+        }
+    }
+}

android/app/src/main/res/values/strings.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">Ell-ena</string>
+
+    <!-- App Shortcuts Labels -->
+    <string name="shortcut_dashboard_short">Dashboard</string>
+    <string name="shortcut_dashboard_long">Dashboard</string>
+
+    <string name="shortcut_calendar_short">Calendar</string>
+    <string name="shortcut_calendar_long">Calendar</string>
+
+    <string name="shortcut_workspace_short">Workspace</string>
+    <string name="shortcut_workspace_long">Workspace</string>
+
+    <string name="shortcut_chat_short">Chat</string>
+    <string name="shortcut_chat_long">Chat</string>
+
+    <string name="shortcut_profile_short">Profile</string>
+    <string name="shortcut_profile_long">Profile</string>
+</resources>

android/app/src/main/res/values/styles.xml

@@ -1,18 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
+
+    <!-- Native splash screen theme -->
     <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
-        <!-- Show a splash screen on the activity. Automatically removed when
-             the Flutter engine draws its first frame -->
         <item name="android:windowBackground">@drawable/launch_background</item>
     </style>
-    <!-- Theme applied to the Android Window as soon as the process has started.
-         This theme determines the color of the Android Window while your
-         Flutter UI initializes, as well as behind your Flutter UI while its
-         running.
 
-         This Theme is only used starting with V2 of Flutter's Android embedding. -->
+    <!-- Flutter UI theme (NO flutter logo, NO flash) -->
     <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
-        <item name="android:windowBackground">?android:colorBackground</item>
+        <item name="android:windowBackground">@android:color/transparent</item>
     </style>
+
 </resources>

android/app/src/main/res/xml/shortcuts.xml

@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- Dashboard -->
+    <shortcut
+        android:shortcutId="dashboard"
+        android:enabled="true"
+        android:icon="@drawable/ic_dashboard"
+        android:shortcutShortLabel="@string/shortcut_dashboard_short"
+        android:shortcutLongLabel="@string/shortcut_dashboard_long">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetPackage="org.aossie.ell_ena"
+            android:targetClass="org.aossie.ell_ena.MainActivity">
+            <data android:scheme="app" android:host="shortcut" android:path="/dashboard" />
+            <extra android:name="screen" android:value="0" />
+        </intent>
+    </shortcut>
+
+    <!-- Calendar -->
+    <shortcut
+        android:shortcutId="calendar"
+        android:enabled="true"
+        android:icon="@drawable/ic_calendar"
+        android:shortcutShortLabel="@string/shortcut_calendar_short"
+        android:shortcutLongLabel="@string/shortcut_calendar_long">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetPackage="org.aossie.ell_ena"
+            android:targetClass="org.aossie.ell_ena.MainActivity">
+            <data android:scheme="app" android:host="shortcut" android:path="/calendar" />
+            <extra android:name="screen" android:value="1" />
+        </intent>
+    </shortcut>
+
+    <!-- Workspace -->
+    <shortcut
+        android:shortcutId="workspace"
+        android:enabled="true"
+        android:icon="@drawable/ic_workspace"
+        android:shortcutShortLabel="@string/shortcut_workspace_short"
+        android:shortcutLongLabel="@string/shortcut_workspace_long">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetPackage="org.aossie.ell_ena"
+            android:targetClass="org.aossie.ell_ena.MainActivity">
+            <data android:scheme="app" android:host="shortcut" android:path="/workspace" />
+            <extra android:name="screen" android:value="2" />
+        </intent>
+    </shortcut>
+
+    <!-- Chat -->
+    <shortcut
+        android:shortcutId="chat"
+        android:enabled="true"
+        android:icon="@drawable/ic_chat"
+        android:shortcutShortLabel="@string/shortcut_chat_short"
+        android:shortcutLongLabel="@string/shortcut_chat_long">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetPackage="org.aossie.ell_ena"
+            android:targetClass="org.aossie.ell_ena.MainActivity">
+            <data android:scheme="app" android:host="shortcut" android:path="/chat" />
+            <extra android:name="screen" android:value="3" />
+        </intent>
+    </shortcut>
+
+    <!-- Profile -->
+    <shortcut
+        android:shortcutId="profile"
+        android:enabled="true"
+        android:icon="@drawable/ic_profile"
+        android:shortcutShortLabel="@string/shortcut_profile_short"
+        android:shortcutLongLabel="@string/shortcut_profile_long">
+
+        <intent
+            android:action="android.intent.action.VIEW"
+            android:targetPackage="org.aossie.ell_ena"
+            android:targetClass="org.aossie.ell_ena.MainActivity">
+            <data android:scheme="app" android:host="shortcut" android:path="/profile" />
+            <extra android:name="screen" android:value="4" />
+        </intent>
+    </shortcut>
+
+</shortcuts>