Skip to content
CAI
Software that uses CAICheck a score

tommybuonomo/dotsindicator

65.7

Adequate · 14 November 2026

2.4k

lines of production code

Kotlin

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is an Android library that provides customizable dot page indicators for ViewPager and ViewPager2, supporting both classic XML views and Jetpack Compose. It features four distinct animation styles—Shift, Spring, Worm, and Balloon—and allows for granular customization of dot colors, sizes, and stroke widths. The library ensures visual consistency across different layout directions and includes comprehensive testing to prevent regression in rendering and behavior.

How it got here

2017–2018 — Jetpack Compose migration and build modernization

7 changes.

The project was rebranded to Pager Dots Indicator and updated to support Jetpack Compose alongside XML views, introducing new indicator types while removing legacy components. The build infrastructure was modernized by migrating to Gradle Kotlin DSL, AndroidX, and Java 17/21 toolchains, alongside publishing changes to Maven Central.

2022–2026 — Jetpack Compose integration and API expansion

10 changes.

The project introduced a native Jetpack Compose implementation of the DotsIndicator, adding new indicator styles like Balloon, Shift, Spring, and Worm with full RTL support. It also expanded the View-based API to support per-dot color customization and stroke width adjustments. To ensure quality and modern compatibility, the sample app was refactored to use Compose and View Binding, while comprehensive test coverage and build toolchain updates were added.

Features

Add Compose-based DotsIndicator with customizable dot styling

Introduces a new Jetpack Compose implementation of the DotsIndicator, allowing users to display page indicators in Compose UIs. The component supports configurable dot count, spacing, and specific indicator types (such as Balloon), and enables navigation by clicking individual dots. It provides visual customization options for dot appearance, including size, color, shape, and optional borders, and includes test tags for UI automation.

viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose · high confidence

Compose sample app demonstrates multiple dot indicator styles

The sample application now includes a Compose-based UI that showcases the library's dot indicator capabilities, specifically featuring Shift, Spring, Worm, and Balloon indicator types. This new fragment allows users to interact with a HorizontalPager and observe how each indicator type animates and renders in real-time, providing a visual reference for integrating these specific styles into their own Jetpack Compose projects.

viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui/compose · high confidence

DotsIndicator now supports per-dot colors and SpringDotsIndicator/WormDotsIndicator support stroke width

The classic DotsIndicator now allows customizing the color of each individual dot via the new \dotColors\ and \selectedDotColors\ properties, enabling distinct colors for unselected and selected states per position. Additionally, the SpringDotsIndicator and WormDotsIndicator styles now expose a \setDotsStrokeWidth\ method, allowing users to control the stroke width of the dot outlines.

viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator · high confidence

New Compose indicator types: Balloon, Shift, Spring, and Worm

The library introduces four new Compose-based indicator styles in the \compose.type\ package. The Balloon indicator scales dot sizes based on proximity to the current page, while the Shift indicator expands the width of the active dot. The Spring and Worm indicators feature a moving selector dot that tracks the scroll offset; both include specific logic to handle Right-to-Left (RTL) layout directions correctly by managing layout direction composition locals and coordinate calculations.

viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose/type · high confidence

Sample app demonstrates per-dot color customization for classic View indicator

The sample application now includes a ViewPager fragment that showcases the new per-dot color API for the classic DotsIndicator. Users can see how to assign specific accent colors to individual dots based on their position, with unlisted dots falling back to global color settings.

viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui/viewpager · high confidence

Removals

Removal of legacy DotsIndicator component

The legacy \DotsIndicator\ class has been removed from the library. This component previously provided a basic dot-based indicator for ViewPager with static styling and manual width adjustments during page scrolling. Users relying on this specific implementation will need to migrate to the updated indicator components introduced in this release.

src/main/java · high confidence

Behavioural changes

Added sample project configuration files

The sample application now includes a .gitignore file to exclude build artifacts and IDE settings, and a proguard-rules.pro file to provide default configuration rules for code shrinking and obfuscation.

viewpagerdotsindicator-sample · high confidence

Library renamed to Pager Dots Indicator with Jetpack Compose support

The project has been rebranded from 'Material Squares Loading Animation' to 'Pager Dots Indicator' and updated to version 5.1.1. The library now supports Jetpack Compose alongside classic XML views, offering four indicator types: Shift, Spring, Worm, and Balloon. The Maven artifact has changed to com.tbuonomo:dotsindicator, and the README has been completely rewritten to document the new Compose API and XML attributes.

(repo-wide) · high confidence

Migrate build scripts to Gradle Kotlin DSL

