Skip to content
CAI
Software that uses CAICheck a score

BlueBubblesApp/bluebubbles-app

49.4

Weak · 5 November 2026

135.7k

lines of production code

Dart

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add BlueBubbles desktop entry for Linux Snap

A new .desktop file has been added to the Snap package, enabling the BlueBubbles application to appear in the Linux desktop application menu. This entry defines the application name, icon location, and categories (Network, InstantMessaging, Chat), allowing users to launch the app directly from their desktop environment.

snap/gui · high confidence

Add Find My device and friend locator interface

Introduces a new Find My layout that displays a map alongside tabs for friends, devices, and items. The page uses a sliding panel UI, handles location permissions, and supports both phone and tablet layouts with distinct navigation structures.

lib/app/layouts/findmy · high confidence

Add PWA support for the web application

The web application now supports Progressive Web App (PWA) capabilities, allowing users to install it as a standalone app on their devices. This change introduces the necessary \index.html\ entry point with splash screen styling and Google Sign-In configuration, along with a \manifest.json\ file defining the app's name, icons, and standalone display mode.

web · high confidence

Add iMessage-style screen effects (balloons, fireworks, lasers, love, spotlight, celebration)

Users can now trigger full-screen overlay animations when sending messages, mirroring Apple's iMessage screen effects. This change introduces a new two-file-per-effect architecture in lib/app/animations, adding controllers and custom render objects for six effects: Balloons, Fireworks, Lasers, Love (hearts), Spotlight, and Celebration (confetti). These effects are rendered as custom paint operations and are triggered from the conversation view's effects widget.

lib/app/animations · high confidence

Add macOS desktop application support

Users can now run the BlueBubbles app on macOS. This change introduces the native macOS Runner project, including the application entry point, main menu interface, app icon assets, and build configurations. It also integrates the bitsdojo\_window\_macos library to enable custom window framing and startup behavior.

macos/Runner · high confidence

Add settings search feature

Users can now search for settings panels by keyword across all settings pages. The new search interface includes a debounced input bar (with iOS and Material variants), a list of searchable setting items with breadcrumb navigation, and an empty state for no matches. Side-effect handlers like exporting contacts, opening review/donation/Discord links, and resetting the app are now centralized in a dedicated actions module.

lib/app/layouts/settings/widgets/search · high confidence

Added Windows platform support for the Flutter application

The application now supports the Windows desktop platform. This change introduces the necessary CMake build configuration and automatically registers a comprehensive set of native plugins required for Windows functionality, including window management, desktop file drag-and-drop, local authentication, tray management, and media handling.

windows/flutter · high confidence

Added chat peek view for previewing conversations

Users can now long-press a conversation in the list to see a preview of recent messages without fully opening the chat. This new \ConversationPeekView\ displays a compact, animated overlay with message content and context-aware theming, allowing for quick glances at conversation activity while staying on the main list screen.

_lib/app/layouts/conversation\list/dialogs · high confidence

Added custom mention dialog for editing mentions

Users can now edit the display name of a mention after it has been inserted into a message. A new dialog allows users to modify the mention's text, with the ability to cancel or confirm the change, ensuring that custom mentions are handled correctly during message editing.

_lib/app/layouts/conversation\view/dialogs · high confidence

Added macOS platform support

The application now supports macOS, enabling users to build and run the app on Apple's desktop operating system. This change introduces the necessary Xcode project configuration, workspace settings, and build schemes required to compile the Flutter application for macOS.

macos/Runner.xcodeproj, macos/Runner.xcworkspace · high confidence

Added typed helper classes for chat service types and language codes

This change introduces new utility classes in the helpers/types/classes directory to support chat and language functionality. The \ChatServiceType\ enum defines messaging service types (iMessage, SMS, RCS) with logic to parse service types from chat GUIDs and control UI visibility. The \language\_codes.dart\ file provides a mapping of ISO 639-1 language codes to their display names, supporting features like ML Kit language identification and Smart Reply.

lib/helpers/types/classes · high confidence

Added web-compatible ContactV2 model stub

A new ContactV2 model class has been introduced in the HTML-specific models directory to provide minimal web compatibility. This stub implements core contact properties such as display name, native ID, and addresses, along with helper methods for normalizing phone numbers and emails, generating initials, and handling serialization. It also includes a placeholder avatar implementation to ensure the contact data structure functions correctly within the web environment.

lib/models/html · high confidence

Conversation details page redesigned with Material 3 Expressive skin and per-chat theming

The conversation details panel has been rewritten to support a new Material 3 Expressive UI skin alongside the existing iOS style. This update introduces a hero header with an editable group avatar, a connected action button group, and a reorganized options menu grouped into Appearance, Conversation, Content, and Danger Zone sections. A key addition is per-chat adaptive theming, allowing users to set custom light and dark themes and wallpapers that dynamically adjust the header and tile colors of the details page. The participants list is now presented in a connected-corner section with a 'Show more' toggle, and the overall layout uses sentence-case headers and tonal surfaces derived from the selected theme.

_lib/app/layouts/conversation\details/widgets · high confidence

Custom chat background image selection and editing

Users can now set a custom background image for individual chats. This change introduces a new background cropping interface that allows users to select an image, crop it to the screen aspect ratio (with an option to lock or unlock the ratio), and apply a blur effect. The system automatically downscales large images to a maximum dimension of 2560 pixels and encodes the final result as a high-quality JPEG to optimize file size, replacing any previously saved custom background for that chat.

lib/app/layouts/settings/pages/theming/background · high confidence

Enhanced search with sender and date filters

The search interface now supports filtering results by sender (messages from you, not from you, or by specific handle) and by date (since a specific date). These filters are applied to both local and network search modes, allowing users to narrow down results more precisely. The search view includes UI components for selecting these filters, and the search query helper has been updated to incorporate these conditions into the search logic.

_lib/app/layouts/conversation\list/pages/search · high confidence

Initial Flatpak packaging for Linux

BlueBubbles is now available as a Flatpak package for Linux users. This change introduces the necessary desktop entry and metainfo files, enabling installation via Flathub and providing Linux-specific metadata such as screenshots, release notes, and sandboxing configuration.

flatpak · high confidence

Initial Linux desktop build configuration and plugin registration

This change introduces the foundational build infrastructure for the Linux desktop platform, including the CMake configuration to link the Flutter engine and system libraries (GTK, GLib, GIO), as well as the generated plugin registrant files. It registers a comprehensive set of desktop-specific plugins such as window management, tray icons, file selection, media playback, and emoji picking, enabling the application to run and utilize platform features on Linux.

linux/flutter · high confidence

Initial Windows desktop support with installer and build tooling

This change introduces the Windows desktop platform for BlueBubbles. It adds the native C++ runner, CMake build configuration, and an Inno Setup installer that bundles the application, handles required runtime dependencies (Visual C++ Redistributable, WebView2), and registers the iMessage URL protocol. A PowerShell build script automates the release process, supporting both MS Store MSIX packaging and sideloaded MSIX/Installer generation, with CI integration for code signing via SignPath.

windows · high confidence

Introduce Custom Groups management in Settings

Users can now create, rename, and delete custom groups of chats within the Settings page. The new Custom Groups panel (with platform-specific UIs for iOS, Material, and Samsung) allows users to select multiple chats when creating or editing a group, reorder groups via drag-and-drop, and toggle whether an unread badge is displayed for each group.

_lib/app/layouts/settings/pages/custom\groups · high confidence

Introduce animated dynamic wallpapers for chat backgrounds

Users can now apply animated backgrounds to individual chats, moving beyond static images. The update adds a new wallpaper type system that supports four animated styles—Waves, Floating Shapes, Drifting Circles, and Particles—each with customizable parameters like speed, density, and colors drawn from the chat's theme. A unified configuration interface allows users to adjust these settings, and the underlying image decoding is optimized to resize backgrounds to the current window size, improving performance on desktop during window resizes.

lib/app/components/wallpaper · high confidence

Introduce centralized cross-cutting data models and DTOs

The \lib/models\ directory now serves as the single source for plain data classes and view models used across the application. This change introduces a comprehensive set of new DTOs to support recent feature expansions, including structured data for server version and feature detection (\ServerDetails\), storage analysis and cleanup (\StorageAnalysisResult\, \StorageSegment\), and developer tooling for handle auditing (\HandleAuditResult\). It also adds models for message handling improvements such as reply contexts, receipt info, and update events, alongside support for new capabilities like location attachments, FCM data, and app update checks. These pure data classes are designed to be serializable and safe for cross-isolate communication, replacing ad-hoc structures with a consistent, barrel-exported API.

lib/models · high confidence

Introduce native Windows desktop runner with splash screen and dark mode support

This change adds the Windows platform runner for the BlueBubbles desktop application. It introduces a native C++ entry point (main.cpp) that initializes the Flutter engine, registers plugins, and manages the main window lifecycle. A key feature is the native splash screen (splash\_screen.cpp/h), which displays immediately on launch to provide visual feedback during startup, including migration progress and stall detection, before the Flutter UI is ready. The runner also supports per-monitor DPI awareness, dark mode theming (matching system preferences), and custom window frames via the bitsdojo\_window plugin. Resource files (Runner.rc, manifest) embed versioning, company info (BlueBubbles), and compatibility declarations for Windows 7-11.

windows/runner · high confidence

Introduce redesigned message popup with platform-specific actions and desktop support

The message popup (long-press context menu) has been completely rewritten to support desktop right-click interactions and offer a more granular, platform-aware set of actions. The new popup includes dedicated actions for opening images in a native viewer (desktop), copying attachments (desktop), and creating contacts (Android), alongside standard actions like reply, edit, unsend, and bookmark. It also features a reaction picker with a custom clipper for iOS-style tails, improved gallery attachment scoping, and adaptive theming that respects per-chat bubble colors.

_lib/app/layouts/conversation\view/widgets/message/popup · high confidence

Introduces dedicated UI state services for contacts, handles, and typing indicators

The app now uses new centralized services in lib/services/ui to manage reactive UI state for contacts and typing indicators. ContactServiceV2 handles device contact synchronization, permission management, and account contact counts, while HandleService maintains a registry of HandleState objects and automatically applies redaction settings (such as hiding names and avatars) across all active handles. TypingIndicatorService now centrally tracks and broadcasts typing status per chat, ensuring consistent real-time feedback. These services replace previous ad-hoc state management, providing a more robust and reactive foundation for contact and interaction features.

lib/services/ui · high confidence

Introduces shared data transfer objects for global app state and communication

This change establishes a new \lib/database/global\ directory containing plain Dart classes (DTOs) that serve as the single source of truth for app settings, message structures, and server payloads across all platforms. Key additions include \settings.dart\ with over 50 reactive preference fields, \queue\_items.dart\ for typed outgoing message/reaction/attachment queues, \server\_payload.dart\ for handling encrypted and legacy server events, and \payload\_data.dart\ for URL previews and iMessage app data. It also introduces models for Find My device/friend locations, scheduled messages, and cross-platform file handling, enabling consistent data serialization and deserialization without ObjectBox annotations.

lib/database/global · high confidence

Introduces standardized layout and UI wrapper components

The app now uses a new set of reusable wrapper widgets in \lib/app/wrappers\ to standardize the user interface. \BBScaffold\ and \BBAnnotatedRegion\ handle consistent system UI overlay styling, window transparency, and safe area insets (including edge-to-edge support on Android). \BBAppBar\ provides a standardized header with desktop/mobile height variants and theme-aware defaults. \TabletModeWrapper\ enables a resizable split-view layout for chat lists and conversations on larger screens. \GradientBackgroundWrapper\ supports dynamic and custom chat wallpapers, while \ScrollbarWrapper\ improves desktop scrolling with middle-mouse-button support and custom cursors. Additional wrappers include \TitleBarWrapper\ for custom desktop window controls, \ThemeSwitcher\ for iOS/Material/Samsung skin switching, and utility wrappers for fade-on-scroll effects and macOS trackpad fixes.

lib/app/wrappers · high confidence

Introduction of Material You theme presets and adaptive background themes

The themes service now supports Material You design presets (including Vibrant, Expressive, Soft, Neutral, and various styles) and introduces per-chat adaptive themes that generate palettes based on the chat background. This change also includes a Linux-specific fix to defer dynamic color initialization until after the splash screen to prevent UI freezing, and ensures preset themes are refreshed to overwrite stale database values.

lib/services/ui/theme · high confidence

Native Linux desktop support with splash screen and build tooling

