↓ Skip to main content
  1. Documentation/
  2. Features Overview/

Dynamic Island Engine Architecture

Deep dive into how HyperBridge renders notifications into Xiaomi Super Islands, island display states, the 10 official templates, and prioritization rules.

The Dynamic Island Engine is the core rendering pipeline of HyperBridge. It intercepts standard Android status bar notifications and translates them into native Xiaomi HyperOS HyperIsland / Super Island (Focus/Featured Notification) presentations wrapped around your camera punch hole.

Rather than drawing a simulated overlay that consumes CPU and interrupts touchscreen gestures, HyperBridge outputs native system contracts directly processed by Xiaomi’s SystemUI.


🎭 The Two Island Display States
#

Every dynamic island transitions smoothly between two primary visual states:

stateDiagram-v2
    [*] --> Expanded: Incoming Event / Alert
    Expanded --> Collapsed: Timeout (Auto-Hide TTL)
    Collapsed --> Expanded: Tap Island (Interactive Mode)
    Collapsed --> [*]: Notification Cleared / Finished
    Expanded --> [*]: Dismissed with Original Notification

1. Expanded Heads-Up Popup
#

When an active event first occurs (such as an incoming call, a new chat message, or a track change):

  • The island immediately blooms into a rich expanded card displaying full artwork, contact avatars, secondary subtitles, live progress bars, and interactive buttons.
  • Auto-Hide TTL: The card remains expanded for a user-configured duration (e.g. 5s to 60s, configurable in Global Settings β†’ Island Behavior β†’ Auto-hide Island) before automatically collapsing.
  • Float Only on First Alert: For rapidly updating notifications (like download progress or file transfers), HyperBridge includes a “Float only on first alert” option to prevent annoying repeated popups every time the progress increments.

2. Collapsed Island Capsule (Pill)
#

Once the expanded card times out:

  • The island collapses smoothly into an ultra-compact pill capsule hugging your camera hole.
  • Persistent Awareness: You can glance at active media, ongoing timer countdowns, or call statuses without losing valuable screen real estate.
  • Direct Interaction: Tapping the collapsed capsule can either reopen the expanded card or jump directly into the source app via activity intents.

πŸ“ Anatomy: smallIslandArea vs. bigIslandArea
#

Every native Xiaomi island specification defines two distinct presentation layouts:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  bigIslandArea (Expanded State)                             β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  Title & Content Text     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚ Left Icon    β”‚  Subtitle / Variable      β”‚ Right Slot β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚  [================ Progress Bar ================]           β”‚
β”‚  [ Action 1 ]         [ Action 2 ]         [ Action 3 ]     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ smallIslandArea (Collapsed Capsule)  β”‚
β”‚ (Icon) [Camera Cutout] (Timer/Status)β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  1. smallIslandArea (The Collapsed Pill):

    • imageTextInfoLeft: Displays the application icon, sender avatar, or media album art on the left side of the camera cutout.
    • imageTextInfoRight: Displays concise dynamic telemetry on the right side of the cutout, such as live stopwatch timers (MM:SS), download percentages (42%), or animated audio waveforms.
  2. bigIslandArea (The Expanded Card):

    • imageTextInfoLeft & imageTextInfoRight: Primary headers, sub-labels, and badges.
    • progressInfo: Configurable linear track or circular progress ring with custom threshold color gradients.
    • actionArea: Up to three interactive button slots mapped directly to Android notification actions, smart actions, or inline reply inputs.
    • bgInfo: Background styling, supporting solid colors, Material 3 dynamic color schemes, or rich picture backgrounds (e.g. blurred album art).

πŸ›οΈ The 10 Official Xiaomi HyperOS Template Archetypes
#

HyperBridge natively supports and generates all 10 official Xiaomi HyperOS Super Island layout archetypes:

#Template ArchetypeTypical Use CasesCollapsed PillExpanded Controls
1Media PlaybackSpotify, YouTube Music, Apple Music, PodcastsAlbum art + Audio waveTrack title, artist, live audio waveforms, play/pause, skip track buttons
2Active CallsPhone, WhatsApp Calls, Telegram Calls, Google MeetContact avatar + DurationContact name, call status (Incoming, Ongoing, Held), live timer, mute & hangup buttons
3Downloads & ProgressWeb browsers, app stores, file transfersDownload glyph + PercentageFile name, download speed, animated progress bar, completion checkmark
4Navigation & TransitGoogle Maps, Waze, CitymapperTurn arrow + DistanceManeuver direction, street name, distance to next turn, arrival ETA
5Timers & CountdownsClock app, kitchen timers, pomodoroTimer icon + CountdownRemaining time, progress ring, pause, add minute, and cancel buttons
6Ride & Delivery TrackingUber, Bolt, DoorDash, DeliverooVehicle/food icon + ETADriver name, vehicle license plate, delivery status, 1-tap call driver action
7Boarding Pass & TravelAirlines, Train operatorsFlight code + DepartureFlight/train number, origin/destination gates, boarding status, barcode shortcut
8Payment & WalletBanking, Google WalletMerchant logo + StatusTransaction summary, payment amount, success animation
9Weather & EnvironmentWeather apps, severe alertsWeather glyph + TempCurrent temperature, rain probability, severe weather alert banner
10Standard & MessagesSMS, WhatsApp, Telegram, SignalSender avatar + Message snippetFull message text, 1-tap OTP copy button, or Inline Reply box

⚑ Multi-Island Prioritization Rules
#

When multiple applications post active notifications simultaneously, the HyperBridge Island Update Resolver strictly prioritizes which event occupies the Super Island:

flowchart TD
    E1["Priority 1: Active Calls (Urgent voice sessions)"] --> E2["Priority 2: Navigation & Turn-by-Turn"]
    E2 --> E3["Priority 3: Active Timers & Stopwatches"]
    E3 --> E4["Priority 4: Media Playback (Spotify, YTM)"]
    E4 --> E5["Priority 5: Active Downloads & Progress"]
    E5 --> E6["Priority 6: Standard Messages & Alerts"]
  • Urgent Preemption: If you are playing music and an incoming phone call or navigation cue arrives, the call immediately takes precedence over the media player.
  • Graceful Restoration: Once the call ends or navigation maneuver completes, the island seamlessly restores your media player or active timer.
  • Permanent Island Yielding: If you have Permanent Island enabled, the idle pill yields momentarily to active alerts and returns automatically once all notifications are dismissed.

πŸš€ Customizing Island Layouts
#

Want to build your own layouts beyond the standard templates?