skydoves/Balloon
56.4
Adequate · 13 November 2026
8.9k
lines of production code
Kotlin
primary language
7
measurements over time
What this system is
Features
Add desktop and WebAssembly demo applications for Balloon Compose Multiplatform
New demo applications have been added for both desktop and WebAssembly targets, allowing users to run and test the Balloon library on these platforms. The desktop app (desktopApp) launches a Compose window displaying the sample UI, while the wasmApp provides a browser-based entry point that renders the sample app within the DOM. These additions support the promotion of the Compose Multiplatform implementation to the balloon artifact for version 2.0.0.
desktopApp, wasmApp · high confidence
Initial iOS app shell for Kotlin Multiplatform integration
The iosApp directory now contains a complete Xcode project structure, including the project file, configuration, and Swift UI entry points. This setup enables the iOS application to embed and sign a Kotlin framework via a Gradle build phase, allowing SwiftUI views to host the shared Kotlin Compose UI through a UIViewControllerRepresentable wrapper.
iosApp · high confidence
New Compose Multiplatform demo app with pixel-parity harness
A new Android demo application (\Balloon KMP Demo\) has been added to showcase the Compose Multiplatform implementation of the Balloon library. This includes a main activity (\KmpBalloonActivity\) that hosts the shared \BalloonSampleApp\ composable, and a dedicated pixel-parity harness (\KmpParityActivity\) that renders specific balloon configurations (alignments, arrow positions, sizes, overlays) using identical test cases to the existing View-based demo. This allows for direct visual comparison and verification that the Compose Multiplatform version behaves identically to the legacy Android implementation.
androidApp · high confidence
New Compose Multiplatform sample screens: Labs playground and Glass tooltip demo
The shared sample module now includes a comprehensive interactive playground (Labs) that allows users to adjust every balloon configuration knob—such as arrow geometry, body styling, sizing, placement, animations, and overlays—in real time, and a new Glass tooltip demo that uses the Cloudy library to render translucent, blurred tooltips that reveal the content underneath. These screens are integrated into the shared sample app entry point, providing a unified, cross-platform demonstration of the library's capabilities.
samples-shared · high confidence
Repository initialization with Compose Multiplatform documentation and tooling
The repository has been initialized with version 2.0.1 of Balloon, a Compose Multiplatform tooltip library supporting Android, iOS, Desktop, and Web. The diff establishes the project's documentation structure, including a comprehensive README detailing the new Compose-based API (replacing the legacy View/PopupWindow implementation), a migration guide for 1.x users, and a MkDocs configuration for the site. It also adds standard contributor guidelines (Code of Conduct, Contributing) and configures development tooling such as Renovate for dependency updates, CodeRabbit for code reviews, and a \.gitignore\ that excludes per-user IDE and Xcode state files.
(repo-wide) · high confidence
Removals
Removed legacy demo code and utilities
The legacy demo implementation files, including BalloonUtils, MainActivity, and the recycler sample components (SampleAdapter, SampleUtils, SampleViewHolder), have been removed from the app source. This cleanup eliminates the old sample codebase that previously demonstrated balloon usage via utility methods and a main activity with a sample list.
app/src/main/java · high confidence
Behavioural changes
Add XML license header format and reorganize license files
The Spotless configuration now supports applying license headers to XML files, using a new license template located at spotless/spotless.license.xml. The previous Kotlin license template has been moved into the spotless directory (renamed from spotless.license.kt to spotless/spotless.license.kt) to keep license resources organized.
spotless · high confidence
Balloon popup positioning now respects full window bounds on Android
The Android implementation of the Balloon popup layer now disables clipping in its popup properties, ensuring that the popup uses the full window bounds (including system bars) for positioning calculations. This aligns the popup's coordinate space with the anchor's \boundsInWindow()\ measurements, fixing issues where balloons near the bottom would incorrectly flip above their anchor or where the overlay scrim would stop at the status bar instead of covering the entire screen.
balloon · high confidence
Release 2.0.1 configuration and SDK updates
The build configuration in buildSrc has been updated to version 2.0.1, with the minimum SDK raised to 23 and both compile and target SDKs set to 36. A separate demo compile SDK of 37 is defined to support the liquid glass tooltip demo while keeping the published library on SDK 36.
buildSrc · high confidence
Removal of Android build configuration files
The app module no longer includes the .gitignore file (previously excluding the /build directory) and the proguard-rules.pro file (previously containing commented-out ProGuard configuration rules). This indicates a change in how the Android application handles version control exclusions and code shrinking/obfuscation settings.
app · high confidence
Standardized Maven publication versioning logic
A new Gradle script (publish-module.gradle.kts) has been introduced to centralize Maven publication configuration. This script applies the com.vanniktech.maven.publish plugin and dynamically determines the library version based on the SNAPSHOT environment variable, allowing users to easily toggle between snapshot and release versioning during the build process.
scripts · high confidence
Test coverage
Added baseline profile generation for Balloon 2.0.0
A new BaselineProfileGenerator test has been added to the benchmark module to record classes and methods used by the Balloon library during runtime. The generator exercises the library by opening and dismissing balloons of every kind offered by the demo, including each entry animation, each highlight animation, and both overlay shapes, ensuring the baseline profile captures the actual usage patterns rather than just startup code.
benchmark/src/main/kotlin · high confidence
Dependencies
Gradle wrapper upgraded to version 9.8.0
The project's Gradle wrapper has been updated from version 5.1.1 to 9.8.0. This change ensures that builds use the newer Gradle distribution, which may include performance improvements, new features, and bug fixes compared to the previous version.
gradle · high confidence
Migrate to Kotlin Multiplatform and Compose Multiplatform
The project has been restructured from a single Android application into a Kotlin Multiplatform (KMP) library and demo suite. The core \:balloon\ module is now a KMP library targeting Android, Desktop (JVM), iOS, and WebAssembly (WasmJs), replacing the previous Android-only implementation. The build system has migrated from Groovy to Kotlin DSL and adopted the Version Catalog pattern (defined in \gradle/libs.versions.toml\) for dependency management. Key dependencies include Kotlin 2.4.10, Android Gradle Plugin 9.3.0-alpha01, and Compose Multiplatform 1.10.3. The previous Android demo app has been replaced by dedicated KMP demo applications for Android (\:androidApp\), Desktop (\:desktopApp\), and Web (\:wasmApp\), along with a shared sample module (\:samples-shared\) that re-exports the library for these platforms.
(dependencies) · 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
Score
- CAI 53 → 56 (+3.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 96 → 95 (-1.4)
- Architecture 98 → 98 (+0.0)
- Maturity 52 → 56 (+3.6)
- Readiness 38 → 41 (+3.2)
- Security 73 → 73 (+0.0)
- Performance 75 → 86 (+11.1)
Resolved (9)
- Ambiguous distinction between show and update. Both take the same parameters. It is unclear if update changes the position of an already visible balloon without re-triggering animations, or if it is a synonym for show. If they are distinct, the naming does not clearly convey the difference (e.g., reposition vs show).
- Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
- Duplicated block (13 lines × 2) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- Duplicated block (5 lines × 3) (balloon/src/commonMain/kotlin/com/skydoves/balloon/BalloonShapeBuilder.kt)
- Inconsistent sizing API. There are four methods to control arrow dimensions: a two-parameter overload, a single-parameter overload (ambiguous intent: square? width only?), and two single-axis setters. This creates confusion about how to set a non-square arrow or if the single-parameter version implies a square.
- No ADRs found
- Redundant naming for identical operations. Both methods accept a Color and a Dp thickness, implying they perform the same function (setting a border/stroke). The distinction between 'stroke' and 'border' is ambiguous in this context.
- Redundant naming in async/await methods. Similar to the show methods, there are specific awaitAlign* and awaitAsDropDown methods that duplicate the functionality of await(align, xOffset, yOffset) with specific alignment constants.
- Verbosity and redundancy in state management. showAsDropDown, showAlignTop, etc., are essentially convenience wrappers around show with specific BalloonAlign values. This bloats the API surface with methods that do the same underlying thing (update state and show) but with different signatures.
New (308)
- Duplicated block (12 lines × 2) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- Duplicated block (13 lines × 2) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- Duplicated block (13 lines × 2) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- Duplicated block (5 lines × 2) (balloon/src/commonMain/kotlin/com/skydoves/balloon/BalloonShapeBuilder.kt)
- Duplicated block (5 lines × 3) (balloon/src/commonMain/kotlin/com/skydoves/balloon/BalloonShapeBuilder.kt)
- Duplicated block (6 lines × 4) (balloon/src/commonMain/kotlin/com/skydoves/balloon/BalloonShapeBuilder.kt)
- Edited copy of a member (15 corresponding lines) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/labs/LabsControls.kt)
- Edited copy of a member (31 corresponding lines) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- Edited copy of a member (34 corresponding lines) (samples-shared/src/commonMain/kotlin/com/skydoves/balloon/sample/BalloonDemoScreen.kt)
- No ADRs found (iosApp/iosApp.xcodeproj/project.pbxproj)
- Outdated (compile): com.fasterxml.jackson.core:jackson-annotations
- Outdated (compile): com.fasterxml.jackson.core:jackson-core
- Outdated (compile): com.fasterxml.jackson.core:jackson-databind
- Outdated (compile): com.fasterxml.jackson.dataformat:jackson-dataformat-xml
- Outdated (compile): com.fasterxml.jackson.module:jackson-module-kotlin
- Outdated (compile): com.fasterxml.jackson:jackson-bom
- Outdated (compile): com.fasterxml.woodstox:woodstox-core
- Outdated (compile): com.github.ben-manes.caffeine:caffeine
- Outdated (compile): com.google.api.grpc:proto-google-common-protos
- Outdated (compile): com.google.auto.value:auto-value-annotations
- …and 288 more
Changes since last survey
- 6 commits — 6 feature/other, 0 fixes
By area
- .github/workflows — 2 commits
- gradle/libs.versions.toml — 2 commits
- gradle/wrapper — 2 commits
Notable commits
- change: Update Gradle to v9.9.0 (#1037)
- change: Update Gradle to v9.9.1 (#1038)
- change: Update actions/setup-java action to v6.2.0 (#1035)
- change: Update dependency androidx.test.uiautomator:uiautomator to v2.4.1 (#1034)
- change: Update dependency org.jetbrains.dokka to v2.3.0 (#1036)
- change: Update gradle/actions action to v6.4.1 (#1033)
Architecture
- Unchanged — 0 containers · 3 contexts · 2 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
skydoves/Balloon 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 13 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 7183791f94d607c3ef71f13b4d2f6a6647e66bef — the exact code this score is about.
- Scored under rubric-2026.11.4 — 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.64+preprod-569132d3dfbe.