The project's build configuration has been migrated from Groovy to Kotlin DSL (build.gradle.kts). This change updates the build system syntax, which may require users to adjust their local build environment or custom build scripts to support the new format. Additionally, a .gitignore file has been added to the module to standardize ignored build artifacts and IDE files.

viewpagerdotsindicator · high confidence

Sample app adopts View Binding and Jetpack Compose theming

The sample application's core module has been refactored to support modern Android development patterns. It introduces Kotlin delegates for View Binding in Activities and Fragments to simplify view access and memory management. Additionally, it establishes a Jetpack Compose foundation by defining Material 3 color palettes for both light and dark modes, with the sample app currently configured to always use the dark theme. A ZoomOutPageTransformer is also included to provide a specific visual effect for ViewPager transitions.

viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/core · high confidence

Sample app defaults to Compose-based indicator display

The sample application's main activity now loads the Compose-based dots indicator fragment by default, replacing the previous default behavior of showing the ViewPager or ViewPager2 implementations. Users launching the sample will immediately see the Jetpack Compose version of the indicator, while the legacy ViewPager and ViewPager2 fragments remain available as selectable alternatives within the same activity.

viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui · high confidence

Updated Gradle Daemon JVM toolchain configuration

The Gradle build now includes a generated \gradle-daemon-jvm.properties\ file that configures the JVM toolchain for the Gradle daemon. This file maps specific operating systems (FreeBSD, Linux, macOS, Windows) and architectures (AARCH64, X86\_64) to specific JDK distribution URLs via the Foojay Disco API, and sets the target JDK version to 21. This ensures consistent and reproducible JVM environments for the Gradle daemon across different developer machines and CI systems.

gradle · high confidence

Test coverage

Added comprehensive test coverage for DotsIndicator color, pager, and Compose behavior; Added script to verify AAR compatibility with JDK 17; Removal of legacy Android test stubs.

Dependencies

Migrated build system to Gradle Kotlin DSL and AndroidX

The project has replaced the legacy Groovy-based build scripts and Android Support libraries with the modern Gradle Kotlin DSL (build.gradle.kts) and AndroidX dependencies. This migration updates the Android Gradle Plugin to version 9.2.1, sets the minimum SDK to 23, and configures the library to compile against Java 17 bytecode while using a Java 21 toolchain. Additionally, the build configuration now uses the Version Catalog (libs.versions.toml) for dependency management and switches the publishing mechanism from Bintray to Maven Central via the Central Portal.

(dependencies) · high confidence

Upgrade Gradle wrapper to version 9.5.1

The project's Gradle wrapper has been updated to use Gradle 9.5.1. This ensures that builds are executed with the specified distribution version, replacing any previous wrapper configuration.

gradle/wrapper · 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 64 → 66 (+1.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 94 → 88 (-6.4)
  • Architecture 97 → 97 (+0.0)
  • Maturity 56 → 56 (+0.0)
  • Readiness 58 → 67 (+8.6)
  • Security 74 → 74 (+0.0)

Resolved (4)

  • Duplicated block (32 lines × 2) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/attacher/RecyclerAttacher.kt)
  • Duplicated block (32 lines × 2) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose/type/SpringIndicatorType.kt)
  • Duplicated block (8 lines × 4) (viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui/compose/DotsIndicatorSampleComposeFragment.kt)
  • verify-java17-aar.main (cognitive 18) (scripts/verify-java17-aar.py)

New (10)

  • Duplicated block (32 lines × 2) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/attacher/RecyclerAttacher.kt)
  • Duplicated block (32 lines × 2) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose/type/SpringIndicatorType.kt)
  • Duplicated block (8 lines × 4) (viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui/compose/DotsIndicatorSampleComposeFragment.kt)
  • Edited copies of one member (4 members, 15+ corresponding lines) (viewpagerdotsindicator-sample/src/main/kotlin/com/tbuonomo/dotsindicatorsample/ui/compose/DotsIndicatorSampleComposeFragment.kt)
  • Edited copy of a member (11 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/SpringDotsIndicator.kt)
  • Edited copy of a member (22 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/SpringDotsIndicator.kt)
  • Edited copy of a member (26 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose/type/BalloonIndicatorType.kt)
  • Edited copy of a member (37 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/attacher/ViewPager2Attacher.kt)
  • Edited copy of a member (5 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/compose/type/BalloonIndicatorType.kt)
  • Edited copy of a member (9 corresponding lines) (viewpagerdotsindicator/src/main/kotlin/com/tbuonomo/viewpagerdotsindicator/SpringDotsIndicator.kt)

Architecture

  • Unchanged — 0 containers · 2 contexts · 0 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

tommybuonomo/dotsindicator 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 14 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 ad8d969aa65567b707fe7e58dc44c5a857273a18 — 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.65+preprod-e1a3b69fc8ee.