skydoves/Balloon
Balloon
Balloon is an Android popup manager and Jetpack Compose tooltip framework used to coordinate the display, positioning, and lifecycle of contextual popup windows. It functions as a user guidance overlay system, providing tools to highlight specific UI elements through anchored tooltips and informative overlays.
The project distinguishes itself through an onboarding sequence orchestrator that chains multiple informational overlays into a guided series. It includes a specialized system for highlighting interface elements using mask-based screen dimming and visual highlight animations to draw attention to specific application features.
The framework covers a broad range of capabilities, including anchor-relative positioning, popup frequency management via impression tracking, and customizable visual styling for layout and transitions. It also provides lifecycle-aware overlay management to prevent memory leaks and integrates with Jetpack Compose using custom modifiers.
Features
- Android Popup Management - Coordinates the display, positioning, and lifecycle of contextual popup windows on Android devices.
- Android Tooltip Frameworks - Provides a framework for managing the positioning and lifecycle of informative tooltips in Jetpack Compose.
- Lifecycle-Aware State Management - Automatically dismisses popups and clears references during activity or fragment destruction to prevent memory leaks.
- Contextual Guidance Systems - Provides a framework for delivering in-app instructions and targeted user assistance.
- View-Anchored Popups - Provides precise alignment and pinning of popups relative to specific target view elements.
- Anchor-Based Alignment - Implements a system to position popups relative to specific anchor points on the screen.
- Masked Screen Dimming - Generates a full-screen dimming overlay with a cutout area to visually highlight specific anchor views.
- Feature Guidance Overlays - Highlights specific UI areas and provides prompts to guide users through new features.
- Popup Orchestration - Coordinates the sequence and triggers of multiple popups to create guided user onboarding flows.
- Contextual Popups - Displays customizable tooltips anchored to specific views with various alignments.
- Informative Tooltips - Creates customized popups with specific styles and positioning to provide contextual guidance to users.
- Tooltip Sequence Orchestration - Coordinates a chain of tooltips to appear in a specific chronological sequence.
- User Onboarding Tours - Provides interactive guided sequences that introduce new users to product features through highlighted steps.
- Popup Transitions - Ships a system for applying entry and exit animations to popups based on their anchor alignment.
- Display Count Tracking - Persists display counts in local storage to limit how often a popup is shown to the user.
- Jetpack Compose UIs - Implements animated overlays and interactive popup elements using the Jetpack Compose declarative toolkit.
- Custom Modifiers - Integrates tooltip logic directly into Jetpack Compose components using custom modifiers and state holders.
- Display Frequency Limiting - Restricts the number of times a tooltip appears based on tracked usage history.
- Attention Animations - Implements repetitive motion effects like shaking or rotating to draw user attention to specific elements.
- Anchor Highlighting Overlays - Renders full-screen overlays that dim the background while keeping a specific anchor view visible.
- Interactive Popup Frameworks - Provides a toolkit for building interactive floating elements with custom logic for clicks and dismissals.
- Popup Visual Styling - Provides tools to configure visual styles including corner radii, margins, and custom layouts for popups.
- Visibility Limiters - Restricts how often users see specific popups by tracking and limiting show counts in local preferences.
- Popup Triggers - Tracks popup appearance counts to trigger specific actions or visibility changes after a defined limit.
- Feature Discovery Indicators - Uses visual indicators and animations to draw attention to specific UI elements for feature discovery.
- Mobile UI & Components - A lightweight popup like tooltips, fully customizable with an arrow and animations.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
