pub.dev · #1660 most downloaded on pub.dev

easy_refresh

4.0.044K downloads/moxuelongqy/flutter_easy_refresh ↗New releases in your daily digest, changelog included.

A flutter widget that provides pull-down refresh and pull-up load.

Last release 5 days ago
03 Oct 2026
Ships unpredictably
gaps range from 2 weeks to 1.9 years
Nearly every release is documented
notes for 43 of 44 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
44 releases · first in 2022

Release timeline

44 releases since 2022

20222023202420252026

20222026

One column per quarter.

Releases

4.0.03 Oct 2026Breaking2 sources agree

Note: This release has breaking changes.

EasyRefresh v4.0.0 is now available on pub.dev.

Requirements and migration

Flutter 3.47.0+ and Dart 3.13.0+ (Dart SDK constraint: ^3.13.0).
v4 uses material_ui and cupertino_ui. Follow the updated README when migrating.
Apps that continue to use Flutter's existing material.dart widgets should stay on easy_refresh: ^3.5.1.

Published packages

Package	Version
easy_refresh	4.0.0
easy_paging	4.0.0
easy_refresh_bow	2.0.0
easy_refresh_bubbles	2.0.0
easy_refresh_halloween	2.0.0
easy_refresh_skating	2.0.0
easy_refresh_space	2.0.0
easy_refresh_squats	2.0.0

Changes

Note: This release has breaking changes.