BlueBubbles now offers a native Linux desktop application. This release introduces the Linux runner codebase, including a GTK-based wrapper and a native splash screen that displays startup progress and version information while the Flutter engine initializes. The splash screen is designed to prevent empty-window flashes and includes a stall-detection mechanism that reveals a close button if the app hangs during startup. The package also includes the necessary CMake build configuration, a build script for generating release tarballs, and support for distribution via Flatpak and Snap.

linux · high confidence

Native support for notification replies, reactions, and auto-start

The app now handles notification replies and message reactions (likes/loves) directly from the notification shade using native Android code, ensuring these actions work even when the app is killed or the Flutter engine is not running. It also introduces an AutoStartReceiver to automatically restart the foreground service after a device reboot if the 'keep app alive' setting is enabled, and adds an ExternalIntentReceiver to support Tasker integration for retrieving the server URL.

android/app/src/main/kotlin/com/bluebubbles/messaging/services/intents · high confidence

New Advanced Settings panels for notifications, privacy, and automation

The Advanced Settings section now includes dedicated configuration panels for power users. You can manage Firebase Cloud Messaging (FCM) setup and toggling, choose between FCM and Unified Push as your notification provider, and configure the Unified Push endpoint (with a recommendation for nfty.sh). A new Redacted Mode panel lets you hide message content, avatars, and names in screenshots, with a live preview. Private API features are now centrally managed, allowing you to enable tapbacks, typing indicators, read receipts, and other server-side capabilities. Finally, a Tasker integration panel lets you send server events to Android automation tasks.

lib/app/layouts/settings/pages/advanced · high confidence

New Chat Stats page with detailed activity, engagement, and content analysis

A new Chat Stats page has been added to the conversation details layout, featuring a tabbed interface with Overview, Activity, Engagement, and Content sections. The Overview tab displays total message counts, streaks, and a balance bar. The Activity tab provides time-pattern analysis including peak hours, weekday/hour heatmaps, and calendar views. The Engagement tab tracks response times, conversation openers/enders, double-texting, and balance drift. The Content tab, which is gated behind an explicit user tap to analyze, reveals message length statistics, top words and emojis, reaction breakdowns, and attachment mixes. The page supports time-frame filtering and allows comparing individual participants against the group or each other.

_lib/app/layouts/conversation\details/pages · high confidence

New Contacts Management settings page

A new Contacts Management page has been added to the Settings area, providing a centralized place to manage contact synchronization. Users can now view and request device contact permissions, manually trigger contact syncs to match them with conversations, and export contacts to the desktop app. The page also supports filtering syncs by specific device accounts (e.g., WhatsApp, Google, Samsung) and displays diagnostic stats such as the number of device contacts found and conversations updated. This feature is available across iOS (Cupertino), Material, and Samsung UI skins.

lib/app/layouts/settings/pages/contacts · high confidence

New Dart-side Android bridge and intent handling services

This change introduces the Dart-side implementation of the Android method channel bridge and intent routing within the \java\_dart\_interop\ module. It adds \MethodChannelService\ to manage communication with the Kotlin backend (handling notifications, foreground service control, and server URL updates), \IntentsService\ to process Android intents such as share targets, notification deep links, and FaceTime call actions, and \BackgroundIsolate\ to support background execution when the app is killed. The update also includes \MethodChannelHandlers\ and \MethodChannelConstants\ to define and route inbound messages from Android, establishing the core connectivity layer for incoming messages and system events on Android.

_lib/services/backend/java\_dart\interop · high confidence

New Filesystem Service for unified path management and secure caching

A new FilesystemService has been introduced to centralize the resolution of platform-specific paths for attachments, cache, and temporary files, replacing scattered path logic. This service manages the attachment download pipeline (including per-GUID subdirectories) and handles file operations like copying, moving, and deletion. A key behavioral change is the implementation of SHA-256 content-addressed caching for URL preview images, which improves security against collision attacks and deduplicates identical images across messages. The service also includes specific initialization logic for MSIX (Microsoft Store) installations to ensure data is correctly located and migrated from previous non-MSIX versions, while providing a consistent API for desktop, mobile, and web platforms.

lib/services/backend/filesystem · high confidence

New Find My UI widgets for devices, friends, and items

This location introduces the UI components for the Find My feature, including an interactive map (findmy\_map\_widget.dart) and tabbed lists for your Apple devices, shared-location friends, and AirTag-style items. The list tiles and map popups now respect the redaction setting: when enabled, contact names and addresses are hidden (showing generic labels like 'Device', 'Item', or 'Contact'), and long-pressing a redacted entry no longer opens the raw data debug dialog. Tapping a list item focuses the corresponding marker on the map, and a 'Directions' button launches external maps for items that have a known location.

lib/app/layouts/findmy/widgets · high confidence

New Material 3 Expressive (M3E) component library

The app introduces a new set of UI components under the \lib/app/components/m3e\ directory to support the Material 3 Expressive design language. This library includes layout and styling primitives such as \M3ESection\ and \M3EListTile\ for structured content, \M3EButtonGroup\ and \M3ETonalButton\ for interactive actions, and \M3EStatTile\ for data display. It also provides foundational design tokens for consistent theming, including \M3EShapes\ for corner radii, \M3ESpacing\ for layout gaps, \M3ESlider\ for slider styling, and \M3EMotion\ for standardized animation curves and durations.

lib/app/components/m3e · high confidence

New Miscellaneous Settings panels for logging, troubleshooting, and data recovery

The Miscellaneous settings area now includes dedicated panels for managing application logs and diagnosing issues. Users can view and filter saved log files by severity (Info, Debug, Warning, Error) in the Logging panel, or monitor real-time debug output in the Live Logging panel. The Troubleshoot panel provides developer tools to reset the database, clear the cache, resync data, and manage battery optimization settings on Android. Additionally, a new Soft-Deleted Chats panel allows users to view and restore chats that were previously removed, and a Handle Audit panel helps diagnose and repair missing sender information for messages.

lib/app/layouts/settings/pages/misc · high confidence

New ObjectBox database schema for chats, messages, and contacts

The \lib/database/io\ directory now contains the native ObjectBox entity definitions for the app's core data model. This introduces new entities including \Chat\, \Message\, \Attachment\, \Handle\, \ContactV2\, \CustomGroup\, and \ThemeStruct\, along with supporting files for Firebase configuration (\FCMData\) and desktop autostart (\LaunchAtStartup\). The schema establishes a many-to-many relationship between \ContactV2\ and \Handle\ to support native contact integration and nicknames, and adds fields for custom chat themes and dynamic wallpapers. This change replaces the previous in-memory or legacy storage approach with a persistent, indexed ObjectBox database for non-web platforms.

lib/database/io · high confidence

New Setup Service for First-Run Server Connection

A new SetupService has been introduced to orchestrate the initial server connection flow during onboarding. This service validates the server URL, tests connectivity, stores credentials, and triggers the initial full data sync. It is designed to be used exclusively during the first-run setup process via the SetupView, after which the ServerInterface should be used for runtime operations.

lib/services/backend/setup · high confidence

New Storage Analyzer page in Settings

A new Storage Analyzer page has been added to Settings, allowing users to scan and reclaim on-device storage. The page features a filter bar to narrow results by specific chats or age, and displays a breakdown of storage usage by media type (photos, videos, audio, documents, thumbnails, orphaned files, and link previews) via a donut chart and segment rows. Users can select specific segments to delete, triggering a confirmation sheet that explains whether files will be re-downloaded or regenerated. The interface is implemented across three skins (Cupertino, Material M3 Expressive, and Samsung M3 Expressive) with consistent behavior: analysis runs on initial tap or filter change, and the view automatically refreshes after deletion to verify the change.

lib/app/layouts/settings/pages/storage · high confidence

New Theme Studio panel for granular theme customization

A new Theme Studio panel has been added to the settings, providing a dedicated interface for managing and editing application themes. This feature introduces a controller-driven UI that allows users to select from preset themes, edit color palettes and typography, and manage theme lists. It supports both global theme application and chat-scoped theming, enabling users to stage changes for preview before applying them to the live interface or specific chat contexts.

_lib/app/layouts/settings/pages/theming/theme\studio · high confidence

New Theme Studio widgets for color, typography, and theme management

The Theme Studio settings page now includes dedicated widgets for editing and managing themes. Users can edit individual color slots via a new \ColorEditorSection\ and \ColorEditorTile\ interface, which supports long-press copying of hex values and paired 'on' color editing. A \TypographyEditor\ widget allows selecting Google Fonts and adjusting master and per-style text sizes. Theme lifecycle actions (clone, rename, delete, export, import, generate from seed/image, and reset) are handled by \ThemeManagementSection\ and \PresetThemeDialogs\. A \ThemeSelectorSection\ (formerly \preset\_theme\_strip\) provides a deferred-rendering list of light/dark presets and custom themes, while \ThemePreviewCard\ offers a live, non-interactive mockup of the app's UI to visualize changes across iOS, Material, and Samsung skins.

_lib/app/layouts/settings/pages/theming/theme\studio/widgets · high confidence

New Theming & Visual Customization Settings Panel

A new dedicated settings panel for visual customization has been introduced, allowing users to manage app themes, skins, and layout options. Users can now switch between light, dark, and system themes, select from various app skins, and toggle tablet mode for split-view layouts on supported devices. The panel also includes controls for immersive mode (transparent navigation bars) and an avatar scale factor slider. Additionally, a link to the 'Theme Studio' is provided, enabling deeper customization of colors, fonts, and gradients through a dedicated editor interface.

lib/app/layouts/settings/pages/theming · high confidence

New UI helper library for theming, dialogs, and message rendering

The \lib/helpers/ui\ directory now contains a dedicated set of pure utility functions and small widget classes to standardize the UI layer. This includes \theme\_helpers.dart\ for hex color parsing, \BubbleColors\ theme extensions, and desktop window effects; \dialog\_helpers.dart\ providing skin-aware \showBBDialog\ and \showAreYouSure\ wrappers that render Cupertino dialogs on iOS and Material dialogs elsewhere; \message\_widget\_helpers.dart\ for consistent rich text rendering with emoji scaling, mention detection, and entity extraction; and specialized helpers for FaceTime call overlays, Find My redaction, and Google OAuth flows. These utilities replace scattered inline logic with reusable, skin-aware components.

lib/helpers/ui · high confidence

New advanced theming interface with custom font and color extraction support

The settings area now includes a dedicated Advanced Theming panel that allows users to create, select, and manage custom light and dark themes. This interface introduces a master font-scaling slider that applies uniformly across all font sizes, adds support for importing and using custom fonts via Google Fonts, and enables generating theme palettes from images (specifically triggering notification listener permissions for the 'Music Theme' presets). Users can also view and manage previously used themes through a new 'View Old' dialog.

lib/app/layouts/settings/pages/theming/advanced · high confidence

New app permissions setup page for contacts and notifications

A new 'App Permissions' page has been added to the setup flow, allowing users to view and request Contacts and Notifications permissions. The page dynamically handles platform-specific requirements (such as Android SDK 33+ for notifications) and prevents users from proceeding to the next step if required permissions are missing, prompting a confirmation dialog instead.

lib/app/layouts/setup/pages/permissions · high confidence

New backend-to-UI event bridge and desktop keyboard shortcuts

This change introduces a new \backend\_ui\_interop\ subsystem that decouples backend services from UI widgets using a singleton \EventDispatcher\ for one-shot cross-cutting events (e.g., 'chat-updated') and a set of Flutter \Intent\/\Action\ pairs for desktop keyboard shortcuts. Users gain consistent keyboard navigation and actions, including shortcuts to open settings, create new chats, search, cycle through chats, view chat details, trigger sync, and perform quick reactions (heart, like, dislike, laugh) or reply to the most recent message in a conversation.

_lib/services/backend\_ui\interop · high confidence

New background cache management with developer-tunable purge levels

The app now automatically shrinks in-process memory caches (decoded images, inline video players, adaptive themes, and Android engine resources) when the app is backgrounded or when the OS signals memory pressure. This behavior is controlled by two new developer settings: 'Cache Purge Background Level' (defaulting to 'light', which trims images to 25% and clears engine resources) and 'Cache Purge Memory Pressure Level' (defaulting to 'moderate', which clears everything except video players). A new 'Cache Tuning' page in Developer Tools allows you to adjust these levels, exclude specific caches, and manually trigger purges to observe memory impact.

lib/services/ui/cache · high confidence

New background isolate system for heavy operations

The app now offloads database reads/writes, sync, bulk processing, and message sending to dedicated background isolates. A persistent GlobalIsolate handles general work with a 5-minute idle timeout, while a lightweight IncrementalSyncIsolate handles sync tasks and terminates immediately after completion. This architecture prevents UI freezing during heavy operations and ensures sends survive backgrounding. The system uses a typed request/response model and supports event streaming (e.g., socket messages, sync progress) from the isolate back to the main thread.

