0.4.0 Update

README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  Hyper Bridge bridges standard Android notifications into the pill-shaped UI around the camera cutout, offering a seamless, iOS-like experience on Xiaomi phones.
+  Hyper Bridge bridges standard Android notifications into the pill-shaped UI around the camera cutout, offering a seamless, iOS-like experience on Xiaomi phones. Now with full theme customization and widget support.
 </p>
 
 <p align="center">
@@ -19,52 +19,71 @@
 </p>
 
 <p align="center">
+  <img src="https://img.shields.io/badge/version-0.4.0-blue?style=for-the-badge&logo=github" alt="Version 0.4.0" />
   <img src="https://img.shields.io/badge/kotlin-%237F52FF.svg?style=for-the-badge&logo=kotlin&logoColor=white" alt="Kotlin" />
   <img src="https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android" />
   <img src="https://img.shields.io/badge/Material%20Design-757575?style=for-the-badge&logo=material-design&logoColor=white" alt="Material Design" />
+  <a href="https://crowdin.com/project/hyper-bridge"><img src="https://badges.crowdin.net/hyper-bridge/localized.svg" alt="Crowdin" /></a>
 </p>
 
 <br>
 
 ## 🚀 Features
 
 * **Native Visuals:** Transforms notifications into HyperOS system-style islands.
+* **🎨 Theme Engine (New):** Customize every pixel.
+    * **Theme Creator:** Built-in editor to design your own themes with real-time previews.
+    * **Smart Colors:** Automatically extract vibrant brand colors from app icons.
+    * **Icon Shaping:** Choose between shapes like *Squircle*, *Clover*, *Arch*, and *Cookie*.
+    * **Granular Control:** Per-app overrides for colors, icons, and action styles.
+* **🧩 Widgets (New):** Pin standard Android widgets to the island layer for quick access—even on the Lockscreen!
 * **Smart Integration:**
     * **🎵 Media:** Show album art and "Now Playing" status with visualizer support.
-    * **🧭 Navigation:** Real-time turn-by-turn instructions (Google Maps, Waze). **New:** Customize the split layout (Distance, ETA, or Instruction).
+    * **🧭 Navigation:** Real-time turn-by-turn instructions (Google Maps, Waze).
     * **⬇️ Downloads:** Circular progress ring with a satisfying "Green Tick" animation upon completion.
     * **📞 Calls:** Dedicated layout for incoming and active calls with timers.
 * **🛡️ Spoiler Protection:** Define blocked terms globally or per-app to prevent specific notifications (e.g., message spoilers) from popping up on the Island.
-* **👻 Ghost Mode:** Option to hide the persistent service notification from the system shade while keeping the Island fully active.
 * **Total Control:** Choose exactly which apps trigger the island, customize timeouts, and toggle floating behavior per app.
 
