Skip to content
CAI
Software that uses CAICheck a score

peng8350/flutter_pulltorefresh

54.0

Adequate · 12 November 2026

9.9k

lines of production code

Dart

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Flutter library named 'pull\_to\_refresh' that provides a comprehensive SmartRefresher widget for implementing drop-down refresh and pull-up loading in mobile applications. It supports a wide variety of customizable header and footer indicators, including classic, material, and animated styles, along with advanced features like two-level pull gestures and internationalization. The package includes extensive examples demonstrating integration with complex Flutter widgets and various scroll behaviors, serving as both a functional component and a reference for usage patterns.

How it got here

2018 — SmartRefresher v2.0 release and null safety migration

14 changes.

This period focused on the major v2.0 release of the pull-to-refresh library, migrating the codebase to Dart null safety and renaming the package to pull\_to\_refresh. The work introduced the core SmartRefresher widget with comprehensive header and footer indicators, alongside extensive internal physics and localization support. The example application was restructured to demonstrate these new features, including internationalization and configurable refresh behaviors.

2019 — comprehensive example app expansion

8 changes.

This period focused on significantly expanding the example application to demonstrate the full range of pull-to-refresh capabilities. New demo pages were added to showcase various indicator styles, custom animations, and complex integration patterns with Flutter widgets like nested scroll views and staggered grids. The work provided users with a comprehensive suite of usage examples covering basic refresh, advanced customization, and edge cases.

Features

Add demo UI scaffolding and navigation components

The example application now includes core UI structure files to support navigation and display. Item.dart provides a reusable card-based list item widget. MainActivity.dart implements the main app shell using a ResideMenu for side navigation and a PageView to switch between the Indicator, Example, and Test pages. SecondActivity.dart adds a basic scaffold with a back-button header for testing navigation flows.

example/lib/ui · high confidence

Demo app now supports internationalization and configurable pull-to-refresh behavior

The example application has been updated to demonstrate the library's localization capabilities, supporting multiple languages including English, Chinese, Japanese, and others via RefreshLocalizations. Additionally, the main entry point now configures the RefreshConfiguration with specific defaults such as a 15px footer trigger distance, disabled vibrate feedback for refresh and load-more actions, and a custom logic to prevent footer following when content is not full, providing a concrete reference for these configuration options.

example/lib · high confidence

Expanded set of pull-to-refresh usage examples

The example app now includes a comprehensive suite of demonstration files in the useStage directory, illustrating advanced pull-to-refresh patterns. These include integrating SmartRefresher with NestedScrollView and TabBarView, handling empty states, forcing a full-page viewport fill, manually hiding footers based on content size, and supporting horizontal or reverse scrolling lists. Additional examples cover a QQ-style chat list with upward scrolling, triggering refresh via a button tap instead of a pull gesture, and implementing two-level refresh interactions.

example/lib/ui/example/useStage · high confidence

Initial release of SmartRefresher pull-to-refresh component

Introduces the \SmartRefresher\ widget in \lib/src/smart\_refresher.dart\, providing a comprehensive solution for drop-down refresh and pull-up loading in Flutter applications. The component supports multiple header and footer indicator styles (Follow, UnFollow, Behind, Front for headers; ShowAlways, HideAlways, ShowWhenLoading for footers), a two-level pull gesture, and global configuration via \RefreshConfiguration\. It exposes detailed state management through \RefreshController\ and enums for \RefreshStatus\ and \LoadStatus\, allowing developers to control and react to refresh and load states programmatically.

lib/src · high confidence

Initial release of pull-to-refresh internals

This change introduces the core internal implementation for the pull-to-refresh library, including the scroll physics engine, sliver-based header and footer widgets, localization support for multiple languages, and the indicator wrapper logic. Users gain access to a complete, configurable refresh and load-more experience with support for custom indicators, internationalized strings, and platform-specific scroll behaviors.

lib/src/internals · high confidence

New and updated pull-to-refresh indicators

The indicator library now includes several new visual styles and capabilities: a BezierHeader with configurable dismissal animations (BezierDismissType), a MaterialClassicHeader that mimics Flutter's native RefreshIndicator with spring physics, a WaterDropMaterialHeader combining the waterdrop effect with material styling, and a TwoLevelHeader for implementing two-level pull-to-refresh interactions. Additionally, the ClassicHeader and ClassicFooter have been updated to support internationalization via localizations, and a new CustomHeader/CustomFooter pair allows fully custom indicator builders.

lib/src/indicator · high confidence

New custom indicator examples for GIF, Shimmer, SpinKit, and linked headers

The example app now includes new demonstration files in the custom indicator section, showing how to implement animated refresh and load indicators. These examples cover GIF-based indicators (with header and footer support), Shimmer loading effects, custom SpinKit animations, and a linked header pattern that allows the indicator to be positioned outside the scroll view (such as in an app bar). These additions help users see how to integrate third-party animation packages and custom widgets with the pull-to-refresh library.

example/lib/ui/example/customindicator · high confidence

New custom pull-to-refresh indicators and scroll behavior examples

The example app now includes several new demonstration files in the 'other' directory that showcase advanced customization capabilities. Users can see how to implement a custom 'RunningHeader' with slide and scale animations, integrate a 'SpinKitFadingCircle' loading indicator, and apply 'Shimmer' effects to both header and footer indicators. Additionally, the examples demonstrate how to customize the overscroll glow behavior on Android via a custom ScrollBehavior, handle reordering within a refreshable list, and use an ExpandedViewport to manage layout when content is not full.

example/lib/other · high confidence

New demo activity for base indicator customization

Added IndicatorActivity, a new demo page that showcases the base pull-to-refresh indicators. This activity allows users to test header and footer widgets with configurable options such as reverse scrolling and over-scroll enabling, providing a concrete example of how to integrate and customize the refresh indicators in a Flutter application.

example/lib/ui/indicator/base · high confidence

New example demos for combining SmartRefresher with complex Flutter widgets

The example app now includes new demo files in the \otherwidget\ directory showing how to integrate SmartRefresher with \DraggableScrollableSheet\, \ExpansionPanelList\, \SliverAnimatedList\, \PageView\, \ReorderableList\, and \StaggeredGridView\/\StickyHeader\. These examples demonstrate specific patterns such as using \StatefulBuilder\ for bottom sheets, handling \mounted\ checks in state updates, and configuring pull-to-refresh within custom scroll views.

example/lib/ui/example/otherwidget · high confidence

New example page showcasing various refresh and load-more scenarios

The example application now includes a dedicated ExamplePage that serves as a central hub for demonstrating different usage patterns of the library. This page organizes examples into categories, allowing users to explore features such as basic refresh, manual footer hiding, horizontal scrolling, button-triggered refresh, nested scroll view integration, QQ-style chat lists, empty state handling, two-level refresh, forced full-screen filling, animated lists, expansion panels, draggable bottom sheets, and staggered grids with sticky headers.

example/lib/ui/example · high confidence

Added IndicatorPage.dart, a demo page that displays a grid of pull-to-refresh indicator examples. It demonstrates various header styles (Classic Follow/UnFollow, QQ/WaterDrop, Material Classic, Bezier Circle, WaterDrop Material) and footer load styles (ShowAlways, HideAlways, ShowWhenLoading) by navigating to IndicatorActivity with the corresponding configurations.

example/lib/ui/indicator · high confidence

Removals

Removed default Flutter demo application scaffold

The default \main.dart\ file, which previously provided a generic Flutter counter application template, has been removed from the demo directory. This change eliminates the boilerplate starter code, likely to allow the demo to focus on specific library usage examples rather than the generic app structure.

demo · high confidence

Behavioural changes

Android demo app renamed to PullRefreshDemo

The Android example application has been moved from the 'demo' directory to 'example' and its display label updated from 'demo' to 'PullRefreshDemo' in the AndroidManifest.xml, ensuring the app icon and title reflect its specific purpose.

example/android · high confidence

Example project directory renamed from demo to example

The example project directory has been renamed from 'demo' to 'example'. This includes the relocation of the iOS workspace configuration and associated metadata files to reflect the new directory structure.

example, example/ios/Runner.xcworkspace · high confidence

Library entry point renamed and reorganized

The main library entry point has been renamed from \flutter\_pulltorefresh.dart\ to \pull\_to\_refresh.dart\. The old entry point, which contained unrelated placeholder code, has been removed and replaced with a new file that exports the core \SmartRefresher\, various indicator implementations (Classic, WaterDrop, Custom, Link, Material, Bezier, TwoLevel), internal physics and wrap utilities, and localizations.

lib · high confidence

Migrate iOS example project to modern Xcode build system and update bundle identity

The iOS example project has been moved from the demo directory to the example directory and reconfigured to use the modern Xcode build system. This includes switching the shell script build phase to use the 'embed\_and\_thin' backend, removing manual framework embedding references in favor of automatic handling, and setting the code signing style to Automatic with a specific development team (Z598PJ2NUG). Additionally, the minimum iOS deployment target is set to 11.2, and the product bundle identifier has been changed from 'com.jpeng.demo' to 'com.jpeng.demo1'.

example/ios/Runner.xcodeproj · high confidence

Updated iOS build configuration to include CocoaPods settings

The iOS example project's build configuration files (Debug.xcconfig and Release.xcconfig) have been updated to explicitly include the CocoaPods target support files. This ensures that the build process correctly incorporates settings from the Pods directory, which is necessary for proper integration with CocoaPods-managed dependencies.

example/ios/Flutter · high confidence

iOS example app renamed and localized

The iOS example application has been moved from the 'demo' directory to 'example' and renamed from 'demo' to 'PullRefreshDemo'. Additionally, the app's Info.plist has been updated to support French and Simplified Chinese localizations alongside English.

example/ios/Runner · high confidence

Test coverage

Added UI test examples for pull-to-refresh scenarios; Added widget tests for SmartRefresher behavior and configuration.

Dependencies

Upgrade to null safety and rename package to pull\_to\_refresh

The library has been upgraded to support Dart null safety, requiring a minimum SDK version of 2.12.0 and Flutter 2.0.0. The package name has been changed from flutter\_pulltorefresh to pull\_to\_refresh, and the version has been bumped to 2.0.0. The example app has also been renamed to 'example' and updated to use the new package path, along with adding several new dependencies for demonstration purposes.

(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 52 → 54 (+1.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 76 → 74 (-1.9)
  • Architecture 99 → 99 (-0.3)
  • Maturity 42 → 50 (+8.4)
  • Readiness 36 → 36 (+0.0)
  • Security 100 → 100 (+0.0)
  • Performance 100 → 100 (+0.0)

Resolved (7)

  • Documentation: no project overview (README.md)
  • Documentation: no usage examples (README.md)
  • TodoComment repeated across 10 files (example/lib/other/shimmer_indicator.dart)
  • TodoComment repeated across 19 files (example/lib/other/RunningHeader.dart)
  • TodoComment repeated across 22 files (example/lib/ui/SecondActivity.dart)
  • TodoComment repeated across 28 files (example/lib/other/shimmer_indicator.dart)
  • TodoComment repeated across 29 files (example/lib/other/shimmer_indicator.dart)

New (8)

  • Edited copy of a member (13 corresponding lines) (lib/src/indicator/material_indicator.dart)
  • Edited copy of a member (16 corresponding lines) (example/lib/ui/example/customindicator/footer_underscroll.dart)
  • Edited copy of a member (29 corresponding lines) (lib/src/indicator/classic_indicator.dart)
  • TodoComment repeated across 10 files (test/test_indicator.dart)
  • TodoComment repeated across 19 files (lib/src/smart_refresher.dart)
  • TodoComment repeated across 22 files (lib/src/internals/indicator_wrap.dart)
  • TodoComment repeated across 28 files (lib/src/smart_refresher.dart)
  • TodoComment repeated across 29 files (test/test_indicator.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

peng8350/flutter_pulltorefresh 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 12 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 0be096c1a822fb03b38115cd76d1bee7e5afdaa2 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — 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.42+preprod-6bc2a431cb25.