lib/services/isolates · high confidence

New camera review screen with pinch-to-zoom and native quality preservation

Added a new full-screen camera review screen (Android only) that launches the native system camera via ImagePicker and presents the captured photo or video for review. The preview supports pinch-to-zoom and double-tap-to-zoom interactions, with options to retake or use the media. The implementation intentionally omits image quality settings to preserve native camera processing (HDR, computational photography) by returning the file exactly as the camera app wrote it.

lib/app/layouts/camera · high confidence

New centralized helpers barrel and documentation

A new \lib/helpers/helpers.dart\ barrel file has been introduced to provide a single import point for cross-cutting utilities, re-exporting network, type, UI, and backend helper modules. This change is accompanied by a new \CLAUDE.md\ documentation file that maps the internal structure of the helpers directory, clarifying which files are exported via the barrel and which must be imported directly (such as \attributed\_body\_helpers.dart\ and \facetime\_helpers.dart\).

lib/helpers · high confidence

The chat creator now uses a new set of sub-widgets to build the recipient selection interface. Users will see a horizontal scrollable row of selected contact chips (with iMessage/SMS styling) and a text input for adding recipients. Search results are displayed in a structured list with sections for existing conversations and address book contacts, allowing users to tap to add specific phone numbers or email addresses. A toggle switch lets users choose between iMessage and SMS forwarding, while a segmented control provides an alternative service type picker. These components support features like redacted mode (hiding contact info) and phone number formatting within the new chat creation flow.

_lib/app/layouts/chat\creator/widgets · high confidence

New chat selection interface with search and multi-select filtering

The chat selector view now provides a dedicated UI for selecting chats, supporting both single and multi-select modes. In multi-select mode, users can filter the chat list by 'All', 'Selected', or 'Unselected' status using chip controls, and a 'Done' button is available to confirm the selection. The interface includes a debounced search field that filters chats in real-time, and it pre-selects chats based on an initial list of GUIDs when in multi-select mode.

_lib/app/layouts/chat\_selector\view · high confidence

New chat statistics engine with comparison filters and detailed metrics

This change introduces a new chat statistics system that provides detailed analytics for conversations, including overview stats (total, sent, received, attachments, average per day, streaks), activity stats (hourly/weekday distribution, busiest day, night owl ratio), and engagement metrics. The system supports comparison filters, allowing users to analyze statistics for specific participants within group chats or compare against the whole group. It also includes new constants for session gaps, read receipt coverage thresholds, and response sample minimums to ensure data quality. The implementation uses a new query layer to fetch message timestamps and participant data, computing stats like correction rates and reaction matrices.

_lib/services/ui/chat/chat\stats · high confidence

New color engine for perceptually uniform theme generation

Added a new low-level color science layer in \lib/utils/color\_engine\ that powers the dynamic theme system. This engine implements color space conversions (Linear sRGB, sRGB, Oklab, Oklch, CIE XYZ) to perform perceptually-uniform color operations like mixing and lightening, replacing naive RGB blending. The \theme.dart\ module uses these conversions to derive complementary and harmonious colors from a user-chosen seed, generating neutral and accent color swatches that match AOSP/Google default lightness targets. This change provides the foundation for the revamped music theme and more accurate dynamic color generation across the app.

_lib/utils/color\engine · high confidence

A new \constants.dart\ file introduces mappings for iMessage expressive effects (such as Slam, Echo, and Confetti) and balloon bundle IDs for third-party iMessage apps like GamePigeon, YouTube, and Google Maps. It also defines a \LinkPreviewPolicy\ enum that allows users to restrict automatic link preview fetching to contacts only or disable it entirely, addressing privacy concerns regarding IP address disclosure. Additionally, the file includes enums for client-side message errors, UI skins, and message status indicators.

lib/helpers/types · high confidence

New contact selection interface with search and redacted mode support

The app now includes a dedicated ContactSelectorView that allows users to browse and select contacts from a scrollable list. This view features a search bar with debounced filtering to quickly find contacts by name or address, and it respects the application's redacted mode setting to hide contact details when enabled. Selecting a contact triggers the provided callback and closes the view.

_lib/app/layouts/contact\_selector\view · high confidence

New conversation details dialogs for participants, naming, and syncing

The conversation details panel now includes dedicated dialogs for managing group chats and message history. Users can add participants by phone number or email, rename group conversations, and manually resync chat history with a selectable time range (from 1 hour to all time). An address picker is also provided for contacts with multiple numbers, allowing users to choose which address to use for calls or messages and optionally remembering the selection.

_lib/app/layouts/conversation\details/dialogs · high confidence

New conversation list filters and custom group quick-chips

The conversation list now supports a comprehensive, combinable filtering system. Users can filter chats by read status (unread/all), sender type (known/unknown), chat type (group/direct), mute status, and service (iMessage/other). These filters combine with AND logic, allowing for precise views like 'unread group chats'. Additionally, a new quick-filter chip row appears above the chat list (when enabled) to toggle custom groups and an 'ungrouped' view directly, keeping the filter state synchronized with the main filter sheet. The system also persists these filter selections as defaults and restores them when toggling the ungrouped chip.

_lib/app/layouts/conversation\list/widgets/filters · high confidence

New custom Flutter widget overrides for platform consistency and error handling

This location introduces a set of custom Flutter widget overrides to standardize UI behavior and fix platform-specific issues. The new \CustomBouncingScrollPhysics\ reduces overscroll bounce on desktop environments. A custom \CupertinoAlertDialog\ wrapper is added to fix text-scaling issues and ensure proper dark/light mode theming. A \CustomCupertinoPageTransition\ provides an iOS-style slide animation with back-swipe support on Android. Finally, a \CustomErrorWidget\ (rendered via \CustomErrorBox\) offers a standardized, styled error display with a red border and icon, designed to be safely rendered even within slivers or unstable build states.

lib/app/components/custom · high confidence

New desktop settings panel for window behavior and startup options

A new DesktopPanel settings page has been added, allowing users to configure how the desktop application launches and behaves. Users can now enable 'Launch on Startup' and choose to start the app minimized to the system tray. On Linux, users can select the TitleBar Style (Native, Custom, or Hidden) to control window decorations and enable 'Minimize to Tray' functionality, which moves the app to the system tray instead of closing it when the window is minimized.

lib/app/layouts/settings/pages/desktop · high confidence

New extension methods and documentation for common type helpers

This change introduces a new barrel file and documentation for the \lib/helpers/types/extensions\ directory, consolidating extension methods for types like \String\, \DateTime\, \MessageError\, and \Chat\. Key additions include \Uri.hostMatches\ for secure subdomain-aware host matching, \String.withoutInvisibleFormatting\ to strip potentially spoofing invisible characters, and helpers for formatting stat counts and file sizes. It also adds error code mappings for \ClientMessageError\ and utility methods for date comparisons and chat list filtering, providing a centralized set of reusable utilities for the application.

lib/helpers/types/extensions · high confidence

New granular settings for attachments, conversations, and message composer

The message view settings now include dedicated panels for managing attachment behavior, conversation appearance, and composer controls. Users can configure auto-download options (including a new max concurrent downloads slider and an option to restrict downloads to Wi-Fi), adjust image preview quality, and set custom save locations for pictures and documents on mobile platforms. Conversation settings allow toggling delivery timestamps, chat name placeholders, avatar display, smart suggestions, and reply threading, while offering a segmented control to gate link preview fetching. A new reorderable panel lets users customize the order of message context-menu options, and a dedicated composer panel enables reordering and enabling/disabling the buttons that appear to the left of the message input field.

_lib/app/layouts/settings/pages/message\view · high confidence

New handle selector view for choosing chat addresses

Added a new HandleSelectorView that allows users to search and select a specific handle (address) for a chat. The view loads all available handles, sorts them alphabetically while prioritizing those with contact associations, and filters the list based on an existing chat's participants if applicable. It features a debounced search field that matches against both display names and addresses, and displays handle information (or fake names in redacted mode) in a list for selection.

_lib/app/layouts/handle\_selector\view · high confidence

New iMessage Profile settings panel

A new ProfilePanel screen has been added to the Settings layout, allowing users to view and edit their iMessage account details. Users can now update their display name via a dialog, manage their profile photo by cropping a new image or removing the current one, and view their account information fetched from the server. The panel includes a skeleton loader for better perceived performance and handles redacted modes for privacy.

lib/app/layouts/settings/pages/profile · high confidence

New iMessage-style send effects UI and playback

Users can now select and play visual send effects (balloons, confetti, fireworks, love, spotlight, lasers, celebration, and echo) when sending messages. This change introduces a new picker sheet (\send\_effect\_picker.dart\) for choosing effects and a full-screen overlay widget (\screen\_effects\_widget.dart\) that renders the animations on top of the conversation view. The implementation wires up the effect controllers to the message send flow, allowing effects to be triggered based on the selected style.

_lib/app/layouts/conversation\view/widgets/effects · high confidence

New iOS-native chat creator with service type selection and embedded previews

The chat creator now offers a new iOS-native interface (NewChatCreator) that lets users select a service type (iMessage, SMS, or RCS) via a segmented control, search for contacts and existing chats with debounced filtering, and preview messages from an existing chat within the creator before sending. The legacy multi-skin creator is retained as a deprecated reference, and the new flow supports sending to both new and existing chats with animated header transitions and proper state management.

_lib/app/layouts/chat\creator · high confidence

New keyboard handlers for text field interactions

This change introduces four new handler classes within the conversation view's text field to manage specific keyboard interactions. ClipboardPasteHandler now supports pasting GIFs from HTML clipboard data, local files, and images on desktop, with a fallback to text pasting for Windows and Linux. EmojiAutocompleteHandler and MentionAutocompleteHandler provide keyboard-driven navigation (Up/Down arrows, Tab/Enter, Escape) for selecting emojis and mentions respectively. Additionally, KeyboardShortcutHandler centralizes general shortcuts, enabling message sending via Enter on desktop/web, editing the last sent message with the Up arrow (when conditions are met), and switching focus between subject and message fields using Tab.

_lib/app/layouts/conversation\_view/widgets/text\field/handlers · high confidence

New media attachment filters bottom sheet

A new bottom sheet UI has been added to the conversation details view, allowing users to filter media attachments by sender (From You, From Others, or specific participants), media type (Images or Videos), and date range. This feature provides a dedicated interface for refining the displayed media content within a chat.

_lib/app/layouts/conversation\details/widgets/filters · high confidence

New metadata dialog for media attachments

Users can now view detailed metadata for media attachments via a new dialog. This feature displays key information such as filename and MIME type, along with any additional metadata fields available for the attachment, presented in a scrollable list within a styled dialog box.

_lib/app/layouts/fullscreen\media/dialogs · high confidence

New native foreground service for persistent background connectivity

The app now uses a new native Android foreground service (SocketIOForegroundService) to maintain a persistent connection to the BlueBubbles server in the background. This service handles socket reconnection, displays status notifications (connected, disconnected, reconnecting, or error states), and supports custom HTTP headers for server authentication. It also includes a fix for a crash caused by malformed server URLs in preferences, ensuring the service fails gracefully rather than crashing the app.

android/app/src/main/kotlin/com/bluebubbles/messaging/services/foreground · high confidence

New native utility classes for file handling, logging, and settings

The app now includes new Kotlin utility classes in the messaging utils package: FilesystemUtils for resolving file paths from URIs, PersistentLog for writing native logs to a persistent file that is included in app log exports, SettingsHelper for accessing Flutter SharedPreferences from Kotlin, and Utils for handling adaptive icons and server URL retrieval. These changes support improved file handling, better log exportability, and more flexible settings access.

android/app/src/main/kotlin/com/bluebubbles/messaging/utils · high confidence

New notification settings panel with platform-specific controls

A new NotificationPanel page has been added to the system settings, providing users with granular control over notification behavior. The panel includes toggles for sending notifications while in the chat list, notifying for reactions, and enabling text detection with whitelisted phrases. It also features an option to hide message text previews in notifications and a setting to show a toast when incremental sync completes. Platform-specific controls are included: web users can request notification permissions directly, while mobile users can enable quick reaction buttons from notifications (requiring Private API) and select the reaction type.

lib/app/layouts/settings/pages/system · high confidence

New reaction type picker and consolidated settings widget exports

A new \ReactionTypePicker\ widget has been added to the settings interface, allowing users to select reaction types via a modern menu or custom list in Private API and Notification settings. Additionally, the \settings\_widgets.dart\ barrel file now exports the full suite of settings-specific UI components (dropdowns, sliders, switches, tiles, headers, dividers, and scaffolds), centralizing access to these layout elements for the settings pages.