BREAKING FEAT: migrate to material_ui and cupertino_ui for Flutter 3.47.
BREAKING: Remove the unused pre-Flutter 3.32 kBezierSpringBuilderBelow3_32 helper.
FEAT: Expose strokeWidth, strokeAlign, strokeCap, elevation, indicatorMargin, and indicatorPadding on MaterialHeader and MaterialFooter.
CHORE: Upgrade to material_ui 1.5.0 and cupertino_ui 1.1.1; use floating-point color alpha supported by Flutter 3.47.
Requires Flutter >= 3.47 and Dart ^3.13.
Built-in indicators resolve Theme and localizations from package:material_ui / package:cupertino_ui.
Apps still using package:flutter/material.dart should stay on easy_refresh: ^3.5.1.
FEAT: NestedScrollView-safe physics, EasyRefresh.nested, and isNested as nested-safe physics (not bouncing patches).
FIX: NestedScrollView retracts Header before collapsing the AppBar when pushing up, so releasing below trigger no longer starts a refresh.
FIX: Completing refresh while the NestedScrollView AppBar is collapsed no longer flashes the AppBar background.
FIX: Nested TabBarView Footer / callLoad bind the visible inner instead of the first attached tab (#735).
FIX: Inner EasyRefresh auto-adopted into NestedScrollView keeps nested-safe state across parent rebuilds (#758).
FIX: NestedScrollView ballistic result / RenderBox.size asserts after refresh or load (#627, #652, #908).
FIX: NestedScrollView ClassicFooter remaining after load (#678).
FIX: Page-level Nested refresh, per-tab Footer, and per-tab EasyRefresh isolation (#508, #725, #838).
FIX: EasyRefresh.builder preserves Footer overscroll across keyboard-driven viewport changes (#890).
FIX: Remove unused ValueNotifier wrappers from ballistic simulation state snapshots (#916).
FIX: Hide the opposite indicator while refresh/load tasks are mutually exclusive, while preserving non-clamping overscroll (#872).
FIX: Stop carrying stale Footer rebound velocity after appended content expands the scroll extent (#831).
FIX: Remove duplicate Cupertino indicator keys that could conflict during AnimatedSwitcher transitions (#719).
FIX: Allow Header/Footer positions already beyond maxOverOffset to rebound toward the valid range without returning an invalid boundary delta (#650).
FEAT: Add IndicatorTriggerMode.onEdge for Header/Footer drag-start triggering while preserving the existing anywhere default (#606).
Ship 3 package skills with complete examples and package-specific guidance.
Update usage documentation and skill installation instructions.
FIX: Resume Header/Footer rebound after a tap interrupts the closing animation (#913).
FIX: Support secondary-page closing gestures and interrupted animations with NestedScrollView, including automatically detected nested positions (#853).

Try the example

Online example
Download the attached app-release.apk for Android (Android 7.0/API 24 or newer; arm64-v8a, armeabi-v7a, and x86_64).
Android example version: 4.0.0+2 (--build-number=2; previous release used versionCode=1). Built with Flutter 3.47.2 / Dart 3.13.2.
The APK uses the example's existing debug certificate and is intended for demonstrating the library.
Web output includes local CanvasKit and Rive runtimes and uses relative paths for subdirectory deployment.

APK SHA-256:

3ba3cae1ab3b9d1bbd4f59e24e4581e881f3c1473f7a24d42cc399c7b0a04c5d  app-release.apk

Validation

Package CI passed on Flutter 3.47.0 and 3.47.3.
All eight pub.dev versions were verified, and a separate consumer installed and tested the published packages.
Release APK build, version, native architectures, ZIP integrity, and signature verification passed.
Web Wasm and JavaScript builds were checked in a browser, including the Rive-based Bow example.

Additional notes

Publish easy_refresh-v4.0.0.

Open source →

Additional notes

Note: This release has breaking changes.

BREAKING FEAT: migrate to material_ui and cupertino_ui for Flutter 3.47.
No longer depends on material_ui directly; use package:flutter/widgets.dart.
Ship 1 package skill with complete examples and package-specific guidance.
Update usage documentation and skill installation instructions.

Open source →

Additional notes

v4.0.0 Latest

Latest

Compare

Choose a tag to compare

Open source →

3.5.114 Jun 20263 sources agree

FIX: Use withAlpha instead of withValues (https://github.com/xuelongqy/flutter_easy_refresh/issues/911).

FIX: Use withAlpha instead of withValues (https://github.com/xuelongqy/flutter_easy_refresh/issues/911).

Open source →

3.5.023 Mar 2026

FIX : material clamping spring ( #885 ) ( #620 ).

FIX: material clamping spring (#885) (#620).
FIX: mode unchange when not released (#894).
FIX: secondary page.
FIX: effective scroll position.
FIX: footer mode (#905).
FIX: clamping animation controller (#907).
FEAT: easy paging.
FEAT: update rive.
FEAT: update readme.
FEAT: workspace.
BREAKING FEAT: Added EasyRefresh.isNested parameter to determine whether to handle NestedScrollView. In versions 3.4.0 and earlier, no setting is required.
FIX: Adjust the Flutter version, Flutter >=3.10.0.

Open source →

Additional notes

FIX: material clamping spring (https://github.com/xuelongqy/fl…

Open source →

Additional notes

FEAT: easy paging.

Open source →

Additional notes2 sources agree

FIX: material clamping spring (https://github.com/xuelongqy/flutter_easy_refresh/issues/885) (https://github.com/xuelongqy/flutter_easy_refresh/issues/620).
FIX: mode unchange when not released (https://github.com/xuelongqy/flutter_easy_refresh/issues/894).
FIX: secondary page.
FIX: effective scroll position.
FIX: footer mode (https://github.com/xuelongqy/flutter_easy_refresh/pull/905).
FIX: clamping animation controller (https://github.com/xuelongqy/flutter_easy_refresh/issues/907).
FEAT: easy paging.
FEAT: update rive.
FEAT: update readme.
FEAT: workspace.
BREAKING FEAT: Added EasyRefresh.isNested parameter to determine whether to handle NestedScrollView. In versions 3.4.0 and earlier, no setting is required.
FIX: Adjust the Flutter version, Flutter >=3.10.0.

Open source →

Additional notes

v3.5.0

Compare

Choose a tag to compare

Open source →

3.4.014 May 20243 sources agree

breaking: Flutter >=3.7.0, dart >=2.19.0. Remove some unnecessary compatibility, please update the Flutter version in time, or use the previous versio

breaking: Flutter >=3.7.0, dart >=2.19.0. Remove some unnecessary compatibility, please update the Flutter version in time, or use the previous version.
fix: Scroll bar adaptation for unknown platforms #825.
feat: Add BoxDecoration to ClassicHeader and ClassicFooter, Thanks GiampaoloGabba for PR#822.
fix: Compatible with Flutter3.22.0.

Open source →

Additional notes

3.4.0

Compare

Choose a tag to compare

Open source →

3.3.5+124 Apr 20242 sources agree

fix: Indicator properties cannot be updated #818.

fix: Indicator properties cannot be updated #818.

Open source →

Additional notes

3.3.5+1

Compare

Choose a tag to compare

Open source →

3.3.519 Apr 20242 sources agree

fix: Material style performance optimization #814.

fix: Material style performance optimization #814.
fix: Issue during build when IndicatorStateListenable rebinds IndicatorNotifier #607.

Open source →

Additional notes

3.3.5

Compare

Choose a tag to compare

Open source →

3.3.429 Dec 20232 sources agree

fix: EasyPaging.itemBuilder type inference #762.

fix: EasyPaging.itemBuilder type inference #762.
fix: Event notification after dispose #726.
fix: Using refreshOnStart, onRefresh may not be triggered #789.
fix: Using refreshOnStart, scrolling to the bottom when the Header is visible cannot trigger loading #787.

Open source →

Additional notes

3.3.4

Compare

Choose a tag to compare

Open source →

3.3.313 Dec 20232 sources agree

fix: When start on refresh, interrupted by loading #785.

fix: When start on refresh, interrupted by loading #785.
feat: Use Flutter default scroll bar #775.

Open source →

Additional notes

3.3.3

Compare

Choose a tag to compare

Open source →

3.3.3+113 Dec 20232 sources agree

- fix: All styles are lost.

fix: All styles are lost.

Open source →

Additional notes

3.3.3+1

Compare

Choose a tag to compare

Open source →

3.3.2+310 Nov 2023

Nothing published for this version

3.3.218 May 20232 sources agree

fix: BezierIndicator.spinBuilder doesn't work.

fix: BezierIndicator.spinBuilder doesn't work.
feat: Add BezierIndicator.spinInCenter.
feat: Add BezierIndicator.onlySpin #689.
feat: Add support for ScrollPhysics.toleranceFor.
feat: After failure, continue to scroll to trigger the task #718.
feat: [EasyRefresh] noMoreRefresh -> canRefreshAfterNoMore, noMoreLoad -> canRefreshAfterLoad
fix: Use canRefreshAfterNoMore or canRefreshAfterLoad, abnormal NoMore status.
feat: EasyRefreshController.finishRefresh and EasyRefreshController.finishLoad add force parameter.
feat: Add EasyRefresh.triggerAxis, specifies the direction of the trigger.

Open source →

Additional notes

3.3.2

Compare

Choose a tag to compare

Open source →

3.3.2+410 Nov 20232 sources agree

fix: IndicatorNotifier._onCanProcess. Null check operator used on a null value #782, #774.

fix: IndicatorNotifier._onCanProcess. Null check operator used on a null value #782, #774.

Open source →

3.3.2+225 Oct 20232 sources agree

feat: All kind of pointer device are supported by default #777.

feat: All kind of pointer device are supported by default #777.

Open source →

3.3.2+118 May 20232 sources agree

fix: Compatible with versions below Flutter3.10 #722.

fix: Compatible with versions below Flutter3.10 #722.

Open source →

Additional notes

3.3.2+1

Compare

Choose a tag to compare

Open source →

3.3.117 Feb 20232 sources agree

fix: Avoid an endless loop caused by multiple ListViews nested, Thanks LinXunFeng for PR#681.

fix: Avoid an endless loop caused by multiple ListViews nested, Thanks LinXunFeng for PR#681.
fix: FooterNotifier.callTask use callRefreshOverOffset, Thanks AWarmHug for PR#680.
fix: NestedScrollView resize error #666.

Open source →

3.3.1+114 Apr 20232 sources agree

fix: Increase the priority of ClassicIndicator.pullIconBuilder #674.

fix: Increase the priority of ClassicIndicator.pullIconBuilder #674.
fix: fit parameter is invalid #708.

Open source →

3.3.1+227 Apr 20232 sources agree

fix: Secondary click event hit area #688, Thanks notbucai for PR#714.

fix: Secondary click event hit area #688, Thanks notbucai for PR#714.

Open source →

Additional notes

3.3.1+2

Compare

Choose a tag to compare

Open source →

3.3.029 Jan 20232 sources agree

fix: Compatible with Flutter 3.7.

fix: Compatible with Flutter 3.7.

Open source →

3.3.0+11 Feb 20232 sources agree

fix: Removed compatibility code for list height changes #646, #671.

fix: Removed compatibility code for list height changes #646, #671.

Open source →

3.2.210 Jan 20232 sources agree

fix: Compatible with Flutter2.8.1 and below #619.

fix: Compatible with Flutter2.8.1 and below #619.
perf: Pub scores.

Open source →

3.2.2+111 Jan 20232 sources agree

fix: CupertinoActivityIndicator renamed to avoid conflicts.

fix: CupertinoActivityIndicator renamed to avoid conflicts.

Open source →

3.2.2+216 Jan 20232 sources agree

fix: The indicator does not retract when the height of the list changes #618.

fix: The indicator does not retract when the height of the list changes #618.

Open source →

3.2.16 Jan 20232 sources agree

fix: Footer's maxOverOffset property does not work.

fix: Footer's maxOverOffset property does not work.
fix: When maxOverOffset is 0, list scrolling loses inertia.
fix: When there is no task, the mode still changes #608.
fix: HapticFeedback does not work when triggerWhenReach is true.

Open source →

3.2.030 Dec 20222 sources agree

feat: EasyRefreshController add headerState, footerState #635.

feat: EasyRefreshController add headerState, footerState #635.
feat: Add triggerWhenRelease and triggerWhenReleaseNoWait #593.
fix: Error when using NotLoadFooter with clamping. Thanks Pwuts for PR#659.
feat: Add maxOverOffset #590.

Open source →

3.2.0+13 Jan 20232 sources agree

fix: When clamping, triggerWhenRelease is true causing the indicator to be stuck.

fix: When clamping, triggerWhenRelease is true causing the indicator to be stuck.
feat: Material indicator support triggerWhenRelease.

Open source →

3.1.021 Dec 20222 sources agree

feat: Add paging widget [EasyPaging].

feat: Add paging widget [EasyPaging].

Open source →

3.0.527 Nov 20222 sources agree

fix: [EasyRefreshController.callRefresh] and [EasyRefreshController.callLoad] add force #633 #642. Thanks percival888 for PR#639.

fix: [EasyRefreshController.callRefresh] and [EasyRefreshController.callLoad] add force #633 #642. Thanks percival888 for PR#639.
fix: When the height changes when callTask causes the list not to rebound.
feat: Add [EasyRefresh.scrollBehaviorBuilder] and [EasyRefresh.defaultScrollBehaviorBuilder]. Thanks laiiihz for PR#614.

Open source →

3.0.5+112 Dec 20222 sources agree

fix: Clamping refresh, causing Material3 AppBar to change color.

fix: Clamping refresh, causing Material3 AppBar to change color.

Open source →

3.0.41 Aug 20222 sources agree

fix: ScrollMetrics.minScrollExtent != 0.0, offset calculation error.

fix: ScrollMetrics.minScrollExtent != 0.0, offset calculation error.
feat: Supported [ScrollView.center] #581.

Open source →

3.0.4+11 Aug 20222 sources agree

fix: [NestedScrollView.viewportDimension] should use outer's #582.

fix: [NestedScrollView.viewportDimension] should use outer's #582.
fix: Notify UI to update when indicator property changes #582.

Open source →

3.0.4+29 Aug 20222 sources agree

fix: [refreshOnStart] safe area #586.

fix: [refreshOnStart] safe area #586.

Open source →

3.0.4+331 Oct 20222 sources agree

feat: When the content of the list is not full, the infinite scroll does not cross the bounds #588.

feat: When the content of the list is not full, the infinite scroll does not cross the bounds #588.

Open source →

3.0.4+46 Nov 20222 sources agree

fix: Type 'SpringDescription' not found #638.

fix: Type 'SpringDescription' not found #638.

Open source →

3.0.331 Jul 20222 sources agree

fix: processedDuration == Duration.zero, can't rebound #572.

fix: processedDuration == Duration.zero, can't rebound #572.
fix: [clamping] may not have rebound animation.
fix: Indicator overflow #575.
fix: BezierCircleHeader drop overflow.
feat: Supported NestedScrollView.
feat: Supported ScrollController trigger events.

Open source →

3.0.3+131 Jul 20222 sources agree

docs: NestedScrollView example.

docs: NestedScrollView example.

Open source →

3.0.214 Jul 20222 sources agree

feat: Indicator add [triggerWhenReach] #348. Trigger immediately when reaching the [triggerOffset].

feat: Indicator add [triggerWhenReach] #348. Trigger immediately when reaching the [triggerOffset].
feat: CupertinoIndicator support horizontal.

Open source →

3.0.2+115 Jul 20222 sources agree

fix: [viewportDimension] changes may trigger loading.

fix: [viewportDimension] changes may trigger loading.

Open source →

3.0.2+218 Jul 20222 sources agree

fix: ClassicIndicator transition animation.

fix: ClassicIndicator transition animation.
fix: NotRefreshHeader and NotLoadFooter [position] causes tree structure changes.

Open source →

3.0.111 Jul 20222 sources agree

fix: Use notifyListeners after ChangeNotifier disposed. Thanks laiiihz for PR#555.

fix: Use notifyListeners after ChangeNotifier disposed. Thanks laiiihz for PR#555.
feat: ClassicHeader、ClassicFooter add IconThemeData. Thanks Lay523 for PR#562.
feat: ClassicIndicator add [progressIndicatorSize] and [progressIndicatorStrokeWidth].
feat: Add CupertinoIndicator.
fix: finishLoad asset #563.

Open source →

3.0.1+112 Jul 20222 sources agree

fix: CupertinoActivityIndicator radius == 0.

fix: CupertinoActivityIndicator radius == 0.

Open source →

3.0.07 Jul 20222 sources agree

> Framework rewrite, stronger refresh widget.

New version

Framework rewrite, stronger refresh widget.

Supports all scrollable widgets.

Physics scope, no longer limited to child types.

Adjustable scroll parameters, infinite possibilities for the indicator.

Safe area support.

Indicator position setting.

Open source →

3.0.0+17 Jul 20222 sources agree

- fix: .pubignore

fix: .pubignore

Open source →

3.0.0+27 Jul 20222 sources agree

- fix: Scores

fix: Scores

Open source →

3.0.0+38 Jul 20222 sources agree

fix: The screen is not full, [infinite] can not reset.

fix: dart >=2.13.0.
fix: The screen is not full, [infinite] can not reset.
feat: HeaderLocator and FooterLocator add [clearExtent].
feat: Add OverrideFooter and OverrideHeader.

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →