What's Changed

• refactor(service): refine floating behavior for progress notifications by @D4vidDf in #164
• Fix/162 bug crash unable to start service with null by @D4vidDf in #165

Note

I'm aware some users are experiencing some problems with the app not being able to read notifications under certain conditions. This second beta only brings a fix to a major crash, the remaining problems (like Hyper Birdge not being able to read Telegram Grouped notifications) will be fixed on the next version.

Full Changelog: v0.5.0-beta01...v0.5.0-beta02

Welcome to the first Beta release of Hyper Bridge 0.5.0! This milestone represents a massive leap forward in bringing the native Hyper Island experience to all users—including those on CN ROMs—with unprecedented customization and stability.

🌟 The Headline: Native Live Updates (CN ROM Support)

The biggest breakthrough in 0.5.0 is the Native Live Updates engine. By rebuilding notifications as standard Android Live Updates, Hyper Bridge now allows the system to automatically wrap notifications into the Hyper Island.

• CN ROM Users: Islands finally work for you (HyperOS 3.0.300+) without needing official Xiaomi approval.
• Global Users: Enjoy smoother, native system animations for your Island.
• How to enable: You can select the new engine under the Theme Editor > Engine section or via App Settings > Global Settings > Engine.

✨ What's New in the Beta

This Beta build consolidates all features from the Alpha phase while adding critical stability and UX improvements:

🛠️ Critical Fix: Boot Reliability (#158)

I've implemented Direct Boot support. Hyper Bridge is now "Direct Boot Aware," meaning the service can reliably re-bind and start protecting your notifications immediately after a phone restart, even before you enter your PIN/Pattern. This fixes a critical bug #158

📱 New Onboarding & Navigation

• Onboarding Experience: A brand new onboarding flow to help new users set up critical permissions (Autostart, Battery Restrictions) correctly from the start.
• Navigation Compose: The entire app has been migrated to the latest Navigation 3 (Compose) architecture for faster screen transitions and better state management.

🎨 Layered Customization & Theme Engine

• Smart Resolution: A powerful new hierarchy for settings: Theme App Override > User App Override > Theme Global Override > User Global Fallback.
• Advanced Color Picker: The Theme Creator now features a professional HSL (Hue, Saturation, Lightness) selector for ultra-precise color control.
• Behavior Controls: You can now edit behavior settings (Show on Notification Panel, Timeout, Popup, and Duplication) through the Theme Editor > Engine section or via Settings > Global Settings > Behavior.
• Notification Types: These can now be edited at both the global and app levels directly inside the Theme Editor.

⚙️ Engine & Island Improvements

• Auto-Hide Logic: New slider for auto-hide timeouts with precise snap points (1s to 1h).
• Progress & Nav Refinements: Improved behavior for download rings and navigation state persistence.

📦 What's Changed

• Feature/nav3 migration by @D4vidDf in #152
• Feature/duplication toggle by @D4vidDf in #153
• Feature/onboarding screen by @D4vidDf in #155
• fix(service): refine progress notification behavior and navigation state by @D4vidDf in #157
• feat(boot): add support for Direct Boot by @D4vidDf in #159

⚠️ Important Beta Notes

• Settings Sync: Due to a rebuild of the background architecture, you may need to reconfigure your Engine Options (Native vs. Xiaomi) after updating.
• System Requirements: Native Live Updates requires HyperOS 3.0 (v3.0.300.0+) or the latest System UI Plugin update.

Full Changelog: v0.5.0-aplha03...v0.5.0-beta01

HyperBridge v0.5.0-alpha03 🚀

Welcome to the third alpha of HyperBridge 0.5.0! This release brings critical fixes to the Theme Engine's resolution logic.

⚠️ Important Notice: Action Required

You may need to reconfigure your Engine Options after updating. I completely rebuilt the background architecture for how engine preferences (Native vs. Xiaomi) are saved and resolved. This should guarantee synchronization between Global Settings and Custom Themes, but it means your previous engine selections might have been reset to default. Please take a moment to double-check your settings!

✨ Key Fixes & Enhancements

⚙️ Engine Resolution

• Smart Inheritance: Fixed a major issue where Custom Themes were silently forcing the "Xiaomi Featured" engine on all apps. Custom Themes will now properly inherit your Global Engine preference unless the theme creator explicitly overrides it.
• Improved Logic: The engine resolution now perfectly respects the hierarchy: Theme App Override > User App Override > Theme Global Override > User Global Fallback.
• Settings Sync: Updating the engine from the Global Settings screen while a Custom Theme is active will now intelligently patch the theme directly, applying the change instantly.

⚡ Live Updates Expansion

• CN Support: The Native Live Updates engine adds support to CN devices, you might find that Theme customization are more restricted on Live updates.
• System Requirements: Please note that the Live Updates engine requires HyperOS 3.1 (v3.0.300.0 +) to function correctly. (Some users might be able to use live updates by updating the system ui plugin to the latest available version)

📦 What's Changed

• feat(theme): enhance engine resolution and theme-persistent configuration by @D4vidDf in #147

Full Changelog: v0.5.0-alpha02...v0.5.0-alpha03

Welcome to the second alpha of HyperBridge 0.5.0! This release focuses on expanding the customization of the new engine, refining the Global Settings UI, and introducing a powerful layered configuration system. Oh, and bonjour to our new French localization! 🇫🇷

✨ Key Features & Enhancements

🎨 UX Redesign & Global Configuration (#137)

• Completely Redesigned Settings: Global Settings now use a modern, standardized card-based layout (SettingsToggleCard).
• Dedicated Screens: Settings have been neatly split into dedicated menus: Engine Settings, Island Settings, and Nav Customization.
• Refined Auto-hide Logic: I've implemented a new auto-hide timeout slider with precise snap points (1s to 1h). Previously called Auto-minimize delay that didn't work.
  • Note: Currently, Auto-hide is supported only for Xiaomi Featured Notifications. Support for Native Live Updates will be added in a future update.
• Cleaner Defaults: Default notification shade visibility is now set to false for a cleaner, "Island-only" default experience.

⚙️ Layered App-Specific Configurations

• Smart Resolution (Theme > App > Global): HyperBridge now uses a powerful layered architecture. Themes can override apps, and apps can override global defaults!
• Per-App Overrides: You can now configure notification types and engine selection (Xiaomi vs. Native) on a strictly per-app basis.
• Theme Editor Upgrades: Integrated "Engine", "Island Behavior", and "Notification Types" directly into the App Theme Editor.

⚡ Enhanced Native Live Updates

• Expanded Customization: Following the introduction of the Live Update engine in v0.5.0-alpha01, I've added more ways to personalizing it.
• Themed Live Updates: The engine now supports custom themed colors and icons, specifically optimized for navigation events.
• Smarter Fallbacks: Improved title and text resolution with smarter fallback mechanisms and content hashing for real-time updates.
• Community Driven: This update includes full support for Live Updates as requested in #96.

🌍 Localization & Bug Fixes

• New Language: Full French (France) translation added for the entire app, including UI components and historical changelogs!
• Critical Crash Fix: Resolved an issue that caused the app to crash when opening settings while the system language was set to Traditional Chinese.

🛠️ Under the Hood (Build & Tooling) (#134)

• Massive Version Bump: Upgraded to Android Gradle Plugin (AGP) 9.1.0, Gradle 9.3.1, Kotlin 2.3.20, and Compose BOM 2026.03.00.
• Optimized Release Builds: Updated ProGuard rules to strip Debug and Info logs in release builds using the new AGP 9.1+ syntax.

📦 What's Changed (Pull Requests)

• Feat/live updates by @D4vidDf in #133
• build: update project dependencies and gradle configuration by @D4vidDf in #134
• Feature/ux improvement global configuration by @D4vidDf in #137

Full Changelog: v0.5.0-alpha01...v0.5.0-alpha02

I am happy to announce the first Alpha build for Hyper Bridge 0.5.0, and it brings a massive breakthrough for the community!

🌟 Official CN ROM Support! (HyperOS 3.0.300+)
I have integrated a brand new "Native Live Updates" service. Instead of relying on custom Xiaomi parameters—which are classified as Featured Notifications that require official approval from Xiaomi to be displayed on CN ROMs—HyperBridge now intelligently rebuilds notifications as standard Android 16 Promoted Ongoing tasks (Live Updates).

What does this mean? The HyperOS system intercepts the standard Android Live notifications and wraps them into the Hyper Island automatically!

• CN ROM Users: Islands finally work for you! No more waiting for official Xiaomi approval or relying on complex workarounds. Please take the time to test if Live Updates works on your devices, I was only able to confirm it works on a couple of CN devices.
• Global Users: Enjoy a smoother, native Android notifications on your Island.

⚙️ How to Enable It:

1. Open HyperBridge.
2. Go to Settings > Global Settings.
3. Toggle on "Native Live Updates".

🎨 Also in this Update:

• Advanced Theme Creator: I have added a brand new HSL (Hue, Saturation, Lightness) color selector to the Theme Creator, giving you ultra-precise control over your custom Island colors. No more adding the custom hex value!
• Improved Widget Screens: The widget configuration and setup screens have been completely overhauled for a cleaner, more intuitive user experience.

⚠️ Alpha Notes (Current Limitations):
Since this is an early Alpha, the new engine is currently in a "global override" state:

• All or Nothing (For Now): Enabling this toggle currently converts all intercepted notifications (Timers, Downloads, Media) into Native Live Updates.
• Duplicate Notifications: You will currently see both the original app notification and the HyperBridge generated one in your shade. (I am keeping original notifications visible right now for testing purposes).

What's coming in next Alphas?
I am already working on the next phases of the engine:

• The Notification Killer: A new toggle to automatically intercept and hide the original app's notification so your shade (Notification Panel) stays perfectly clean (no more duplicates!).
• Auto-Dismiss Timers: Let the app automatically clean up inactive Islands after a customizable amount of time.
• Granular Control: Choose between the classic HyperBridge engine or the Native Engine on a per-app and per-category basis!

Hyper Bridge 0.5.0 is slowly reaching the awaited full live update support and adding more options to make everyone's experience even better. I am aware that users are experiencing some annoying bugs—like the app stopping its background service after an undetermined amount of time—and I am actively investigating those to get them patched since a lot of them are due to Xiaomi migrating their system core apps to Rust making Hyper Islands stop working. Xiaomi is already deploying OS updates that makes some of this issues be fixed.

Status: Hotfix Release 🩹

This is a quick hotfix update to address a critical issue introduced in the recent localization update, alongside some under-the-hood improvements.

🛠️ Fixes & Improvements

• Crash Fix: Resolved a critical UnknownFormatConversionException crash that occurred when opening the app configuration menu while the device language was set to Traditional Chinese (Taiwan).
• General: Minor bug fixes and core stability improvements to keep the Island running smoothly.

A huge thank you to the community for reporting the crash so quickly!

Full Changelog: v0.4.0...v0.4.2

🚀 HyperBridge v0.4.0

Build Date: January 22, 2026
Status: Stable Release 🌟

✨ Highlights

🎨 The HyperTheme Engine

We have unlocked full customization. You are no longer limited to the default look.

• Theme Creator: Design your own Dynamic Island themes directly inside the app with a real-time visual editor.
• Smart Colors: Enable useAppColors to automatically extract vibrant brand colors from the notification's app icon (e.g., Green for WhatsApp, Blue for Telegram).
• Icon Shaping: Customize action buttons with shapes like Squircle, Clover, Arch, Cookie, and more.
• Granular Control: Configure specific colors for Calls (Answer/Decline) and override rules for individual apps.
• Sharing: Export your creations as .hbr files to share with the community.

🧩 Widget Support

Your favorite Android widgets now live in the Dynamic Island.

• Pin Anywhere: Access music controls, calendars, or weather widgets from the island layer.
• Lockscreen Ready: Widgets remain visible and interactive even on the lockscreen.
• Dual Modes: Choose between Interactive (real-time, high refresh) or Snapshot (battery-efficient) rendering.

⚠️ Important: Widgets containing scrollable lists (e.g., Todo lists, Email streams) cannot be rendered in Interactive Mode due to system limitations. Please select Snapshot Mode for these widgets to display them correctly.

⚡ Notification Engine 2.0

The core listening service has been rewritten for maximum stability and performance.

• Smart Parsing: Fixed long-standing issues where notifications displayed package names (e.g., com.whatsapp) instead of message content.
• Anti-Flicker: Implemented content hashing to eliminate UI stuttering during rapid updates (e.g., download progress).
• Ghost Busters: Resolved race conditions that caused "ghost islands" to linger after a notification was dismissed.

🛠️ Improvements & Fixes

• UI Redesign: A completely new "Design" hub with fluid carousels for managing Themes and Widgets.
• Privacy: Added a Global Blocklist to hide specific words or spoilers from appearing on the island.
• Navigation: Fixed issues where "Exit Navigation" buttons were missing from the notification shade.
• Progress Islands: Fixed rendering issues where download/upload islands would collapse or fail to show action buttons.
• Database: Migrated internal storage to Room Database for better reliability and boot persistence.
• Stability: Fixed a NullPointerException crash when configuring apps via the bottom sheet.

🌍 Localization

We have moved our translation workflow to Crowdin! A massive thank you to everyone who contributed.

👉 Help translate HyperBridge on Crowdin

• New Languages:
  • 🇮🇩 Indonesian (Bahasa Indonesia)
  • 🇹🇷 Turkish (Türkçe)
  • 🇸🇰 Slovak (Slovenčina)
• Updated: 🇧🇷 Portuguese (Brazil), 🇵🇱 Polish, 🇰🇷 Korean, 🇺🇦 Ukrainian, 🇷🇺 Russian, 🇩🇪 German.

👩‍💻 For Developers

• Theme API: Third-party apps (launchers, icon packs) can now apply themes programmatically using the com.d4viddf.hyperbridge.APPLY_THEME intent.
• Documentation: Check the Theme Creation Guide to learn how to build .hbr packages.

🤝 Contributors

Special thanks to our new contributors in this cycle:

• @alexkoala (Korean translations)
• @ItzDFPlayer (Ukrainian translations)
• @kilo3528 (Russian & German translations)
• @NIICKTCHUNS & @kacskrz (Continuous localization support)

Full Changelog: 0.3.1...v0.4.0

🚀 HyperBridge v0.4.0-rc2

Build Date: January 16, 2026
Status: Release Candidate 2 🏁

✨ Major Features

🎨 The HyperTheme Engine & Creator

A complete overhaul of the visual system allowing for granular customization directly in the app.

• Built-in Theme Creator: Design themes on your phone with a new visual editor and real-time previews (#90).
• Smart Colors: Enable useAppColors to automatically extract vibrant brand colors from app icons.
• Icon Shaping: Customize action buttons with shapes like Square, Circle, Clover, Arch, and Cookie.
• Global Action Styling: Define default styles for actions like "Reply" or "Archive" that apply across all apps (#86).
• Call Customization: Configure specific colors and shapes for Answer/Decline buttons independently (#86).
• Portable Packages: Export and share your creations as .hbr files.

🧩 Widget Support (Beta)

Pin standard Android widgets directly to the Dynamic Island layer.

• Lockscreen Support: Widgets remain visible and functional on the lockscreen.
• Dual Modes: Choose between Interactive (high refresh) and Snapshot (battery efficient) rendering.
• Smart Throttling: Intelligent debouncing prevents battery drain during heavy updates.

⚡ Notification Engine 2.0

The core listening service has been rewritten for maximum stability.

• Smarter Parsing: Fixed issues where notifications displayed package names (e.g., com.whatsapp) instead of message content (#28, #31).
• Anti-Flicker: Implemented content hashing to eliminate UI stuttering during rapid updates.
• Ghost Fixes: Resolved race conditions that caused islands to linger after dismissal.

🛡️ Privacy & Blocklist

• Spoiler Protection: New blocklist features to hide specific content or apps from the island (#32).
• Redesigned Config: A cleaner interface for managing blocked apps and terms (#32).

💅 UI & UX Improvements

• Redesigned Dashboard: A completely new "Design" hub with fluid carousels for managing Themes and Widgets (#83).
• Navigation Refactor: Simplified app navigation structure for better accessibility and flow (#83).
• Accessibility: Improved TalkBack support and semantic navigation for screen readers (#24).
• Navigation Island: Added layout customization options and fixed text alignment issues (#18).

🏗️ Technical & Infrastructure

• Database Migration: Migrated preference storage from DataStore to Room Database to resolve boot persistence issues where settings were lost on restart (#29, #43).
• Dependency Updates: Downgraded DataStore initially to fix persistence before the full migration to Room (#29).

🌍 Localization

We have moved our translation workflow to Crowdin! This makes it easier for anyone to contribute.

👉 Help translate HyperBridge on Crowdin

• New Languages: 🇮🇩 Indonesian & 🇹🇷 Turkish.
• Updated & Improved: 🇧🇷 Portuguese (Brazil), 🇵🇱 Polish, 🇰🇷 Korean, 🇺🇦 Ukrainian, 🇷🇺 Russian, 🇩🇪 German.

Bug Fixes

• Fixed a crash when trying to edit navigation design on app bottom sheet.

🤝 New Contributors

• @alexkoala made their first contribution in #26
• @ItzDFPlayer made their first contribution in #37
• @kilo3528 made their first contribution in #52

Full Changelog: 0.3.1...0.4.0_rc2

🚀 HyperBridge v0.4.0-rc1

Build Date: January 16, 2026
Status: Release Candidate 1 🏁

✨ Major Features

🎨 The HyperTheme Engine & Creator

A complete overhaul of the visual system allowing for granular customization directly in the app.

• Built-in Theme Creator: Design themes on your phone with a new visual editor and real-time previews (#90).
• Smart Colors: Enable useAppColors to automatically extract vibrant brand colors from app icons.
• Icon Shaping: Customize action buttons with shapes like Square, Circle, Clover, Arch, and Cookie.
• Global Action Styling: Define default styles for actions like "Reply" or "Archive" that apply across all apps (#86).
• Call Customization: Configure specific colors and shapes for Answer/Decline buttons independently (#86).
• Portable Packages: Export and share your creations as .hbr files.

🧩 Widget Support (Beta)

Pin standard Android widgets directly to the Dynamic Island layer.

• Lockscreen Support: Widgets remain visible and functional on the lockscreen.
• Dual Modes: Choose between Interactive (high refresh) and Snapshot (battery efficient) rendering.
• Smart Throttling: Intelligent debouncing prevents battery drain during heavy updates.

⚡ Notification Engine 2.0

The core listening service has been rewritten for maximum stability.

• Smarter Parsing: Fixed issues where notifications displayed package names (e.g., com.whatsapp) instead of message content (#28, #31).
• Anti-Flicker: Implemented content hashing to eliminate UI stuttering during rapid updates.
• Ghost Fixes: Resolved race conditions that caused islands to linger after dismissal.

🛡️ Privacy & Blocklist

• Spoiler Protection: New blocklist features to hide specific content or apps from the island (#32).
• Redesigned Config: A cleaner interface for managing blocked apps and terms (#32).

💅 UI & UX Improvements

• Redesigned Dashboard: A completely new "Design" hub with fluid carousels for managing Themes and Widgets (#83).
• Navigation Refactor: Simplified app navigation structure for better accessibility and flow (#83).
• Accessibility: Improved TalkBack support and semantic navigation for screen readers (#24).
• Navigation Island: Added layout customization options and fixed text alignment issues (#18).

🏗️ Technical & Infrastructure

• Database Migration: Migrated preference storage from DataStore to Room Database to resolve boot persistence issues where settings were lost on restart (#29, #43).
• Dependency Updates: Downgraded DataStore initially to fix persistence before the full migration to Room (#29).

🌍 Localization

We have moved our translation workflow to Crowdin! This makes it easier for anyone to contribute.

👉 Help translate HyperBridge on Crowdin

• New Languages: 🇮🇩 Indonesian & 🇹🇷 Turkish.
• Updated & Improved: 🇧🇷 Portuguese (Brazil), 🇵🇱 Polish, 🇰🇷 Korean, 🇺🇦 Ukrainian, 🇷🇺 Russian, 🇩🇪 German.

🤝 New Contributors

• @alexkoala made their first contribution in #26
• @ItzDFPlayer made their first contribution in #37
• @kilo3528 made their first contribution in #52

Full Changelog: 0.3.1...0.4.0_rc1

🚀 HyperBridge Dev Build 8

Build Date: December 30, 2025
Focus: The New Theme Engine 🎨

✨ New Features

🎨 The HyperTheme Engine

I have completely rewritten how HyperBridge handles visuals. You can now fully customize the Dynamic Island experience.

• .hbr Package Support: Themes are now portable packages containing configuration and assets.
• Dynamic Styling: Change the global highlight colors. Text colors, and background styles are intended to be available in future realeases.
• Icon Shaping: Choose between Circle, Square, Cookie, Arch, and Clover shapes for your action buttons.
• Smart Padding: Adjust the padding inside action buttons to fit your icon pack perfectly.

🛠️ Built-in Theme Studio

You don't need a PC to create themes. I've added a powerful Theme Creator inside the app:

• Visual Editor: Create and edit themes with real-time previews.
• Granular Control:
  • Colors: Set global accents or use "App Colors" to match the active notification.
  • Icons: Import custom PNGs for Call Answer/Decline, Navigation Indication/End, and more.
  • App Overrides: Set specific colors and icons for specific apps (e.g., Green for WhatsApp, Blue for Telegram).
• Export: Share your creations as .hbr files directly from the manager.

📥 Import & Installer

• Theme Installer: A new dedicated screen for importing themes.
• Deep Linking: Open .hbr or .zip files directly from your File Manager or Telegram to install them in HyperBridge.
• Theme Manager: View, delete, export, and switch between installed themes easily.

⚡ Translator Updates

The core notification translators have been updated to respect your active theme:

• Call Island: Now uses your custom Answer/Decline icons and colors.
• Navigation Island: Respects the theme's progress bar color and forward/end icons.
• Progress Island: Uses the theme's active/finished colors.

👩‍💻 For Developers

I have opened up the API for third-party apps (icon packs, launchers, theme stores) to apply themes programmatically to HyperBridge.

• Public Intent API: Apps can now generate and send themes directly to HyperBridge without user manual intervention.
• Documentation: Check out the integration guide on GitHub:
  👉 How to integrate Themes for Third-Party Developers

🐛 Known Issues

• Some system-default icons might not tint or center correctly.
• Live preview in Theme Creator might stutter when changing icon shape.
• "Colors from app" might not work.

What's new

• Updated Brazilian Portuguese Translation to 0.4.0-dev by @NIICKTCHUNS in #75
• Feat/theme engine by @D4vidDf in #79

Full Changelog: 0.4.0-dev06...0.4.0-dev08