lib/app/layouts/settings/widgets · high confidence

New reactive contact and group avatar widgets

The app now uses dedicated \ContactAvatarWidget\ and \ContactAvatarGroupWidget\ components for rendering avatars. Single-contact avatars display profile photos or initials with a deterministic gradient, while group avatars stack up to four contacts in a circular layout. These widgets are reactive, automatically updating when participant lists or custom avatar paths change via \ChatStateScope\, and support custom color overrides and redacted mode settings.

lib/app/components/avatars · high confidence

New reply threading UI with quoted bubbles and thread views

The conversation view now supports reply threading. A new quoted reply bubble displays the sender name and a snippet of the original message (text or attachment thumbnail); tapping it scrolls the conversation to the source message. On iOS, vertical thread connector lines visually link related replies. Tapping the reply-count badge opens a full-screen thread popup showing all messages in the thread, with navigation to jump to specific messages and consistent theming applied across the popup.

_lib/app/layouts/conversation\view/widgets/message/reply · high confidence

New reusable UI component library and documentation

This change introduces a new set of reusable UI components and a CLAUDE.md documentation file to standardize the app's interface. Key additions include skin-aware controls that adapt to the user's theme (BBSwitch for toggles, BBSlider for sliders, and BBChip for tags), a dynamic AnimatedDropdownMenu that intelligently positions itself to avoid screen clipping, and a CopyAddressButton with platform-specific feedback. The update also adds a DonutChart with interactive legend filtering, StatTile and StatTileGrid for KPI displays, SectionSkeleton for loading states, and an ImageBlurCanvas for media previews. Additionally, custom text editing controllers now support mention detection and emoticon replacement, while a SliverDecoration provides rounded headers for scrollable lists.

lib/app/components · high confidence

New reusable settings tile components and documentation

The settings UI now uses a standardized set of building blocks located in \lib/app/layouts/settings/widgets/content\. This includes \SettingsTile\ (with optional active-page highlighting for tablet split-view), \SettingsSwitch\, \SettingsOptions\ (dropdowns/segmented controls), \SettingsSlider\, \SettingsLeadingIcon\, \SettingsSubtitle\, \NextButton\, \AdvancedThemingTile\ (for color picking), and \LogLevelSelector\. A \CLAUDE.md\ guide documents how to compose these widgets for consistent settings pages.

lib/app/layouts/settings/widgets/content · high confidence

New scheduled messages and message reminders management in Settings

Users can now create, view, edit, and delete scheduled messages and message reminders directly from the Settings page. The feature includes a dedicated panel for scheduled messages (supporting one-time and recurring schedules with platform-specific UI skins for iOS, Material, and Samsung) and a separate panel for message reminders. The UI provides an overview of pending, recurring, and completed messages, allows selecting target chats, entering message content, and setting dates/times, with validation to prevent scheduling in the past or with empty fields.

lib/app/layouts/settings/pages/scheduling · high confidence

New server connection status panel with platform-specific UIs

The server management settings now feature a dedicated connection panel that displays real-time status for the API, Socket, Private API, and Helper Bundle, along with server details like version, URL, and latency. This panel is implemented with three distinct visual themes—Cupertino, Material, and Samsung—allowing the interface to adapt to the user's preferred platform style while providing a consistent view of connection health and server information.

_lib/app/layouts/settings/pages/server/connection\panel · high confidence

New server management, backup/restore, and OAuth settings panels

The server settings area now includes dedicated panels for managing the server connection, handling backups and restores, and configuring Google OAuth. The server management panel displays connection status, latency, and iMessage statistics (fetched from the server or local database), and allows users to restart the server. The backup and restore panel lets users save and load settings and themes to local storage or the cloud, with support for restoring pinned chats and custom groups while handling name collisions and missing chats gracefully. The OAuth panel enables signing in with Google to connect to a cloud relay, including project selection and connection testing.

lib/app/layouts/settings/pages/server · high confidence

New settings dialogs for themes, headers, and notifications

The settings area now includes dedicated dialogs for managing custom HTTP headers, creating and viewing themes, and configuring chat-specific notification rules. Users can add, edit, and delete custom headers that are applied to network requests, create new themes based on the current color scheme, and view or delete old theme definitions. The notification settings dialog allows users to mute individual chats, mute specific participants in group chats, set temporary mutes with a date/time picker, and enable text detection to bypass mutes for messages containing specific keywords.

lib/app/layouts/settings/dialogs · high confidence

New settings for chat list appearance, filtering, and pinned chat ordering

The Conversation List settings page now includes controls for chat list behavior and appearance. Users can toggle a sync indicator, message status indicators, filtered chat lists, and filtering for unknown senders. On non-web platforms, chats can be set to automatically unarchive when a new message arrives. Appearance options allow hiding dividers and enabling dense conversation tiles. Additionally, a new 'Pinned Chat Order' panel lets users drag-and-drop to reorder pinned chats, with a reset option available.

_lib/app/layouts/settings/pages/conversation\list · high confidence

New settings pages for managing custom avatars

The settings interface now includes dedicated pages for customizing avatars. Users can set or change their own profile picture via a new image picker and circular crop tool. Additionally, a 'Custom Avatars' list allows users to select any chat and assign a unique image, with the option to reset existing custom images. A separate 'Custom Avatar Colors' panel displays handles that have been assigned specific colors, providing a centralized view of these personalization settings.

lib/app/layouts/settings/pages/theming/avatar · high confidence

New setup checks for battery optimization and macOS server configuration

The setup flow now includes dedicated checks for critical prerequisites. On Android, a new Battery Optimization check allows users to verify and disable battery optimizations for BlueBubbles to ensure reliable notification delivery, with a direct link to settings if needed. For macOS users, a new Setup Check page provides instructions to ensure the BlueBubbles Server is installed and iMessage is signed in, with a button to open the official installation guide.

_lib/app/layouts/setup/pages/setup\checks · high confidence

New setup page template and documentation

Added a new \CLAUDE.md\ file documenting the structure and flow of the first-run server connection setup steps (welcome, permissions, checks, sync). Introduced \page\_template.dart\, which provides a reusable \SetupPageTemplate\ widget for these steps, featuring a consistent layout with title/subtitle wrappers, custom content areas, and navigation buttons driven by the \SetupViewController\.

lib/app/layouts/setup/pages · high confidence

New startup screens for app initialization and error handling

The app now includes dedicated startup screens: a splash screen that displays the app icon while services initialize and transitions to the setup or conversation list, and a failure screen that displays error details and stack traces if a fatal startup error occurs.

lib/app/layouts/startup · high confidence

New structured logging system with file rotation and configurable levels

The application now uses a dedicated logging utility (lib/utils/logger) that writes logs to rotating files (5 MB per file, keeping up to 5 rotated files) and optionally to the debug console in development mode. Users can configure the log level (INFO, WARN, ERROR, DEBUG, TRACE, FATAL) via settings, and the system automatically adapts output based on the environment (e.g., no file output on web, console-only in debug). The logger also includes a task logger for async operations, ensuring errors and warnings from background tasks are captured with stack traces.

lib/utils/logger · high confidence

New structured settings page with search and tablet support

The settings interface has been restructured into a new layout featuring a dedicated search bar that filters options by title and tags, with breadcrumb navigation for matches. This change introduces a split-pane design for tablet and desktop modes, allowing users to browse settings categories on the left while viewing details on the right. The page now includes a navigation observer to manage state when returning from sub-pages and supports deep-linking to specific settings sections via an initial page parameter.

lib/app/layouts/settings · high confidence

New system integration handlers for Android

This update introduces a suite of new Android native handlers in the system services layer, enabling the app to interact more deeply with the operating system. Users can now save files directly to the system Downloads folder (handling both scoped storage on Android 10+ and legacy storage on older versions), launch URLs in Chrome Custom Tabs, and initiate Google Duo video calls. The app can also open the native contact form for new or existing contacts, create calendar events, and manage conversation-specific notification settings (including bubbles and DND bypass on Android R+). Additionally, it adds support for creating dynamic share targets for the Android share sheet and detecting if the device is running ChromeOS.

android/app/src/main/kotlin/com/bluebubbles/messaging/services/system · high confidence

New utility modules for encryption, emoji, file handling, and Windows window effects

The lib/utils directory now includes several new pure utility modules. crypto\_utils.dart provides AES encryption and decryption compatible with CryptoJS formats. emoji.dart and emoticons.dart add support for Unicode emoji queries and text emoticon-to-emoji conversion. file\_utils.dart introduces helpers for revealing files in the system file manager (with specific handling for Flatpak), moving files, saving files, and fixing GIFs with zero delay. media\_kit\_hot\_restart\_fix.dart and its web stub address a hot-restart crash on desktop by clearing leaked mpv wakeup callbacks. share.dart centralizes sharing logic for files, text, and locations, including location preview metadata fetching. string\_utils.dart adds phone number cleansing. window\_effects.dart manages Windows-specific window transparency effects (Mica, Acrylic, Aero, etc.) with version-aware feature gating.

lib/utils · high confidence

Redesigned conversation details page with multi-select and filtering

The conversation details view has been rewritten to support multi-selecting and downloading attachments directly from the chat info panel. The layout now includes dedicated sections for shared media, links, locations, and documents, each featuring advanced filtering options such as date range, sender, and media type (photos vs. videos). The UI adapts to the user's theme setting, offering a standard iOS-style view or a Material 3 Expressive design with per-chat theming and a hero avatar header.

_lib/app/layouts/conversation\details · high confidence

Redesigned setup flow with QR scanning and Google authentication

The setup process for connecting to a BlueBubbles server has been restructured into a multi-step wizard. Users can now scan a QR code displayed on their server to automatically populate connection details, or manually enter the server URL and password. For users with a Google account, the new flow supports Google OAuth to automatically discover and select the correct Firebase project and server URL, simplifying the initial connection. The sync configuration page now offers granular controls for message count, time filters, and options to skip empty chats or sync group icons, while the completion screen provides a direct shortcut to restore backups after the sync finishes.

lib/app/layouts/setup/pages/sync · high confidence

Redesigned welcome page with confetti and bubble previews

The welcome screen now features a new layout that includes a confetti animation effect and visual previews of message bubbles (both sent and received) to demonstrate the app's iMessage-like interface. The page also preserves animation behavior by using AnimationBehavior.preserve to ensure animations are not overridden by system animation scale settings.

lib/app/layouts/setup/pages/welcome · high confidence

Reintroduced Firebase Cloud Messaging and database integration

The app now supports receiving push notifications via Firebase Cloud Messaging (FCM) and integrates with Firebase for server configuration and state management. This change re-adds FCM support, allowing the app to receive remote messages and handle Tasker events. It also introduces handlers to fetch the server URL from either Cloud Firestore or Realtime Database, listen for server URL changes in the background, and update the next restart time in the database. The implementation includes logic to dynamically initialize Firebase with user-provided credentials and reinitialize if the configuration changes mid-session.

android/app/src/main/kotlin/com/bluebubbles/messaging/services/firebase · high confidence

Rewritten attachment rendering system with dedicated media widgets

The attachment display logic in conversation bubbles has been completely refactored into a new, modular widget structure. A central \AttachmentHolder\ now acts as the entry point, dispatching to specialized renderers based on MIME type. This introduces dedicated widgets for \ImageViewer\ (with improved gallery fan layouts and Live Photo support), \VideoPlayer\ (with custom controls and desktop support), \AudioPlayer\ (with waveform visualization and transcripts), \ContactCard\, and \StickerHolder\. The new system also includes a generic \OtherFile\ renderer for documents and archives, and a \LivePhotoMixin\ to handle the complex download and playback lifecycle of Live Photos. This change replaces the previous monolithic or fragmented attachment handling with a consistent, type-safe architecture that improves performance, reduces layout shifts during downloads, and supports new media types like audio transcripts and Live Photos.

_lib/app/layouts/conversation\view/widgets/message/attachment · high confidence

Architecture

Backend service architecture rewritten with dedicated message handlers

The backend service layer has been restructured to use dedicated, explicit handlers for message flow. A new ActionHandler routes server events (such as new messages, updates, and FaceTime calls) to specialized services: IncomingMessageHandler manages the inbound pipeline with deduplication, out-of-order buffering, and chat hydration, while OutgoingMessageHandler manages the outbound pipeline with a serial queue, pre-send preparation, and progress tracking. Additionally, WebListeners provide a stream-based replacement for database listeners on the web platform to ensure message and chat updates are correctly propagated.

lib/services/backend · high confidence

Conversation view pages restructured with dedicated handlers and controllers

The conversation view entry points have been reorganized into a cleaner architecture: \ConversationView\ now acts as the outer container managing the \ConversationViewController\ (handling text field state, replies, and attachments), while \MessagesView\ is a distinct scrollable list component that receives the controller from its parent. Orchestration logic previously embedded in the widgets has been extracted into a \handlers/\ directory, introducing \DropZoneManager\ for desktop drag-and-drop, \MessageAnimationOrchestrator\ for message list animations, and \SmartRepliesManager\ for managing suggestion states. This separation ensures that the message list and text input components are decoupled from the high-level routing and layout concerns, improving maintainability and performance by caching stable widget subtrees.

_lib/app/layouts/conversation\view/pages · high confidence

Introduce modular HTTP API service layer

The HTTP API client has been restructured into a modular service layer under \lib/services/network/api\. A new \BaseApi\ abstract interface defines the shared request contract (using Dio) to prevent circular imports, and specific domain sub-services—such as \ChatApi\, \MessageApi\, \AttachmentApi\, \ServerApi\, and others—are now implemented as distinct classes. These sub-services are exposed as named properties on the main \HttpService\, providing a cleaner, organized way to interact with server endpoints for chats, messages, attachments, backups, contacts, and more.

lib/services/network/api · high confidence

Introduces an isolate-based interface layer for backend operations

The application now routes all backend operations—such as chat, message, contact, attachment, and storage management—through a new set of interface classes in \lib/services/backend/interfaces\. These interfaces act as the single public entry point for the service layer, ensuring that heavy work (database writes, file I/O, network requests) is offloaded to the \GlobalIsolate\ (or a dedicated \IncrementalSyncIsolate\ for sync tasks) to keep the UI responsive. The interfaces handle the serialization of arguments into maps, dispatching to the isolate, and hydrating the returned IDs back into full model objects on the main thread. This architectural change improves performance and stability by preventing UI jank during background tasks and ensuring that in-flight operations survive app backgrounding.

lib/services/backend/interfaces · high confidence

Isolate-based backend action architecture

The backend service layer has been restructured to run database operations in a background isolate. New action classes (e.g., ChatActions, MessageActions, ContactV2Actions) now handle data persistence and retrieval using serializable maps, which improves UI responsiveness by preventing main-thread blocking during heavy I/O tasks.

lib/services/backend/actions · high confidence

Major application architecture overhaul and code cleanup

The application has undergone a significant structural refactor, replacing the previous entry point and basic UI scaffolding with a comprehensive initialization system. The old \conversation\_list.dart\ and \conversation\_view.dart\ files, which contained hardcoded mock data and basic layouts, have been removed in favor of a new, modular architecture defined in \CLAUDE.md\. This new structure organizes the codebase into distinct layers: \app/\ for UI widgets and screens, \services/\ for business logic and state, \database/\ for persistence, and \helpers/\ and \utils/\ for utilities. The \main.dart\ file now implements a robust startup sequence that initializes services, handles desktop-specific window management (including tray integration and title bar styles), manages splash screen status updates, and sets up environment configurations via \env.dart\. This change represents a shift from a simple prototype-like structure to a production-ready, scalable architecture with proper separation of concerns.

lib · high confidence

Refactored message composer into modular widget components

The message composer in the conversation view has been restructured from a monolithic implementation into a set of distinct, composable widgets. The new layout includes a main orchestration entry point, a local controller for internal state (drafts, typing indicators, selection), and dedicated components for the icon bar, send button, reply preview, and picked attachments. This change also introduces platform-specific buttons (camera, emoji, location) and dedicated handlers for clipboard pasting, emoji/mention autocomplete, and keyboard shortcuts, improving code organization and maintainability.

_lib/app/layouts/conversation\_view/widgets/text\field · high confidence

Restructured service architecture with new barrel exports

The service layer has been reorganized into distinct subsystems (backend, network, UI, backend-UI interop, and isolates) to improve modularity. A new \services.dart\ barrel file now centrally exports all service interfaces, including specific updates like the merge of \GlobalChatService\ into \ChatsService\ and the replacement of \MessageUpdateCoordinator\ with \MessageState\. This change simplifies how other parts of the application import and access these services via the new unified entry point.

lib/services · high confidence

Behavioural changes

10 commits (0 fixes) modifying scripts

A change to existing behaviour in scripts — 10 commits, 3 files: “Move the re-versioning into a separate job”; “script for quick fixing dart issues”; “Only use test version number on manual runs”; and 7 more.

scripts · medium confidence · unverified

10 commits (1 fix) modifying android

A change to existing behaviour in android — 10 commits (1 fix), 5 files: “chore: upgrade android build to agp 9.4 and kotlin 2.4”; “initial commit”; “chore: fix target sdk”; and 7 more.

android · medium confidence · unverified

10 commits (2 fixes) modifying lib/app/layouts/conversation\_details/material

A change to existing behaviour in lib/app/layouts/conversation\_details/material — 10 commits (2 fixs), 5 files: “Fix navigation issues in tablet mode”; “feat: add dynamic wallpaper support for chat backgrounds”; “Update snackbar callsites”; and 7 more.

_lib/app/layouts/conversation\details/material · medium confidence · unverified

3 commits (0 fixes) modifying windows/signpath

A change to existing behaviour in windows/signpath — 3 commits, 5 files: “Update dlls”; “Sign the Google DLLs”; “Add artifact config generator and PR check for changed DLLs”.

windows/signpath · medium confidence · unverified

Android messaging layer rewritten with UnifiedPush support and improved engine lifecycle management

The Android messaging component has been completely rewritten to improve stability and notification handling. A new \UnifiedPushReceiver\ now handles incoming push notifications via the UnifiedPush protocol, forwarding them to background workers and optionally forwarding events to Tasker. The core \MainActivity\ and new \BubbleActivity\ now manage the Flutter engine lifecycle with explicit readiness checks and synchronization to prevent race conditions during startup and destruction. Additionally, \MainActivity\ includes robust error handling for Firebase Firestore exceptions and ensures the foreground service is restarted via broadcast intent if the app is destroyed by the system while 'keep alive' is enabled.

android/app/src/main/kotlin/com/bluebubbles/messaging · high confidence

Android minimum SDK version raised to 23

The application now requires Android 6.0 (API level 23) or higher to run, replacing the previous minimum requirement of API level 21. This change aligns with the rewrite of the Android codebase and ensures compatibility with modern Android features and security standards.

android/app/src/main/kotlin/com/bluebubbles/messaging/models, android/app/src/main/kotlin/com/bluebubbles/messaging/services/filesystem · high confidence

Attachment picker rewritten for improved performance and reliability

The media picker UI in the conversation view has been completely rewritten to optimize performance and fix longstanding issues. The new implementation uses file-path-based rendering instead of loading full image bytes into memory, which significantly reduces memory usage and improves scrolling performance in the photo library grid. It also introduces better handling of incompatible image formats (HEIC/HEIF/TIFF) by converting them to compatible formats on the fly, and adds a dedicated video thumbnail generation service to replace an unmaintained library. Additionally, the picker now correctly requests storage permissions before opening, fixes bugs related to duplicate recent photos and attachment ordering, and ensures the UI properly respects redacted mode settings.

_lib/app/layouts/conversation\_view/widgets/media\picker · high confidence

Centralized message list management via MessagesServiceMixin

The conversation view now uses a new \MessagesServiceMixin\ to manage message state and UI updates. This mixin centralizes the initialization, disposal, and callback handling (new, updated, deleted, jump-to) for the \MessagesService\, ensuring that message controllers are properly linked to the conversation view controller. It also handles ownership transfer to prevent crashes when multiple views for the same chat exist (e.g., via notification taps) and provides methods for loading message chunks and creating message states, replacing direct subscriptions in widget \initState\ with a unified, lifecycle-aware approach.

_lib/app/layouts/conversation\view/mixins · high confidence

Centralized navigation service with tablet split-screen support

The app now uses a dedicated \NavigatorService\ (exposed as \NavigationSvc\) to handle all navigation, replacing direct calls to \Navigator.of(context)\. This service provides a unified entry point for route management, enabling consistent analytics, logging, and context-independent navigation. It introduces specific support for tablet and desktop layouts, including split-screen views where the chat list, chat detail, and settings can occupy separate panes. The service manages active state for these panes, allowing features like highlighting the active settings tile and handling complex back-navigation logic across multiple nested navigators in landscape mode.

lib/services/ui/navigator · high confidence

Conversation list pages rewritten for iOS, Material, and Samsung skins

The conversation list UI has been completely rewritten to provide distinct, skin-specific experiences for iOS (Cupertino), Material, and Samsung designs. This change introduces dedicated page implementations for each skin, managing their own scroll controllers, headers, and footers. Key behavioral updates include the removal of chat list dividers in Material mode, the addition of a custom group filter chip row, and improved handling of pinned chats with specific layout logic for avatar-only views and scroll snapping on Samsung devices. The new structure also ensures proper back-navigation behavior via PopScope and updates the floating action button placement based on the active skin and context.

_lib/app/layouts/conversation\list/pages · high confidence

Conversation list tiles rewritten with reactive skins and new pinned layout

The conversation list tile system has been completely rewritten to use a reactive controller (\ConversationTileController\) that drives three distinct visual skins (Material, Cupertino, Samsung) via \ThemeSwitcher\. This change introduces a new horizontal layout for pinned chats (\PinnedConversationTile\) featuring a text preview bubble (\PinnedTileTextBubble\) and drag-and-drop reordering support (\DraggableConversationTile\). Swipe actions are now handled by a generic \ListItem\ wrapper for Material skins, while the new architecture ensures consistent reactive updates for highlights, unread states, and message previews across all platforms.

_lib/app/layouts/conversation\list/widgets/tile · high confidence

Database layer reorganized into lib/database with version 9 schema

The data persistence code has been consolidated into the new \lib/database\ directory, introducing a structured platform abstraction for ObjectBox entities (mobile vs. desktop) and shared DTOs. The database schema version has been bumped to 9, and the initialization logic now includes explicit checks to clear database boxes if the app setup is not finished, preventing data corruption from incomplete configurations. Additionally, the migration system is updated to handle version 9 transitions, and the codebase now exports a unified set of models from this new location.

lib/database · high confidence

Database migrations now show progress on the splash screen

When the app starts and needs to run database schema migrations (such as updating message-handle relationships or backfilling chat latest messages), the splash screen now displays a progress bar indicating how far along the migration is. This prevents the splash screen from timing out or appearing stalled during large database updates, providing visual feedback that the app is working.

lib/database/migrations · high confidence

Disabled new API payload parser implementation

The new \ApiPayloadParser\ class in \lib/utils/parsers/event\_payload\ has been commented out, effectively disabling the ability to parse the new server payload type. While the code defines logic to handle legacy versus new payloads and enrich messages, chats, attachments, and handles, the actual parsing methods for chats, attachments, and handles are currently stubbed with TODOs and return empty results. This revert removes the active integration of this new parsing capability.

lib/utils/parsers · high confidence

Firebase services refactored with FCM disable toggle and improved error handling

The Firebase integration layer has been rewritten to improve reliability and user control. A new setting now allows users to disable FCM registration entirely, preventing unnecessary registration attempts and associated error banners when FCM is not in use. The FCM registration flow includes better error handling, such as retrying authentication with fresh server-provided credentials if the initial attempt fails, and specific handling for devices without Google Play Services. Additionally, the Firebase Database service now supports fetching server URLs via the database on web and desktop platforms, providing a fallback relay channel for message delivery when the direct socket connection is unavailable.

lib/services/network/firebase · high confidence

The Links section in conversation details now supports full-page search, allowing users to filter link previews by domain, title, or description with relevance-based sorting. The search helper introduces a scoring algorithm that prioritizes domain matches over titles and descriptions, and handles edge cases like Apple Music links where the URL is embedded in a specialization blob. The UI now displays link previews in a grid layout with proper loading states and infinite scroll for the full-page view.

_lib/app/layouts/conversation\details/widgets/sections/links · high confidence

Introduce dedicated reaction display widgets with platform-specific styling and animations

The conversation view now uses a new set of widgets (\ReactionWidget\, \ReactionHolder\, \ReactionClipper\) to render tapback reactions. This change implements platform-specific visual styles: iOS reactions appear as solid circles without borders, while Material and Samsung skins display solid circles with borders. Reactions are positioned as overlays on the message bubble, with tail directions adjusted based on whether the message is sent or received. The implementation includes an animation for new reactions appearing (pop-in effect) and handles state updates reactively via \MessageState\. It also supports viewing reaction details in a slide-up panel and ensures proper rendering in contexts like pinned tiles by resolving message state explicitly.

