Skip to content
CAI
Software that uses CAICheck a score

Milad-Akarie/smooth_page_indicator

67.9

Adequate · 17 November 2026

2.5k

lines of production code

Dart

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Flutter library that provides customizable page indicator animations for mobile applications. It offers a variety of visual effects, such as worm, slide, and jumping dot transitions, which can be styled using a theme-based configuration system. The library supports right-to-left layouts and allows for detailed customization of dot appearance and animation behavior.

How it got here

2019 — v3.0.0 breaking changes and Flutter 3 upgrade

5 changes.

This period focused on a major version 3.0.0 release that introduced breaking changes to the theming system, converting it to be design-system-agnostic and shifting from ThemeData extensions to InheritedThemes. The library entry point was renamed and the public API was consolidated, while the underlying painting logic was refactored to use effect-driven configuration. These changes were accompanied by an upgrade to Flutter 3.0 and the removal of obsolete test files and legacy indicator classes.

2020–2025 — Theme support and effect expansion

8 changes.

The library introduced global theming via SmoothPageIndicatorTheme and improved RTL layout support, while adding a suite of new animation effects like ColorTransition and ScrollingDots. This period also involved migrating the example app to Flutter v2 embedding and significantly expanding test coverage for both the core library and the demo application.

Features

New and enhanced page indicator animation effects

The library introduces several new dot-indicator animation effects and variants to \lib/src/effects\. New effect classes include \ColorTransitionEffect\ for active-dot color transitions, \CustomizableEffect\ for fully bespoke dot decorations (borders, rotation, vertical offset), \ExpandingDotsEffect\ for scaling the active dot, and \ScrollingDotsEffect\ which supports a fixed-center mode and configurable small-dot scaling. Existing effects have been extended with new variants: \SwapEffect\ now supports \zRotation\ and \yRotation\ types, \WormEffect\ adds \thin\ and \thinUnderground\ variants, and \SlideEffect\ includes a \slideUnder\ variant. Additionally, \JumpingDotEffect\ now exposes \jumpScale\ and \verticalOffset\ customization parameters.

lib/src/effects · high confidence

Behavioural changes

Demo app now showcases multiple indicator effects with customizable styling

The example application has been updated to demonstrate a wider variety of page indicator effects, including Worm, Jumping Dot, Scrolling Dots, and a fully Customizable Effect. Users can now see how to configure specific parameters such as jump scale, vertical offset, stroke width, and dot dimensions, as well as apply custom color overrides and border radiuses to individual dots within the indicator.

example/lib · high confidence

Example iOS project migrated to Flutter v2 embedding and Swift

The iOS example app has been regenerated to use the Flutter v2 embedding, which requires Xcode 11+ and Swift 5. This migration updates the native iOS configuration, including the \AppDelegate\ to implement \FlutterImplicitEngineDelegate\ for plugin registration, and introduces a \FlutterGeneratedPluginSwiftPackage\ for dependency management. The project now uses CocoaPods for dependency resolution and includes updated build schemes and workspace configurations to support the new embedding architecture.

example/ios · high confidence

Introduce theme-based indicator customization and RTL support

The library now supports global theming via a new \SmoothPageIndicatorTheme\ widget, allowing developers to set default effects and colors (\DefaultIndicatorColors\) for all descendant indicators, reducing repetitive configuration. Additionally, right-to-left (RTL) layout support has been improved by replacing the manual \isRTL\ boolean with Flutter's native \TextDirection\ handling, ensuring correct dot ordering in RTL contexts.

lib/src · high confidence

Library entry point restructured and renamed

The main library entry point has been renamed from 'smooth\_indicators' to 'smooth\_page\_indicator'. This change consolidates the public API by exporting specific effect implementations (such as ColorTransition, Scale, Swap, and Worm effects) and the indicator painter, while removing the previous exports for individual indicator types like BouncingDot and SimpleDot.

lib · high confidence

Migration to design-system-agnostic theming and v3.0.0 breaking changes

The package introduces significant breaking changes in version 3.0.0. Default indicator colors are no longer derived from the app's ThemeData; instead, they use hardcoded fallbacks (blue for active, grey for inactive) unless overridden. The \SmoothPageIndicatorTheme\ has been converted from a \ThemeExtension\ to an \InheritedTheme\, meaning it must now wrap the indicator subtree directly rather than being registered in \ThemeData.extensions\. Additionally, the \SmoothIndicator\'s offset parameter now accepts a \ValueListenable\<double\>\ instead of a \double\, and painters receive offset updates via this listenable to optimize repaints. The README and CHANGELOG have been updated to reflect these changes and document the new theming approach.

(repo-wide) · high confidence

Refactored dot painters to use effect-driven configuration and theme colors

The painting logic for page indicator effects (such as ColorTransition, Customizable, JumpingDot, Scale, ScrollingDots, Slide, Swap, and Worm) has been rewritten to derive appearance and behavior from specific Effect objects and a DefaultIndicatorColors theme, replacing the previous approach of passing individual raw parameters (like dotWidth, dotColor, isRTL) directly to painters. This change removes the manual isRTL boolean in favor of Flutter's native Directionality handling, introduces a new CustomizablePainter that supports per-dot decoration and rotation, and adds support for infinite looping and small dot scaling in the ScrollingDots effect. Additionally, the old indicator widget classes (e.g., BouncingDotIndicator, SimpleDotIndicator) have been removed from this location as their painting logic is now encapsulated within these new effect-based painters.

lib/src/painters · high confidence

Test coverage

Added unit and widget tests for page indicator effects; Added unit tests for Smooth Page Indicator diagnostics, rendering, and theming; Added widget smoke test for the example app; Removed empty test file for smooth indicators.

Dependencies

Upgrade to Flutter 3.0 and update dev dependencies

The package now requires the Dart SDK 3.0.0 or higher, aligning with Flutter 3.0. This change updates the development tooling by adding flutter\_lints (v6.0.0) for code analysis, alchemist (v0.14.0) for golden testing, and material\_ui (v1.0.0) for demo assets, while also refreshing transitive dependencies in the lockfile.

(dependencies) · high confidence

Housekeeping

Added example project scaffolding and documentation

The example directory now includes a .gitignore file tailored for Flutter/Dart development, a .metadata file tracking the Flutter SDK revision and channel, and a README.md providing standard getting-started resources. These additions establish the basic project structure and configuration for the example application without altering any functional code.

example · 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.3 → 67.9 (+3.6)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 87.4 → 84.1 (-3.3)
  • Architecture 98.5 → 98.0 (-0.5)
  • Maturity 56.0 → 58.8 (+2.8)
  • Readiness 53.7 → 62.3 (+8.6)
  • Security 94.7 → 94.7 (0.0)

Resolved (2)

  • Duplicated block (7 lines × 8) (lib/src/effects/color_transition_effect.dart)
  • Near-duplicate member family (8 members, 11 shared lines) (lib/src/effects/color_transition_effect.dart)

New (4)

  • Edited copies of one member (3 members, 8+ corresponding lines) (lib/src/smooth_page_indicator.dart)
  • Edited copy of a member (13 corresponding lines) (lib/src/effects/customizable_effect.dart)
  • Edited copy of a member (15 corresponding lines) (lib/src/painters/scale_painter.dart)
  • Members sharing a duplicated core (8 members, 50+ identical tokens) (lib/src/effects/color_transition_effect.dart)

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

Survey your own repository

Milad-Akarie/smooth_page_indicator 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 17 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 bb6402dd2d94dc8f44ec3f13b580d7148354884e — 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.85+preprod-eba6548ac50f.