v0.4.0 - The Customization Update

🚀 HyperBridge v0.4.0

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

Tip

This is a major feature update introducing the Theme Engine, Widget Support, and a complete rewrite of the Notification Core. If you are upgrading from v0.3.x, you may need to re-grant notification permissions or battery optimizations.

---

✨ 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

0.4.0_rc2

🚀 HyperBridge v0.4.0-rc2

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

Important

This is the first Release Candidate for version 0.4.0. It represents a feature-complete build with significant architectural changes.

⚠️ Note: As this is a pre-release build, some bugs may still be present. Please report any crashes or visual glitches you encounter on the Issues Page.

---

✨ 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

0.4.0_rc1

🚀 HyperBridge v0.4.0-rc1

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

Important

This is the first Release Candidate for version 0.4.0. It represents a feature-complete build with significant architectural changes.

⚠️ Note: As this is a pre-release build, some bugs may still be present. Please report any crashes or visual glitches you encounter on the Issues Page.

---

✨ 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

0.4.0-dev08

🚀 HyperBridge Dev Build 8

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

Warning

⚠️ Early Development Warning
The new Theme Engine is currently in an experimental Beta stage. While i have done extensive testing, visual glitches, layout issues, or crashes may occur when applying complex themes. Please report any bugs you encounter!

---

✨ 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

0.4.0-dev06

HyperBridge Dev 6

This release represents a significant architectural update to the notification processing engine. The primary focus is on stability, resolving race conditions, and preparing the backend infrastructure for upcoming customization features.

🏗️ Backend Foundations

• Custom Action Icons Architecture: I have implemented the underlying logic required to support user-defined icons for notification actions. While the user interface for this feature is not yet enabled, the foundation is now in place. Once the stability of this release is confirmed by the community, the customization UI will be introduced in the next update.

🐛 Critical Bug Fixes

• Advanced Title & Text Resolution (#66 #56): I have engineered a smarter way to extract notification content. Previously, notifications using BigPictureStyle or BigTextStyle often defaulted to showing the package name (e.g., com.whatsapp) because the "real" title was hidden in expanded metadata fields. The new engine now intelligently prioritizes EXTRA_TITLE_BIG and EXTRA_BIG_TEXT when the standard fields are generic, ensuring the actual message or contact name is always displayed.
• Eliminated "Ghost" Notifications: I have resolved a race condition that occurred when a notification was dismissed rapidly. The application now properly cancels background processing jobs immediately upon dismissal, preventing the island from lingering or appearing after the notification has been cleared.

⚡ Performance & Logic Improvements

• Smart Content Hashing: I have removed the previous time-based throttling mechanism (200ms delay). The system now utilizes Content Hashing to intelligently detect meaningful changes. This allows for immediate updates without the risk of processing redundant data.
• Instant Progress Indicators: Logic for progress-based notifications (e.g., Play Store downloads) has been optimized. These notifications now bypass the standard validation delay to ensure they appear instantly on the island.

---

⚠️ Note for Testers:
This version contains substantial changes to how notifications are read and processed. Please prioritize testing standard messaging and media notifications. Confirmation that the Package Name bug (#66 #56) is fully resolved is required before I proceed with enabling the Custom Icons UI.

0.4.0_dev05

HyperBridge v0.4.0 - Dev Build 5 🚧

⚠️ Warning: This is a pre-release developer build. Features are active but may contain bugs, particularly with the new Widget system.

This update introduces a major architectural overhaul, including the long-awaited Widget system (Beta), a redesigned notification engine, and significant stability improvements.

✨ New Features

• Widget Support (BETA): Pin Android system widgets directly to the Dynamic Island!
  • New Design Tab: A dedicated hub for managing widgets.
  • Widget Picker: Browse and add widgets from any installed app with a new grouped UI.
  • Configurable Modes: Choose between Snapshot (battery efficient) and Interactive (higher refresh rate) rendering.
  • Smart Throttling: Intelligent updates to prevent battery drain and UI flickering.
• Action Text Buttons: Standard notifications now use pill-shaped text buttons (e.g., "Reply", "Archive") for clearer actions, replacing the old icon-only style.
• Uninstalled App Detection: The library now caches app names and icons, allowing you to identify and remove configs for apps that have been uninstalled.

🚀 Improvements

• Notification Engine 2.0:
  • Isolated Services: Separated standard notification listening from widget rendering into distinct services (WidgetOverlayService).
  • Separate Channels: Widgets now run on a low-priority channel to prevent sound/vibration spam.
  • Anti-Flicker: Implemented a debouncer that limits updates to 200ms for interactive widgets and 1.5s for snapshots.
• Call Island: Refined call logic for faster response times and accurate state detection.
• Navigation Logic: Improved parsing of navigation instructions (Google Maps/Waze) for consistent layouts.
• App List UI:
  • Added Pull-to-Refresh support using Material 3 Expressive components.
  • Improved empty states and loading indicators.
  • Smarter Categorization: Now uses Android Manifest metadata for accurate app categorization, falling back to keywords only when necessary.

🐛 Bug Fixes

• Timeout Logic: Fixed an issue where the island would sometimes get stuck or dismiss prematurely; timeouts are now strictly enforced.
• Crash Fixes: Resolved NullPointerException crashes related to missing app icons or uninstalled packages.
• Performance: Reduced main thread blockage during heavy notification bursts.

---

Testing Focus:
Please report any issues specifically regarding Widget flickering, Battery usage, or Notification Action buttons in this build.

• feature/polish-update: updated Polish translation by @kacskrz in #65

Full Changelog: 0.3.1-rc4...0.4.0_dev05

0.4.0-dev09

🚀 HyperBridge Dev Build 09

Build Date: January 3, 2026
Focus: Theme Engine Polish & UX Overhaul 🎨✨

Warning

⚠️ Work in Progress
The Theme Engine and Creator are evolving rapidly. This build includes significant refactors to how themes are built and applied. Some existing themes might need adjustment.

---

✨ New Features & Changes

🖌️ Redesigned "Design" Screen

The main customization hub has been completely overhauled for a smoother, cleaner experience.

• Unified UI: New carousels for Themes and Widgets that feel native and fluid.
• Smoother Scrolling: Refactored the card rendering engine to eliminate stuttering when browsing large lists.
• Direct Actions: "Create New" and "Browse" actions are now seamlessly integrated into the carousels.

🎨 Theme Engine v2

The engine has gotten smarter and more flexible.

• Dynamic "Smart" Colors:
  • Added useAppColors: The island can now automatically extract the most vibrant color from the notification's app icon.
  • Smart Filtering: The engine intelligently ignores boring backgrounds (white/black/gray) to find the true brand color.
• Shape Fine-Tuning: You can now set specific shapes for Call Buttons (Answer/Decline) independently of the global icon shape.
• Hot Reloading: Saving a theme now instantly updates the active island without needing to restart the service.

🛠️ Theme Creator 2.0

A major workflow upgrade for theme builders.

• New Navigation: Split the creator into focused screens (Colors, Icons, Calls, Actions) for a less cluttered workspace.
• Scrollable Preview: The live preview now scrolls with your options, so it never eats up your screen space on smaller phones.
• Save & Apply: New dialog to instantly apply your theme upon saving, speeding up your testing loop.
• Global Actions Manager:
  • Added a Search Bar to find specific rules quickly.
  • New visual Empty State and "Work in Progress" warnings for experimental features.

⚡ Translators & Logic

• Text Button Fix: Fixed an issue where text-only actions (like "Mark as Read") had hard-to-read colored backgrounds. They now render with a clean transparent background and white text.
• Performance: Added caching for color extraction to keep notifications snappy even with dynamic colors enabled.

---

📝 Updated JSON Spec

The theme.json specification has been updated to Version 2.

• Added use_app_colors to global.
• Added answer_shape_id and decline_shape_id to call_config.
• New default_navigation and default_progress configuration blocks.
• Check the updated JSON structure here

---

🐛 Bug Fixes

• Fixed layout issues where content was hidden under the top bar in the Creator screens.
• Fixed double top-padding on nested screens.
• Resolved stuttering in the main Design dashboard carousels.
• Fixed #77
• Fixed #69

---

What's new

• Refactor/theme creator ux by @D4vidDf
• Feat/smart colors palette by @D4vidDf

Full Changelog: 0.4.0-dev08...0.4.0-dev09

0.4.0-dev07

HyperBridge Dev 7

Fixed the last use cases where notifications showed package name instead of text

Full Changelog: 0.3.0...0.4.0-dev07

⚠️ Note for Testers:
This version contains substantial changes to how notifications are read and processed. Please prioritize testing standard, messaging and media notifications. Confirmation that the Package Name bug (#66 #56) is fully resolved is required before I proceed with enabling the Custom Icons UI.

0.3.1

What's Changed

• Added Brazilian Portuguese translation by @NIICKTCHUNS in #14
• Dev by @D4vidDf in #44
• Feature/ru de language by @kilo3528 in #52
• Feature/ru de language by @kilo3528 in #54

• Backup & Restore: Implemented a complete system to export/import settings, blocklists, and priorities via .hbr JSON files.
• Localization: Added an in-app Language Selector and support for German (de) and Russian (ru).
• UI Overhaul: Updated the entire settings and onboarding experience to Material 3 Expressive design (Large Top Bars, increased roundness, surface colors).
• Onboarding: Added a Privacy Page explaining offline architecture and improved HyperOS 3.0 compatibility checks.
• Fixes: Resolved Navigation "Exit" button rendering as an icon instead of text, and fixed App Icon loading in the Settings screen.
• Changelog: Updated release notes for v0.3.1.

New Contributors

• @kilo3528 made their first contribution in #52

Full Changelog: 0.3.0...0.3.1

0.3.1-rc4

Full Changelog: 0.3.1-rc3...0.3.1-rc4
**Fixed changelog