_lib/app/layouts/conversation\view/widgets/message/reaction · high confidence

Introduce dedicated type-specific helper utilities

This change introduces a new set of pure utility functions in the helpers directory to standardize common operations across the app. Users will benefit from more reliable phone number formatting via the dlibphonenumber library, improved timestamp display that correctly respects 24-hour settings and chat skins, and safer file handling with robust filename sanitization. Additionally, message rendering is enhanced with better emoji support and text sanitization for ML Kit features, while contact display logic now prioritizes nicknames and native contacts more effectively.

lib/helpers/types/helpers · high confidence

Introduces reactive state wrappers for chats, messages, and attachments

The app now uses dedicated state classes (ChatState, MessageState, AttachmentState, and HandleState) that mirror database entities as granular reactive observables. This allows UI widgets to subscribe to specific fields—such as unread counts, delivery/read indicators, attachment transfer progress, and redacted-mode display names—so that only the relevant parts of the interface rebuild when data changes. Each state is exposed via an InheritedWidget scope (ChatStateScope, MessageStateScope, etc.) and is owned by its corresponding service (ChatsService, MessagesService, HandleService), ensuring that UI code never writes directly to the state but instead routes updates through service methods.

lib/app/state · high confidence

Message view UI and interaction overhaul

The message rendering system has been significantly restructured to improve reliability and user experience. A new modular widget architecture (documented in CLAUDE.md) separates concerns into specialized components for text, attachments, reactions, replies, and timestamps, replacing the previous monolithic implementation. This refactor introduces a robust send animation that correctly handles dynamic layout changes (such as typing indicators and smart replies) to prevent visual glitches. Additionally, the update adds support for viewing past message edits, improves the accuracy of reply line rendering and thread connections, fixes issues with multi-part message replies, and enhances the reaction details popup to display user avatars and names.

_lib/app/layouts/conversation\view/widgets/message · high confidence

New chat list and conversation state services with animation-safe message updates

This change introduces a new service layer in \lib/services/ui/chat\ to manage chat list state and conversation view logic. \ChatsService\ now acts as the central source of truth for chat states, handling reactive sorting, unread counts, and filter application (including unread, sender, and type filters) via a \chatListVersion\ counter to trigger UI updates. \ConversationViewController\ manages per-chat UI state, including text input, media caching, and reply/editing contexts. A key behavioral addition is \MessageListGate\, which defers message list mutations during send animations to prevent visual glitches where the animation target shifts mid-flight; this ensures the send bubble lands correctly without blocking the send itself.

lib/services/ui/chat · high confidence

New conversation list floating action button and initial state widget

The conversation list now features a new floating action button (FAB) implementation that adapts to the user's selected skin (iOS, Samsung, or Material). On iOS and Samsung skins, the FAB includes a camera option if enabled, while the Material skin adds a scroll-to-top button that appears when scrolling up. Additionally, a new initial state widget displays a "Select a chat from the list" message when no chat is selected, with background transparency that respects the user's window effect settings.

_lib/app/layouts/conversation\list/widgets · high confidence

The app now uses a dedicated full-screen media viewer for images and videos, replacing the previous implementation. This new viewer supports full-screen gallery paging with pinch-to-zoom and keyboard arrow navigation when viewing attachments within a chat, while also providing a single-item preview mode for picked attachments in the composer. It includes improved video playback with HDR-to-SDR color pipeline fixes on Android, live photo support, and consistent behavior across mobile, desktop, and web platforms.

_lib/app/layouts/fullscreen\media · high confidence

New message state management service

The message UI layer now uses a dedicated \MessagesService\ to manage per-chat message state, replacing the previous approach where widget controllers handled state locally. This service maintains a central map of \MessageState\ objects keyed by message GUID, providing granular reactivity through an update trigger map so widgets can efficiently rebuild only when specific messages change. It handles message insertion, updates, and lifecycle management, ensuring that UI components like reply bubbles and delivery indicators reflect the current state immediately and consistently.

lib/services/ui/message · high confidence

New network utility helpers for server address normalization, error handling, and localhost detection

The \lib/helpers/network\ directory now provides a dedicated set of network utility functions. \network\_helpers.dart\ introduces \sanitizeServerAddress\ to normalize server URLs (handling schemes and tunnel providers) and \isValidServerAddress\ to validate LAN hostnames and IPs. \network\_error\_handler.dart\ centralizes send-failure classification, mapping HTTP status codes and \DioException\ types to specific error messages and codes for UI display. \network\_tasks.dart\ adds \onConnect\ to trigger incremental syncs upon reconnection and \detectLocalhost\ to automatically find and switch to a local server address using server-reported IPs or a throttled subnet port scan, with results synced to background isolates. \metadata\_helper.dart\ serves as the entry point for URL preview metadata fetching, enforcing a \LinkPreviewPolicy\ (never, always, or contacts-only) to gate automatic fetching based on the message sender.

lib/helpers/network · high confidence

New optimized reactive tiles for Connection, Private API, and Redacted Mode settings

The settings interface now includes dedicated, optimized reactive widgets for Connection & Server status, Private API Features, and Redacted Mode. These new tiles display real-time status indicators (such as Connected/Disconnected states or Enabled/Disabled toggles) and provide direct navigation to their respective configuration panels. Additionally, a new dialog widget has been added to display contact upload progress with a visual progress bar and completion status.

lib/app/layouts/settings/widgets/tiles · high confidence

New server connection flow with improved error handling and accessibility

The setup dialog now features a dedicated 'Connecting...' state that monitors the socket service to reliably detect connection success or failure, replacing the previous immediate feedback mechanism. If the connection fails, users are presented with a specific 'Failed To Connect' dialog with clear instructions. The manual entry dialog has been updated to support keyboard navigation (Tab/Shift+Tab) between the URL and password fields, includes autofill hints for password managers, and automatically strips trailing slashes from server URLs. Additionally, HTTP URLs are now explicitly blocked on web platforms, and LAN hostnames without top-level domains are accepted.

lib/app/layouts/setup/dialogs · high confidence

New structured onboarding flow with platform-specific checks and sync configuration

The setup layout has been restructured into a multi-step onboarding wizard (\setup\_view.dart\) that guides users through platform-specific permission checks (macOS permissions, Android battery optimization), contact and notification permission requests, server connection (via QR code or manual entry), and initial sync configuration (message count, time filter, group icons). The flow is orchestrated by \SetupViewController\ and includes recovery dialogs for connection or scanning failures. This change introduces a new, more robust entry point for first-time setup, replacing the previous ad-hoc setup logic with a standardized, page-based experience.

lib/app/layouts/setup · high confidence

New text bubble widget with animated effects and colorful bubble support

The conversation view now uses a dedicated \TextBubble\ widget to render individual message parts. This component introduces support for the 'Gentle' send animation effect, which scales the text bubble upon sending. It also implements 'colorful bubbles' for received messages, applying gradients based on the sender's handle color when enabled. The widget handles rich text rendering (bold, italic, mentions, links) via \AttributedBodyHelpers\, displays strikethrough for edited messages, and shows an 'Unsent' label for pending parts. Selection highlighting and bubble darkening for temporary messages are also integrated into this specific rendering layer.

_lib/app/layouts/conversation\view/widgets/message/text · high confidence

Redesigned Documents and Locations sections with search and filtering

The Documents and Locations sections in the conversation details view have been rewritten to support full-page browsing with search and filtering capabilities. The Documents section now includes a search helper that ranks file attachments by filename and MIME type, allowing users to filter and sort files within the full-page view. The Locations section has been updated to display location attachments in a masonry grid layout, with support for filtering by sender and date. Both sections now feature consistent UI patterns including section headers, loading indicators, empty states, and pagination for large sets of attachments.

_lib/app/layouts/conversation\_details/widgets/sections/documents, lib/app/layouts/conversation\details/widgets/sections/locations · high confidence

Redesigned conversation list headers with platform-specific UI and filter controls

The conversation list screen now uses distinct header widgets for iOS (Cupertino), Material, and Samsung One UI skins, each providing a tailored look and feel. A new header widget allows users to toggle chat list filters directly from the header when the 'Show filters in header' setting is enabled, with the filter icon highlighting when active. The headers also feature improved overflow menus, sync indicators, and responsive layouts for desktop, web, and tablet modes.

_lib/app/layouts/conversation\list/widgets/header · high confidence

Redesigned iMessage stats page with platform-specific skins and local/server toggle

The iMessage stats page in Server Settings has been completely redesigned to support distinct visual skins for iOS (Cupertino), Material, and Samsung interfaces, ensuring the stats display matches the user's chosen theme. The page now includes a segmented control allowing users to toggle statistics between the 'Server' and 'Local DB' sources, with a note that Local DB stats are unavailable on web builds. The layout presents totals for messages, chats, handles, attachments, images, videos, and locations using themed stat cards and media rows, and supports pull-to-refresh for updating the data.

_lib/app/layouts/settings/pages/server/imessage\stats · high confidence

Redesigned iOS splash screen with adaptive theming and status bar visibility

The iOS launch experience has been updated to support adaptive theming. The splash screen now uses a background image layer to allow for dynamic theming, and the launch image dimensions have been standardized to 600x600 pixels. Additionally, the app configuration now explicitly ensures the status bar remains visible during the launch sequence.

ios/Runner · high confidence

The media section in conversation details now features a new responsive grid layout that adjusts column counts based on screen width, along with a new filter selector widget that adapts its style to the current platform skin (using Cupertino controls on iOS and Material 3 segmented buttons elsewhere). Users can now filter media by type and sender, and the grid supports selection modes with visual feedback, improving the browsing and management of attachments within conversations.

_lib/app/layouts/conversation\details/widgets/sections/media · high confidence

Redesigned typing indicator with platform-specific visuals and animations

The typing indicator in conversation views has been rewritten to provide a more polished, platform-aware experience. On iOS, it now displays the sender's avatar alongside the animated dots, matching the native iMessage style, while other platforms show a rounded bubble with a tail. The animation uses a staggered bounce effect for the dots and a scale transition for the bubble's appearance and disappearance, anchored at the bottom-left to simulate a real speech bubble growing from the sender. This change improves visual clarity and user feedback during active typing.

_lib/app/layouts/conversation\view/widgets/message/typing · high confidence

Refactored attachment rendering with granular state-based widgets

The attachment display logic in conversation messages has been restructured into distinct, per-state widgets to improve clarity and maintainability. The system now explicitly separates the rendering of attachments based on their transfer lifecycle: placeholders for unloaded media, dedicated views for download and upload progress (including byte counts and cancellation options), and specialized viewers for resolved content. This change introduces support for rendering Apple Wallet passes (pkpass) directly within the chat, adds a reusable corner-badge component for media type indicators, and implements a unified opacity wrapper to visually indicate when a message is actively sending. Users will see more consistent progress feedback during transfers and the ability to view pass-type attachments without leaving the conversation.

_lib/app/layouts/conversation\view/widgets/message/attachment/parts · high confidence

Refactored conversation header into shared, reusable components

The conversation view header logic has been extracted into a shared library to eliminate duplication across platform-specific implementations (Cupertino, Material, and Samsung). This change introduces a \ChatTitleMixin\ that centralizes title and subtitle resolution by delegating directly to \ChatState\, ensuring consistent display names across all platforms. Additionally, common UI elements such as the send progress indicator, back button with unread count badge, and the combined chat title/avatar widget are now provided as reusable shared components, simplifying the platform-specific header widgets and improving maintainability.

_lib/app/layouts/conversation\view/widgets/header/shared · high confidence

Refactored conversation view handlers for stability and performance

The conversation view's handler layer has been restructured into dedicated managers to improve reliability and maintainability. A new DropZoneManager replaces the previous drag-and-drop implementation, resolving random crashes by using a simpler, more robust approach for handling file attachments. Message animations are now orchestrated by a centralized MessageAnimationOrchestrator with a dedicated configuration class, ensuring consistent slide, size, and fade transitions for sent and received messages without visual overlap. Additionally, the SmartRepliesManager has been updated to manage ML Kit context more effectively, enforcing a rolling window of recent messages to prevent memory issues and ensuring proper sanitization of text before processing.

_lib/app/layouts/conversation\view/pages/handlers · high confidence

Refactored data synchronization with dedicated managers and incremental sync improvements