+## 👩‍💻 For Developers: Create Themes
+
+HyperBridge supports an open theming standard (`.hbr` packages). You can create themes and distribute them, or integrate a "Apply Theme" button directly into your own app (Launcher, Icon Pack, etc.).
+
+* **Documentation:** [Full Guide on Creating & Distributing Themes](https://github.com/D4vidDf/HyperBridge/discussions/78)
+* **Intent API:** Send themes programmatically using `com.d4viddf.hyperbridge.APPLY_THEME`.
+
 ## 🌐 Supported Languages
 
-HyperBridge is fully localized thanks to our amazing community contributors!
+HyperBridge is fully localized thanks to our amazing community. **Want to add your language?** We now use Crowdin for easy translation management.
+
+👉 **[Help translate HyperBridge on Crowdin](https://crowdin.com/project/hyper-bridge)**
 
 * 🇺🇸 **English** (Default)
 * 🇪🇸 **Spanish** (Español)
 * 🇧🇷 **Portuguese** (Português Brasileiro) — Thanks to [@NIICKTCHUNS](https://github.com/NIICKTCHUNS)
 * 🇵🇱 **Polish** (Polski) — Thanks to [@kacskrz](https://github.com/kacskrz)
+* 🇸🇰 **Slovak** (Slovenčina)
 * 🇰🇷 **Korean** (한국어) — Thanks to [@alexkoala](https://github.com/alexkoala)
 * 🇺🇦 **Ukrainian** (Українська) — Thanks to [@ItzDFPlayer](https://github.com/ItzDFPlayer)
-
-> **Special Thanks:** A huge shoutout to everyone who contributed translations for this release. You make HyperBridge accessible to the world! ❤️
+* 🇷🇺 **Russian** (Русский) — Thanks to [@kilo3528](https://github.com/kilo3528)
+* 🇩🇪 **German** (Deutsch) — Thanks to [@kilo3528](https://github.com/kilo3528)
+* 🇮🇩 **Indonesian** (Bahasa Indonesia)
+* 🇹🇷 **Turkish** (Türkçe)
 
 ## 🛠️ Tech Stack
 
 * **Language:** Kotlin
 * **UI:** Jetpack Compose (Material 3 Expressive)
 * **Architecture:** MVVM
 * **Storage:** Room Database (SQLite)
-* **Services:** NotificationListenerService, BroadcastReceiver
+* **Services:** NotificationListenerService, WidgetOverlayService
 * **Concurrency:** Kotlin Coroutines & Flow
 
 ## 📸 Screenshots
 
-| Home Screen | Settings | Active Island |
-|:---:|:---:|:---:|
-| ![Home](./screenshots/home.png) | ![Settings](./screenshots/settings.png) | ![Island](./screenshots/island_example.png) |
+| Home Screen | Active Island | Theme Creator | Widget Picker |
+|:---:|:---:|:---:|:---:|
+| ![Home](./screenshots/home.png) | ![Island](./screenshots/island_example.png) | ![Creator](./screenshots/theme_creator.png) | ![Widgets](./screenshots/widget_picker.png) |
 
 ## 📥 Installation
 
@@ -91,7 +110,6 @@ Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTIN
 4.  Push to the branch (`git push origin feature/AmazingFeature`).
 5.  Open a **Pull Request**.
 
-
 ## 💖 Support the Project
 
 Hyper Bridge is an open-source project developed in my free time. If this app has improved your daily experience, please consider supporting its development!
@@ -108,4 +126,4 @@ Distributed under the Apache 2.0 License. See `LICENSE` for more information.
 
 **D4vidDf**
 * Website: [d4viddf.com](https://d4viddf.com)
-* GitHub: [@D4vidDf](https://github.com/D4vidDf)
+* GitHub: [@D4vidDf](https://github.com/D4vidDf)

app/build.gradle.kts

@@ -3,6 +3,7 @@ plugins {
     alias(libs.plugins.kotlin.android)
     alias(libs.plugins.kotlin.compose)
     alias(libs.plugins.ksp)
+    id("org.jetbrains.kotlin.plugin.serialization") version "2.3.0"
 }
 
 android {
@@ -15,8 +16,8 @@ android {
         applicationId = "com.d4viddf.hyperbridge"
         minSdk = 35
         targetSdk = 36
-        versionCode = 10
-        versionName = "0.3.1"
+        versionCode = 14
+        versionName = "0.4.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
@@ -34,14 +35,17 @@ android {
         sourceCompatibility = JavaVersion.VERSION_11
         targetCompatibility = JavaVersion.VERSION_11
     }
-    kotlinOptions {
-        jvmTarget = "11"
-    }
     buildFeatures {
         compose = true
     }
 }
 
+kotlin {
+    compilerOptions {
+        jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_11)
+    }
+}
+
 dependencies {
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.lifecycle.runtime.ktx)
@@ -54,6 +58,8 @@ dependencies {
     implementation(libs.androidx.compose.material.icons.extended)
     implementation(libs.androidx.ui)
     implementation(libs.androidx.appcompat)
+    implementation(libs.androidx.palette.ktx)
+    implementation(libs.androidx.material3)
     ksp(libs.androidx.room.compiler)
     implementation(libs.androidx.room.runtime)
     implementation(libs.androidx.room.ktx)
@@ -69,7 +75,8 @@ dependencies {
     implementation(libs.androidx.datastore.preferences)
     implementation(libs.androidx.lifecycle.viewmodel.compose)
 
-    implementation("com.google.code.gson:gson:2.10.1")
+    implementation(libs.gson)
+    implementation(libs.kotlinx.serialization.json)
 }
 
 configurations.all {

app/src/main/AndroidManifest.xml

@@ -10,6 +10,16 @@
     <uses-permission android:name="android.permission.WAKE_LOCK" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 
+    <queries>
+        <intent>
+            <action android:name="android.appwidget.action.APPWIDGET_PICK" />
+        </intent>
+
+        <intent>
+            <action android:name="com.d4viddf.hyperbridge.THEME_PROVIDER" />
+        </intent>
+    </queries>
+
     <application
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
@@ -20,17 +30,18 @@
         android:supportsRtl="true"
         android:enableOnBackInvokedCallback="true"
         android:theme="@style/Theme.HyperBridge">
+
         <activity
             android:name=".MainActivity"
             android:exported="true"
-            android:label="@string/app_name"
+            android:stateNotNeeded="true"
             android:theme="@style/Theme.HyperBridge">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
-
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+
         <receiver
             android:name=".receiver.BootReceiver"
             android:enabled="true"
@@ -46,10 +57,56 @@
             android:label="HyperBridge Listener"
             android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE"
             android:exported="true"
-            android:directBootAware="true"> <intent-filter>
-            <action android:name="android.service.notification.NotificationListenerService" />
-        </intent-filter>
+            android:directBootAware="true">
+            <intent-filter>
+                <action android:name="android.service.notification.NotificationListenerService" />
+            </intent-filter>
         </service>
+
+        <service
+            android:name=".service.WidgetOverlayService"
+            android:enabled="true"
+            android:exported="false"
+            android:foregroundServiceType="shortService" />
+
+        <activity
+            android:name=".ui.screens.theme.ThemeInstallerActivity"
+            android:exported="true"
+            android:theme="@style/Theme.HyperBridge.Transparent"
+            android:excludeFromRecents="true">
+
+            <intent-filter>
+                <action android:name="com.d4viddf.hyperbridge.APPLY_THEME" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="application/zip" />
+                <data android:mimeType="application/octet-stream" />
+                <data android:scheme="content" />
+                <data android:scheme="file" />
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data android:scheme="content" />
+                <data android:scheme="file" />
+
+                <data android:mimeType="application/zip" />
+                <data android:mimeType="application/octet-stream" />
+                <data android:mimeType="application/x-zip-compressed" />
+            </intent-filter>
+        </activity>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.provider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_paths" />
+        </provider>
     </application>
 
 </manifest>

app/src/main/java/com/d4viddf/hyperbridge/MainActivity.kt

@@ -34,7 +34,7 @@ import androidx.compose.ui.res.stringResource
 import com.d4viddf.hyperbridge.data.AppPreferences
 import com.d4viddf.hyperbridge.data.db.AppDatabase
 import com.d4viddf.hyperbridge.data.model.HyperBridgeBackup
-import com.d4viddf.hyperbridge.ui.components.ChangelogDialog
+import com.d4viddf.hyperbridge.ui.components.ChangelogSheet
 import com.d4viddf.hyperbridge.ui.components.PriorityEducationDialog
 import com.d4viddf.hyperbridge.ui.screens.home.HomeScreen
 import com.d4viddf.hyperbridge.ui.screens.onboarding.OnboardingScreen
@@ -86,7 +86,7 @@ fun MainRootNavigation() {
     val packageInfo = remember { try { context.packageManager.getPackageInfo(context.packageName, 0) } catch (e: Exception) { null } }
     @Suppress("DEPRECATION")
     val currentVersionCode = packageInfo?.longVersionCode?.toInt() ?: 0
-    val currentVersionName = packageInfo?.versionName ?: "0.3.1"
+    val currentVersionName = packageInfo?.versionName ?: "0.4.0"
 
     // --- 2. ROBUST DATA COLLECTION ---
     val isSetupComplete by produceState<Boolean?>(initialValue = null) {
@@ -232,13 +232,17 @@ fun MainRootNavigation() {
     }
 
     if (showChangelog) {
-        ChangelogDialog(currentVersionName = currentVersionName, changelogText = stringResource(R.string.changelog_0_3_1)) {
-            showChangelog = false
-            scope.launch {
-                preferences.setLastSeenVersion(currentVersionCode)
-                if (!isPriorityEduShown) showPriorityEdu = true
+        ChangelogSheet (
+            currentVersionName = currentVersionName,
+            changelogText = stringResource(R.string.changelog_0_4_0),
+            onDismiss = {
+                showChangelog = false
+                scope.launch {
+                    preferences.setLastSeenVersion(currentVersionCode)
+                    if (!isPriorityEduShown) showPriorityEdu = true
+                }
             }
-        }
+        )
     }
 
     if (showPriorityEdu) {

app/src/main/java/com/d4viddf/hyperbridge/data/AppCacheManager.kt

@@ -0,0 +1,60 @@
+package com.d4viddf.hyperbridge.data
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.util.Log
+import java.io.File
+import java.io.FileOutputStream
+import androidx.core.content.edit
+
+/**
+ * Persists App Names and Icons so they can be displayed even after the app is uninstalled.
+ */
+class AppCacheManager(private val context: Context) {
+
+    private val prefs = context.getSharedPreferences("app_metadata_cache", Context.MODE_PRIVATE)
+    private val iconsDir = File(context.filesDir, "cached_icons").apply { mkdirs() }
+
+    fun cacheAppInfo(packageName: String, name: String, icon: Bitmap?) {
+        // 1. Save Name
+        prefs.edit { putString(packageName, name) }
+
+        // 2. Save Icon to Disk
+        if (icon != null) {
+            try {
+                val file = File(iconsDir, "$packageName.png")
+                // Only save if it doesn't exist or we want to update it (optional optimization)
+                if (!file.exists()) {
+                    FileOutputStream(file).use { out ->
+                        icon.compress(Bitmap.CompressFormat.PNG, 100, out)
+                    }
+                }
+            } catch (e: Exception) {
+                Log.e("AppCacheManager", "Failed to cache icon for $packageName", e)
+            }
+        }
+    }
+
+    fun getCachedAppName(packageName: String): String {
+        return prefs.getString(packageName, null) ?: packageName
+    }
+
+    fun getCachedAppIcon(packageName: String): Bitmap? {
+        val file = File(iconsDir, "$packageName.png")
+        return if (file.exists()) {
+            try {
+                BitmapFactory.decodeFile(file.absolutePath)
+            } catch (e: Exception) {
+                null
+            }
+        } else {
+            null
+        }
+    }
+
+    fun removeCachedData(packageName: String) {
+        prefs.edit { remove(packageName) }
+        File(iconsDir, "$packageName.png").delete()
+    }
+}