xuelongqy/flutter_easy_refresh
60.2
Adequate · 12 November 2026
19.1k
lines of production code
Dart
primary language
8
measurements over time
What this system is
Features
Add BowHeader and BowFooter indicators with Rive animation support
This release introduces BowHeader and BowFooter, new pull-to-refresh and load-more indicators that use Rive animations for a 'bow' visual effect. The package now requires Flutter \>=3.47 and Dart ^3.13, and depends on material\_ui and rive. Users must initialize RiveNative before runApp() and can configure standard EasyRefresh parameters like triggerOffset, spring, and safeArea. The indicators support vertical scrolling only and include bundled assets, with usage guidance provided via an AI agent skill.
_packages/easy\_refresh\bow · high confidence
Add PathIcons class with SVG paths for Alipay, WeChat, GitHub, and Dart
A new \PathIcons\ class has been added to the example application, providing static SVG path data for four specific icons: Alipay, WeChat, GitHub, and Dart. This allows the example app to render these specific brand icons using the provided vector paths.
example/lib/widget/icon · high confidence
Add cryptocurrency asset icons
The example assets now include SVG icon images for several cryptocurrencies, including Bitcoin, BNB, Dogecoin, Ethereum, Matic, TRX, USDC, and USDT, as well as a generic 'more' icon. These assets are available in the \example/assets/image/cryptocurrency/\ directory for use in the application's UI.
example/assets · high confidence
Add home page with tabbed navigation
The example app now includes a main home page that provides tabbed navigation between the Sample, Style, and More sections using a PageView and BottomNavigationBar.
example/lib/page · high confidence
Added English and Simplified Chinese translations for the example app
The example application now supports localization in English and Simplified Chinese. This change adds comprehensive translation strings for UI elements, including navigation labels, theme options, and specific descriptions for new features such as the on-edge trigger modes, nested scroll view behaviors, and various indicator styles.
example/lib/l10n/translations · high confidence
Added Windows Flutter build configuration and plugin registration
The example application now supports building on Windows by introducing the necessary Flutter engine integration files. This includes a CMake build script that configures the Flutter library and C++ client wrappers, alongside generated plugin registrant files that automatically register the \rive\_native\ and \url\_launcher\_windows\ plugins for the Windows platform.
example/windows/flutter · high confidence
Added Windows runner for the example application
The example application now includes a native Windows runner, enabling users to build and run the app on Windows desktop. This change adds the necessary CMake build configuration, C++ source files for the Win32 window and Flutter view controller, and resource files (manifest, icon, version info) to support the platform.
example/windows/runner · high confidence
Added macOS example application support
The macOS example project has been added, enabling users to run and test the library on macOS. This includes the full Xcode project structure, native Swift entry points (AppDelegate and MainFlutterWindow), and localization files for Simplified Chinese, Traditional Chinese, and Hong Kong Chinese.
example/macos · high confidence
Added utility for generating contrasting text colors
A new ColorUtils helper class has been added to the example application's utility library. It provides methods to generate a deterministic background color from a string input and automatically calculates a contrasting foreground color (black or white) based on the background's luminance, ensuring readability for text displayed on those backgrounds.
example/lib/util · high confidence
Added web platform support for the example app
The example application now supports the web platform. This change introduces the necessary \index.html\ entry point and \manifest.json\ configuration, enabling the app to be built and run as a web application with proper metadata, icons, and base href handling.
example/web · high confidence
Introduction of EasyPaging widget for Flutter pagination
A new EasyPaging widget has been added to the library, providing a convenient way to handle pagination in Flutter applications. It integrates with the easy\_refresh package to support pull-to-refresh and infinite scrolling (load-more) behaviors. The widget allows developers to define custom item builders, configure physics for overscroll effects, and control behaviors such as simultaneous refresh/load, handling of 'no more data' states, and automatic refresh on start.
_packages/easy\paging/lib · high confidence
New example app navigation structure
The example application now includes a centralized routing configuration in \example/lib/config/routes.dart\. This file defines the URL paths and page mappings for the app's navigation, covering the home screen, various sample pages (such as profile, carousel, and paging), multiple style indicator demos (including bezier, phoenix, and bubbles), and additional utility pages like theme switching and cryptocurrency info.
example/lib/config · high confidence
New example pages for additional pull-to-refresh indicator styles
The example app now includes dedicated pages to demonstrate several new pull-to-refresh indicator styles: Bezier, BezierCircle, Bow, Bubbles, Delivery, Halloween, Phoenix, Skating, Space, and Squats. These pages showcase the visual appearance and behavior of these indicators within the EasyRefresh library, providing users with interactive examples of how to implement and customize these specific styles in their own applications.
example/lib/page/style · high confidence
New example pages for theme switching, cryptocurrency donations, and support options
The example app now includes several new pages in the 'More' section. Users can switch between system, light, dark, and various color-themed UI modes via the new ThemePage. A new SupportMePage allows users to star the repository, like on Pub, or donate via Alipay, WeChat, or cryptocurrency. The CryptocurrencyPage displays donation addresses and QR codes for Ethereum, Tron, Bitcoin, and Dogecoin. These pages are accessible through the updated MorePage navigation.
example/lib/page/more · high confidence
New example widgets for list items, bottom bar, SVG paths, and skeletons
The example app now includes four new reusable widget components in the \example/lib/widget\ directory: \ListItem\ (a customizable list tile with support for icons, SVG paths, and dividers), \MenuBottomBar\ (an expandable bottom card with refresh/load actions and animation), \PathsPaint\ (a widget for rendering SVG path strings with scaling and multi-color support), and \SkeletonItem\ (a loading placeholder widget that adapts to vertical or horizontal layouts). These additions enhance the demo's UI capabilities and provide reusable patterns for list-based interfaces and loading states.
example/lib/widget · high confidence
New sample pages for advanced EasyRefresh patterns
The example app now includes dedicated sample pages demonstrating new and enhanced EasyRefresh capabilities: CarouselPage for nested scrollable carousels, ChatPage for chat-style message lists, ListenerHeaderPage for custom header state listening, NestedScrollViewPage and TabBarViewPage for complex nested scrolling with tabs, PageViewPage for swipeable pages, PagingPage for the new EasyPaging widget, RefreshOnStartPage for auto-refreshing on load, SecondaryPage for secondary header interactions, and SamplePage as the navigation hub. These samples illustrate how to use features like nested scroll views, custom listeners, paging, and secondary headers in real-world scenarios.
example/lib/page/sample · high confidence
Removals
Removal of generated English localization file
The auto-generated \lib/generated/i18n.dart\ file, which provided English language support and localization delegates for the application, has been removed. This change eliminates the built-in English string resources and localization infrastructure defined in this specific file.
lib/generated · high confidence
Removal of legacy EasyRefresh refresher implementation
The legacy \EasyRefresh\ widget and its associated state management logic, including custom scroll physics and animation controllers for pull-to-refresh and load-more behaviors, have been removed from the library source. This deletion eliminates the deprecated refresher component that previously handled header/footer views and scroll state callbacks directly within the \refresher.dart\ file.
lib/src · high confidence
Behavioural changes
Bubbles, Halloween, and Skating indicators migrate to Rive state machines and require Flutter 3.47
The Bubbles, Halloween, and Skating pull-to-refresh indicators have been updated to version 2.0.0, requiring Flutter \>=3.47 and Dart ^3.13. These packages now rely on the \material\_ui\ and \rive\ (v0.14.11) dependencies, replacing previous animation implementations with Rive state machines (e.g., 'Motion', 'Reload') and custom painters. Users must initialize \RiveNative\ before \runApp\ and can no longer rely on the old animation APIs; the indicators remain vertical-only and bundle their \.riv\ assets internally.
(repo-wide) · high confidence
Example app migrated to easy\_refresh with GetX localization and responsive UI
The example application has been updated to use the renamed \easy\_refresh\ package (importing \package:easy\_refresh/easy\_refresh.dart\ instead of \flutter\_easyrefresh\). It now utilizes GetX for state management and internationalization, replacing the previous manual string handling with \flutter\_localizations\ and ARB translation files for English and Chinese. The UI has been significantly restructured to support responsive layouts, allowing users to toggle between a mobile-style framed view and a full-screen desktop layout, and includes initialization for Rive animations.
example/lib · high confidence
Library entry point file removed
The main library entry point file \lib/easy\_refresh.dart\ has been deleted. This file previously served as the primary import path for the package, exporting the core \refresher.dart\ module. Users relying on this specific import path will need to update their imports to the new package structure.
lib · high confidence
Migrate example app to Flutter V2 embedding and AndroidX
The Android example app has been updated to use the Flutter V2 embedding, migrating from the legacy io.flutter.app.FlutterActivity to the new io.flutter.embedding.android.FlutterActivity. This change includes updating the AndroidManifest.xml to declare the V2 embedding, adding a NormalTheme for the post-launch UI, and switching the application package from com.qingyi.easyrefresh.example to com.codiss.easy.refresh.example. Users running the example on Android will benefit from compatibility with modern Flutter versions and AndroidX libraries.
example/android · high confidence
Migrate to Flutter 3.47 and update Space indicator dependencies
The easy\_refresh\_space package has been updated to require Flutter 3.47 and Dart 3.13, introducing breaking changes that necessitate upgrading the \material\_ui\ and \rive\ dependencies. Users must now initialize \RiveNative\ before running their app and ensure their projects meet the new minimum version requirements to use the SpaceHeader and SpaceFooter indicators.
_packages/easy\_refresh\space · high confidence
Removal of English localization file
The English localization file (strings\_en.arb) has been removed from the resources directory. This change eliminates the specific English string resources, which may impact the app's ability to display English text if no other localization fallbacks are in place.
res · high confidence
iOS example app upgraded to modern Xcode and Flutter tooling standards
The iOS example project has been migrated to support modern iOS development practices, including the adoption of the SceneDelegate for lifecycle management and the removal of the deprecated MinimumOSVersion constraint. It now integrates CocoaPods for dependency management, utilizes the FlutterGeneratedPluginSwiftPackage for plugin registration, and adds Chinese (zh-Hans) localization support. Additionally, the app bundle name was changed to 'EasyRefresh', and Xcode scheme settings were updated to enable GPU validation and LLDB integration for improved debugging.
example/ios · high confidence
Fixes
Generated Swift plugin package file created
A new generated Swift source file (FlutterGeneratedPluginSwiftPackage.swift) has been added to the example iOS Flutter ephemeral packages directory. This file is an auto-generated placeholder indicating the presence of a generated plugin package, with no functional code changes.
example/ios/Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage · low confidence
Test coverage
Added code coverage report for easy\_refresh package; Added comprehensive widget tests for EasyRefresh indicators and controllers; Added unit tests for EasyPaging widget behavior; Added widget tests for example app pages and theme controller; Automated validation of package skill examples; Removed default widget smoke test.
Dependencies
EasyRefresh v4 migration to Material and Cupertino UI packages
The EasyRefresh library has been migrated to use the \material\_ui\ and \cupertino\_ui\ packages, replacing the previous UI dependencies. This update brings the library in line with the new Flutter UI architecture, ensuring compatibility with modern Flutter versions and providing updated styling for the built-in Material and Cupertino indicators.
_packages/easy\refresh/lib · high confidence
Migrate to Dart 3.5+ and Flutter 3.10+ with multi-package workspace
The project has been upgraded to require Dart SDK \>=3.5.0 and Flutter \>=3.10.0, enabling modern language features and framework capabilities. The monorepo structure is now managed via a Dart workspace, consolidating the core \easy\_refresh\ library, the \easy\_paging\ pagination widget, and several Rive-based indicator packages (\easy\_refresh\_bow\, \easy\_refresh\_bubbles\, \easy\_refresh\_halloween\, \easy\_refresh\_skating\, \easy\_refresh\_space\, \easy\_refresh\_squats\) under a single build system. The example app has been updated to use these new packages, upgraded to \rive\ ^0.14.4, and migrated to the modern Android Gradle plugin (AGP 8.9.1) with Java 17 and AndroidX. Additionally, the \flutter\_lints\ dependency has been updated to version 6.0.0 across the workspace.
(dependencies) · high confidence
Updated Android Gradle wrapper to version 8.14.3
The Android example project now uses Gradle 8.14.3 instead of 4.10.2, ensuring compatibility with modern Android build tools and improving build performance and stability.
example/android/gradle · 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 58 → 60 (+2.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 69 → 69 (+0.0)
- Architecture 96 → 96 (+0.0)
- Maturity 56 → 66 (+10.5)
- Readiness 43 → 43 (+0.0)
- Security 97 → 95 (-2.1)
- Performance 100 → 100 (+0.0)
Resolved (5)
- Documentation: no project overview (packages/easy_refresh_squats/README.md)
- Duplicated block (11 lines × 19) (example/lib/example.dart)
- Duplicated block (12 lines × 2) (packages/easy_refresh/lib/src/indicator/footer/footer_locator.dart)
- Duplicated block (12–14 lines × 5) (example/lib/example.dart)
- Duplicated block (54 lines × 2) (example/lib/page/sample/easy_refresh_nested_page.dart)
New (23)
- Duplicated block (11 lines × 19) (example/lib/example.dart)
- Duplicated block (12–14 lines × 5) (example/lib/example.dart)
- Duplicated block (54 lines × 2) (example/lib/page/sample/easy_refresh_nested_page.dart)
- Edited copies of one member (3 members, 11+ corresponding lines) (example/lib/page/sample/nested_scroll_view.dart)
- Edited copies of one member (3 members, 9+ corresponding lines) (packages/easy_refresh_bow/lib/src/bow_indicator.dart)
- Edited copies of one member (4 members, 18+ corresponding lines) (packages/easy_refresh_bow/lib/src/bow_indicator.dart)
- Edited copies of one member (4 members, 21+ corresponding lines) (packages/easy_refresh_bow/lib/src/bow_indicator.dart)
- Edited copies of one member (6 members, 36+ corresponding lines) (packages/easy_refresh_bow/example/main.dart)
- Edited copy of a member (10 corresponding lines) (packages/easy_refresh_space/lib/src/space_indicator.dart)
- Edited copy of a member (12 corresponding lines) (example/lib/page/sample/user_profile_page.dart)
- Edited copy of a member (144 corresponding lines) (example/lib/page/sample/easy_refresh_nested_page.dart)
- Edited copy of a member (17 corresponding lines) (packages/easy_refresh/lib/src/styles/bezier/footer/bezier_footer.dart)
- Edited copy of a member (25 corresponding lines) (packages/easy_refresh/lib/src/indicator/footer/footer_locator.dart)
- Edited copy of a member (25 corresponding lines) (packages/easy_refresh/lib/src/styles/material/footer/material_footer.dart)
- Edited copy of a member (26 corresponding lines) (packages/easy_refresh/lib/src/indicator/footer/footer_locator.dart)
- Edited copy of a member (33 corresponding lines) (packages/easy_refresh/lib/src/notifier/indicator_notifier.dart)
- Edited copy of a member (36 corresponding lines) (packages/easy_refresh/lib/src/styles/classic/footer/classic_footer.dart)
- Edited copy of a member (39 corresponding lines) (packages/easy_refresh/lib/src/indicator/footer/footer_locator.dart)
- Edited copy of a member (48 corresponding lines) (packages/easy_refresh/lib/src/indicator/footer/footer_locator.dart)
- Edited copy of a member (64 corresponding lines) (packages/easy_refresh/lib/src/styles/cupertino/cupertino_indicator.dart)
- …and 3 more
Changes since last survey
- 1 commits — 0 feature/other, 1 fixes
By area
- (repo) — 1 commit
Notable commits
- fix: Merge pull request #918 from Lopution/fix/padding-of-dependency
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
xuelongqy/flutter_easy_refresh 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 dcdbb8143e1277fc02eeef6a3ccb61a8fc0e2862 — 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.