The sync logic in \lib/services/backend/sync\ has been restructured into distinct managers (\FullSyncManager\, \IncrementalSyncManager\, \ChatSyncManager\, \HandleSyncManager\) orchestrated by a central \SyncService\. This change introduces server version-aware incremental sync, supporting rowId-based pagination for server v1.6.0+ while maintaining timestamp-based fallbacks for older versions. The \HandleSyncManager\ now requires server v1.5.2+ and includes rollback capabilities to restore original handles if the sync fails. Additionally, incremental sync operations are offloaded to isolates to prevent UI freezing, and the service now enforces a 30-second cooldown between incremental syncs to reduce server load.

lib/services/backend/sync · high confidence

Refactored interactive message rendering with dedicated widgets and URL preview redesign

The interactive message rendering system has been restructured into a dedicated directory with a new \InteractiveHolder\ entry point that routes Apple payload data to specific widgets. This introduces dedicated renderers for Apple Pay, Game Pigeon, and embedded media (maps, music, iBooks), while completely rewriting the URL preview logic. The URL preview now features a \UrlPreviewController\ for centralized fetch and cache management, supports three distinct card shapes (hero, compact, bare) based on available metadata, and includes platform-specific skins for iOS (Cupertino) and Material/Samsung (Expressive) themes. The refactoring also improves handling of payload artwork, favicon display, and auto-fetch retry logic for contacts.

_lib/app/layouts/conversation\view/widgets/message/interactive · high confidence

Refactored logging outputs with improved concurrency and file handling

The logging system in lib/utils/logger/outputs has been restructured to introduce dedicated output classes: DebugConsoleOutput for debug prints, LogStreamOutput for stream-based logging, and FileOutputWrapper to strip ANSI codes before writing to files. A new RotatingFileOutput implementation replaces previous logic, addressing critical issues with concurrent isolate writes and Windows file locking by using atomic append-mode writes and in-place truncation instead of file renaming, ensuring log lines are no longer lost or corrupted across isolates.

lib/utils/logger/outputs · high confidence

Refactored message bubble composition into isolated, granular widgets

The message bubble layout in the conversation view has been restructured to improve rendering performance and maintainability. The previous monolithic widget tree has been decomposed into specialized, isolated sub-widgets (such as \ReactionObserver\, \StickerObserver\, \ReplyBubbleSection\, and \DeliveredIndicatorObserver\) that use independent \Obx\ scopes. This change ensures that updates to specific message attributes—like reactions, stickers, or error states—trigger only the relevant parts of the message row to rebuild, rather than the entire message bubble. Additionally, the reply bubble section now correctly scopes the state of the quoted message, ensuring that reply previews display the original content accurately.

_lib/app/layouts/conversation\_view/widgets/message/message\holder · high confidence

Refactored message error handling and added clone scope for popup stability

This change introduces a \MessageCloneScope\ widget to prevent duplicate side-effects when message bubbles are rendered as decorative clones in popups, ensuring that actions like refreshing previews only trigger once. It also replaces ad-hoc error handling with a centralized \MessageErrorHelper\ and \MessageErrorDialog\, providing consistent error titles and body text (including specific iMessage error codes) and shared retry/remove logic for both messages and reactions.

_lib/app/layouts/conversation\view/widgets/message/shared · high confidence

Refactored message popup actions into dedicated modules

The message popup action logic has been reorganized into four distinct files (media\_actions.dart, message\_actions.dart, navigation\_actions.dart, text\_actions.dart) to improve code structure. This change consolidates specific user actions—such as downloading or opening attachments, editing/deleting messages, replying, forwarding, and copying text—into their respective modules, ensuring that the popup menu continues to function correctly while making the codebase easier to maintain.

_lib/app/layouts/conversation\view/widgets/message/popup/actions · high confidence

Refactored message rendering and interaction utilities into the misc widget layer

The \lib/app/layouts/conversation\_view/widgets/message/misc\ directory has been restructured to centralize shared message utilities and improve maintainability. A new \MessagePartContent\ dispatcher now routes message parts to their specific renderers (text, attachments, or interactive content), while \MessageEditField\ provides an inline editing experience with keyboard shortcuts. Visual and interaction behaviors are now handled by dedicated components: \BubbleEffects\ manages expressive send animations (including invisible ink), \SwipeToReplyWrapper\ and \SlideToReply\ enable swipe-to-reply gestures, \MessageProperties\ displays edit indicators and reply counts, and \TailClipper\ handles the specific bubble tail shapes for iOS and Material skins.

_lib/app/layouts/conversation\view/widgets/message/misc · high confidence

Refactored message timestamp and delivery status display

The timestamp and delivery status components in the conversation view have been restructured into dedicated widgets (MessageTimestamp, DeliveredIndicator, TimestampSeparator) with improved reactivity and skin-specific behaviors. Timestamps now slide in on tap for iOS, remain inline for Material, and are always visible for Samsung skins. Delivery indicators (Sent, Delivered, Read, Sending) are now debounced to prevent flickering during animations and correctly handle edge cases like unsent messages and audio retention. Date separators between different calendar days are now consistently displayed with adaptive styling based on custom wallpapers.

_lib/app/layouts/conversation\view/widgets/message/timestamp · high confidence

Refactored message view components and added notification controls

The conversation view's message display logic has been reorganized into extracted widget components to improve code structure and isolate rebuilds. This change introduces a dedicated banner for chats with silenced notifications, including a 'Notify Anyway' button that allows users to manually trigger a notification for a specific message. Additionally, the smart replies row has been updated to dynamically adjust its layout and styling based on whether the chat has a custom wallpaper, ensuring visual consistency with the chat's background theme.

_lib/app/layouts/conversation\view/widgets · high confidence

Refactored preferences service into typed category actions

The preferences service has been restructured to use a category-based action pattern, where each preference domain (admin, database, desktop, firebase, messaging, network, server, system, and theme) is managed by its own dedicated action class. This change introduces typed getters and setters for specific settings—such as window dimensions, theme selections, and server details—replacing previous raw string-key access with a more robust, type-safe API that simplifies adding new preferences and ensures consistent handling of cached values.

lib/services/backend/settings/actions · high confidence

Regenerated web splash screen assets

The web splash screen implementation has been updated with new JavaScript and CSS files. The JavaScript now explicitly removes the splash container and branding elements while setting the body background to transparent upon loading. The CSS has been redesigned to support various image fitting modes (contain, stretch, cover) and positioning (center, bottom, bottom-left, bottom-right), and includes a media query to switch the background color to black in dark mode.

web/splash · high confidence

Reliable background task execution via WorkManager and engine race fixes

The app now uses a new WorkManager-based system (DartWorkManager and DartWorker) to handle background Dart tasks, ensuring that events like notification replies are processed even when the app is killed or the engine is cold-starting. This implementation fixes previous race conditions and crashes by introducing a mutex for engine state transitions, handling large payloads that exceed WorkManager's size limits by spilling them to disk, and adding retry logic with exponential backoff for transient failures. Additionally, a centralized MethodCallHandler has been introduced to route method calls to specific service handlers, improving code organization and reliability.

_android/app/src/main/kotlin/com/bluebubbles/messaging/services/backend\_ui\interop · high confidence

Rewritten URL preview metadata pipeline with improved parsing and security

The URL preview system has been completely rewritten to replace the previous \metadata\_fetch\ dependency. This change introduces a new metadata extraction pipeline that fetches and parses Open Graph, Twitter Card, JSON-LD, and oEmbed data with stricter security guards against SSRF and private network access. Users will see more reliable link previews, including better handling of non-UTF-8 encodings, improved favicon support, and site-specific refinements for platforms like YouTube and Reddit. The new system also manages preview storage directly from the analyzer, reducing redundant fetches and improving performance through single-flight caching and concurrency limits.

lib/helpers/network/metadata · high confidence

Rewritten app lifecycle service with improved foreground handling and race-condition fixes

The app lifecycle service has been rewritten to better manage state transitions, particularly on Android. It now distinguishes between being 'alive' (process running) and 'in the foreground' (UI visible), preventing issues where backgrounded apps incorrectly reported as active. Key improvements include canceling isolate drains on resume to prevent dropped foreground messages, ensuring socket connections resume correctly without backoff delays, and managing an Android foreground service to keep the app alive when backgrounded (if the 'keep app alive' setting is enabled). The service also fixes race conditions during startup and resume that previously caused missed notifications or stale chat states.

lib/services/backend/lifecycle · high confidence

Rewritten conversation header with platform-specific skins and shared utilities

The conversation view header has been completely rewritten to support distinct visual skins for iOS (Cupertino) and Material Design (including Samsung), while sharing common logic. The new structure introduces a \CupertinoHeader\ with a frosted-glass blur effect and a \MaterialHeader\ that integrates with the system app bar, desktop window effects, and platform-specific actions like calling or emailing on Android. Both skins utilize a new shared widget library (\header\_widgets.dart\) containing reusable components such as \ManualMark\ (for private API read receipts), \ConnectionIndicator\ (for socket status), and \HeaderProgressIndicator\. This change also consolidates header state management through a shared \ConversationViewController\ and improves responsiveness for unread counts and avatar scaling.

_lib/app/layouts/conversation\view/widgets/header · high confidence

Rewritten network layer with improved connection resilience and certificate handling

The network communication layer has been restructured to provide more reliable connectivity and better support for custom server configurations. The new \SocketService\ separates connection reconnection, URL rediscovery, and lifecycle gating into distinct concerns, implementing a capped exponential backoff for transient failures and automatic URL discovery via Firebase when the server address changes. Attachment downloads now use a prioritized queue that favors the active chat, with a robust state machine to manage concurrent downloads and prevent race conditions. Certificate validation has been enhanced to support self-signed certificates and user-installed certificates on Android, ensuring secure connections even with non-standard TLS setups. The HTTP service now includes automatic retries for 502 Cloudflare errors and better handling of custom headers for services like ngrok and zrok.

lib/services/network · high confidence

Rewritten notification service with robust desktop support and serializable query descriptors

The notification system has been completely rewritten to improve reliability and cross-platform consistency. On desktop (Windows and Linux), notifications now use a dedicated \DesktopNotifications\ adapter that encodes chat context into toast payloads, ensuring that tapping a notification or using quick actions (reply, accept/decline FaceTime) works correctly even if the app was restarted. The service now supports scheduled message reminders on Windows, custom notification sounds, and better handling of group chats and FaceTime alerts. Additionally, a new \AttachmentQueryDescriptor\ class allows attachment database queries to be serialized and passed across isolate boundaries, fixing issues with stale data and improving background sync performance.

lib/services/backend/notifications · high confidence

Rewritten notification system with new handlers and media integration

The notification service has been completely rewritten to improve reliability and add new capabilities. Incoming FaceTime calls now display dedicated Answer and Ignore actions on the notification. Message notifications support quick replies, marking as read, and liking/loving directly from the notification shade, with improved deduplication logic to prevent duplicate alerts. The system now manages notification channels more robustly, including a one-time migration to ensure vibration works correctly for new messages and setting the foreground service channel to low importance to avoid intrusive heads-up notifications. Additionally, the app can now listen to media sessions to extract album art for dynamic theming, and supports UnifiedPush for receiving messages via alternative push gateways.

android/app/src/main/kotlin/com/bluebubbles/messaging/services/notifications · high confidence

Standardized backend service initialization and startup sequence

The app now uses a centralized, dependency-ordered startup sequence in \lib/helpers/backend/startup\_tasks.dart\ to initialize core services (such as Filesystem, Settings, Database, and Socket) in a strict order, ensuring reliable background operation and notification delivery. This change also introduces helper utilities for managing server settings and Android foreground services, which helps prevent crashes on startup and ensures the app remains alive in the background when configured.

lib/helpers/backend · high confidence

Standardized settings page layout components

The settings interface now uses a dedicated set of structural widgets (\SettingsScaffold\, \SettingsSection\, \SettingsHeader\, \SettingsDivider\) to ensure consistent spacing, visual hierarchy, and platform-specific styling across all settings panels. This change introduces a unified pattern for grouping settings into rounded cards with appropriate dividers, handling platform-specific nuances such as iOS-style shadows and Samsung-specific scroll behaviors, while replacing ad-hoc layout code with these reusable building blocks.

lib/app/layouts/settings/widgets/layout · high confidence

System chat events now display message info on long press and adapt to custom backgrounds

The chat event widget, which renders system-generated messages like group changes or unsent notifications, now supports a long-press gesture to display a detailed 'Message Info' dialog containing the message's metadata. Additionally, the visual styling of these events has been updated to respect custom chat wallpapers; when a custom background is active, the event text is wrapped in a semi-transparent container to ensure readability, whereas it remains plain centered text against standard backgrounds.

_lib/app/layouts/conversation\_view/widgets/message/chat\event · high confidence

Updated LLDB debugging integration files

The iOS ephemeral Flutter directory now includes regenerated LLDB helper scripts (flutter\_lldb\_helper.py and flutter\_lldbinit). These files enhance the debugging experience by automatically intercepting memory page notifications during debugging sessions, ensuring that read-execute-write memory protections are handled correctly without manual intervention.

ios/Flutter/ephemeral · high confidence

Updated ObjectBox database schema and generated code

The ObjectBox model and generated Dart code have been regenerated to reflect changes in the underlying data model. This update includes new or modified properties for entities such as Attachment (e.g., exif, metadata) and Chat (e.g., customAvatarPath, textFieldText), ensuring the local database layer stays in sync with the application's data requirements.

lib/generated · high confidence

Updated macOS plugin registrant for Flutter 3

The macOS build now uses a regenerated plugin registrant (GeneratedPluginRegistrant.swift) and corresponding xcconfig files to support Flutter 3. This update ensures that all native plugins—such as video playback, local notifications, and window management—are correctly registered with the Flutter engine, aligning the macOS platform with the broader Flutter 3 dependency upgrades.

macos/Flutter · high confidence

Web platform database support deprecated with stub implementations

The \lib/database/html/\ directory now contains stub implementations of the ObjectBox entity classes (Chat, Message, Attachment, Handle, Theme, etc.) that compile for the web platform where ObjectBox is unavailable. These files mirror the API surface of \lib/database/io/\ but hold no data and perform no actual persistence, effectively marking web support as deprecated. The \CLAUDE.md\ documentation explicitly instructs developers not to extend these files and to edit the \io/\ versions instead, as conditional imports in \lib/database/models.dart\ route to \io/\ or \html/\ at compile time.

lib/database/html · high confidence

iOS bundle identifier updated and CocoaPods config included

The iOS application's bundle identifier has been changed from com.example.bluebubbles to com.example.bluebubbleMessages across all build configurations in the project file. Additionally, the Debug and Release xcconfig files now optionally include the generated CocoaPods configuration files, ensuring that dependencies managed by CocoaPods are correctly linked during the build process.

ios/Flutter · high confidence

Fixes

Fixes cross-isolate settings corruption and silent failures on Windows and Linux

The app now reliably saves and reads settings across multiple isolates on Windows and Linux, preventing the silent loss of data and file corruption that occurred when different isolates overwrote each other's cached preferences. This is achieved by replacing the stock desktop shared preferences backend with a custom store that serializes writes via a lock file, performs atomic file updates, and automatically recovers from corruption using a backup file. Additionally, the settings service now includes improved logging to detect and prevent silent startup failures.

lib/services/backend/settings · high confidence

Improved reliability of message-to-chat synchronization

The sync helper for messages now includes retry logic to ensure that newly synced messages are correctly associated with their parent chats. Previously, a race condition could result in synced messages lacking a chat reference; this change wraps the chat-matching step in a retry loop (up to three attempts) to handle transient database state issues, ensuring chat associations are persisted reliably.

lib/helpers/backend/sync · high confidence

Refactored message rendering with dedicated wrapper and edit isolation

The message display logic in the conversation view has been restructured to improve performance and stability. A new \MessagePartWrapper\ component now handles the composition of message content, stickers, and reactions, ensuring that visual overlays are correctly positioned relative to the bubble. Additionally, the edit functionality has been isolated into a separate \\_MessageContentBubble\ widget, which prevents unnecessary rebuilds of the entire message structure when the user is editing a specific part of a message.

_lib/app/layouts/conversation\view/widgets/message/parts · high confidence

Test coverage

Removed default widget smoke test

The default Flutter widget smoke test in \test/widget\_test.dart\ has been removed. This test previously verified that the app's counter increments correctly when the '+' icon is tapped, and its removal indicates that this specific automated verification is no longer part of the test suite.

test · high confidence

Dependencies

Android build infrastructure upgraded to AGP 8 and Java 21 with new build flavors

The Android build system has been significantly modernized: the project now uses the Android Gradle Plugin 8.11.1, compiles against Android SDK 36, and targets Java 21. This upgrade introduces a new modular build structure with distinct product flavors (joel, tanay, alpha, beta, prod, prodNoAa) to support different build variants and release channels. Additionally, the iOS project now includes a standard Podfile for CocoaPods dependency management, and the Dart dependencies have been updated to support the Flutter 3.12+ SDK.

(dependencies) · high confidence

Gradle wrapper upgraded to version 8.14

The Android build system now uses Gradle 8.14 instead of the previous version 5.6.2. This update includes configuration for network timeouts and distribution URL validation to improve build reliability and security.

android/gradle · high confidence

Housekeeping

Initial project scaffolding and documentation

The repository has been initialized with core project documentation and configuration files, including AGENTS.md, CLAUDE.md, CODE\_OF\_CONDUCT.md, CONTRIBUTING.md, LICENSE, analysis\_options.yaml, .gitignore, and an updated README.md. These files establish the project's Apache 2.0 license, community guidelines, contribution standards, and development environment setup instructions for the BlueBubbles Flutter application.

(repo-wide) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 48 → 49 (+1.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 68 → 68 (-0.0)
  • Architecture 95 → 92 (-2.6)
  • Maturity 48 → 67 (+19.1)
  • Readiness 43 → 43 (+0.0)
  • Security 46 → 44 (-2.2)
  • Domain Modelling 74 → 74 (+0.0)
  • Accessibility 60 → 60 (+0.0)
  • Performance 60 → 60 (+0.0)

Resolved (64)

  • BaseLogger.getLogs (cognitive 31) (lib/utils/logger/logger.dart)
  • BaseLogger.getLogs (cyclomatic 16) (lib/utils/logger/logger.dart)
  • ClipboardPasteHandler.handlePasteEvent (cognitive 20) (lib/app/layouts/conversation_view/widgets/text_field/handlers/clipboard_paste_handler.dart)
  • Documentation: no installation or build instructions (README.md)
  • Duplicated block (14–17 lines × 3) (lib/app/layouts/settings/pages/advanced/firebase_panel.dart)
  • Duplicated block (22–23 lines × 2) (lib/app/layouts/settings/pages/server/backup_restore_panel.dart)
  • Duplicated block (5 lines × 2) (lib/app/layouts/settings/pages/theming/advanced/advanced_theming_content.dart)
  • Duplicated block (5 lines × 3) (lib/app/layouts/settings/pages/desktop/desktop_panel.dart)
  • Duplicated block (7 lines × 2) (lib/app/layouts/settings/pages/server/backup_restore_panel.dart)
  • Duplicated block (7 lines × 4) (lib/app/layouts/settings/pages/advanced/firebase_panel.dart)
  • Duplicated block (8 lines × 2) (lib/app/layouts/conversation_view/widgets/media_picker/text_field_attachment_picker.dart)
  • High: security finding (details withheld)
  • Hotspot: android/app/src/main/kotlin/com/bluebubbles/messaging/services/foreground/SocketIOForegroundService.kt (android/app/src/main/kotlin/com/bluebubbles/messaging/services/foreground/SocketIOForegroundService.kt)
  • Hotspot: lib/app/layouts/chat_selector_view/chat_selector_view.dart (lib/app/layouts/chat_selector_view/chat_selector_view.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/chat_info.dart (lib/app/layouts/conversation_details/widgets/chat_info.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/chat_options.dart (lib/app/layouts/conversation_details/widgets/chat_options.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/contact_tile.dart (lib/app/layouts/conversation_details/widgets/contact_tile.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/media_gallery_card.dart (lib/app/layouts/conversation_details/widgets/media_gallery_card.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/sections/links/links_section.dart (lib/app/layouts/conversation_details/widgets/sections/links/links_section.dart)
  • Hotspot: lib/app/layouts/conversation_details/widgets/sections/media/media_grid_section.dart (lib/app/layouts/conversation_details/widgets/sections/media/media_grid_section.dart)
  • …and 44 more

New (27)

  • BaseLogger._writeMergedLog (cognitive 22) (lib/utils/logger/logger.dart)
  • ClassTooLong: SettingsService (lib/services/backend/settings/settings_service.dart)
  • ClipboardPasteHandler._pasteAttachments (cognitive 18) (lib/app/layouts/conversation_view/widgets/text_field/handlers/clipboard_paste_handler.dart)
  • Duplicated block (10–11 lines × 2) (lib/app/layouts/settings/pages/server/backup_restore_panel.dart)
  • Duplicated block (21–22 lines × 2) (lib/app/layouts/settings/pages/server/backup_restore_panel.dart)
  • Duplicated block (23 lines × 2) (lib/app/layouts/settings/pages/advanced/notification_providers_panel.dart)
  • Duplicated block (5 lines × 3) (lib/app/layouts/settings/pages/desktop/desktop_panel.dart)
  • Duplicated block (7 lines × 3) (lib/app/layouts/settings/pages/advanced/notification_providers_panel.dart)
  • Duplicated block (8–9 lines × 3) (lib/app/layouts/conversation_view/widgets/media_picker/text_field_attachment_picker.dart)
  • Duplicated block (9 lines × 3) (lib/app/layouts/settings/pages/advanced/firebase_panel.dart)
  • Duplicated block (9–10 lines × 2) (lib/app/layouts/conversation_view/widgets/media_picker/text_field_attachment_picker.dart)
  • FileTooLong: pages/messages_view.dart (lib/app/layouts/conversation_view/pages/messages_view.dart)
  • High: security finding (details withheld)
  • Hotspot: lib/app/layouts/settings/dialogs/notification_settings_dialog.dart (lib/app/layouts/settings/dialogs/notification_settings_dialog.dart)
  • Hotspot: lib/app/layouts/settings/pages/misc/cache_tuning_panel.dart (lib/app/layouts/settings/pages/misc/cache_tuning_panel.dart)
  • Hotspot: lib/services/backend/notifications/notifications_service.dart (lib/services/backend/notifications/notifications_service.dart)
  • Hotspot: lib/services/backend/settings/settings_service.dart (lib/services/backend/settings/settings_service.dart)
  • Hotspot: lib/services/isolates/global_isolate.dart (lib/services/isolates/global_isolate.dart)
  • NotificationSettingsDialog.build (cyclomatic 16) (lib/app/layouts/settings/dialogs/notification_settings_dialog.dart)
  • Off-boarding risk: anonymized user #1
  • …and 7 more

Changes since last survey

  • 128 commits — 81 feature/other, 47 fixes

By area

  • (repo) — 35 commits
  • (root) — 23 commits
  • lib/app — 19 commits
  • lib/services — 11 commits
  • lib/utils — 11 commits
  • lib/helpers — 6 commits
  • android/app — 5 commits
  • .github/workflows — 4 commits
  • .github/actions — 3 commits
  • lib/main.dart — 3 commits
  • flatpak/app.bluebubbles.BlueBubbles.metainfo.xml — 2 commits
  • windows/runner — 2 commits
  • android/build.gradle — 1 commit
  • linux/CMakeLists.txt — 1 commit
  • linux/flutter — 1 commit
  • windows/signpath — 1 commit

Notable commits

  • fix: Fix #3374
  • fix: Fix #3377. Revert when https://github.com/flutter/flutter/pull/191453 is merged
  • fix: Fix #3388. Also show error if trying to paste attachments before starting chat
  • fix: Fix CMake
  • fix: Fix android build
  • fix: Fix dart conflict in fvm
  • fix: Fix header condition
  • fix: Fix swipe direction language
  • fix: Merge pull request #3131 from blue-archon/fix/null-field-message-crash
  • fix: Merge pull request #3161 from blue-archon/fix/message-before-view-crash
  • fix: Merge pull request #3341 from BlueBubblesApp/joel/fix/log-writer
  • fix: Merge pull request #3342 from BlueBubblesApp/joel/fix/close-hang
  • fix: Merge pull request #3343 from BlueBubblesApp/joel/fix/desktop-blocking-io
  • fix: Merge pull request #3344 from BlueBubblesApp/joel/fix/desktop-toasts
  • fix: Merge pull request #3345 from BlueBubblesApp/joel/fix/composer-focus
  • fix: Merge pull request #3349 from BlueBubblesApp/joel/fix/disable-windows-impeller
  • fix: Merge pull request #3355 from BlueBubblesApp/joel/fix/desktop-contact-avatars
  • fix: Merge pull request #3357 from BlueBubblesApp/joel/fix/stream-windows-build
  • fix: Merge pull request #3360 from BlueBubblesApp/joel/fix/desktop-only-options
  • fix: Merge pull request #3363 from BlueBubblesApp/joel/fix/signpath-sign-angle-dlls
  • …and 108 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

BlueBubblesApp/bluebubbles-app was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit f32fb7101efe5108d2532d9c07f6cab0d464e664 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.