NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #943 most downloaded on pub.dev
Widget that makes it easy to implement a custom pull to refresh gesture.
Latest stable
4.0.2
Last release 2 months ago
25 Aug 2026
Ships unpredictably
gaps range from 2 weeks to 2.1 years
Most releases are documented
notes for 24 of 28 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
56 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
CustomRefreshIndicator: Fixed a crash when the indicator was hidden before the *onRefresh* callback completed. Reported by @KubrickRubrik in #60.
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v4.0.2...v4.1.0-dev.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Removed usages of deprecated Flutter APIs. The minimum supported Dart and Flutter versions remain unchanged.
### Changes: - Fixed missing changelog Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v4.0.0...v4.0.1
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v4.0.0...v4.0.1
Removed deprecated parameters: *indicatorCancelDuration*, *indicatorSettleDuration*, *indicatorFinalizeDuration* and *completeStateDuration* .If you a…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v3.1.2...v4.0.0
Removed deprecated parameters: *indicatorCancelDuration*, *indicatorSettleDuration*, *indicatorFinalizeDuration* and *completeStateDuration* .If you a…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v4.0.0-dev.2...v4.0.0-dev.3
Removed deprecated parameters: *indicatorCancelDuration*, *indicatorSettleDuration*, *indicatorFinalizeDuration* and *completeStateDuration* .If you a…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v4.0.0-dev.1...v4.0.0-dev.2
Removed deprecated parameters: *indicatorCancelDuration*, *indicatorSettleDuration*, *indicatorFinalizeDuration* and *completeStateDuration* .If you a…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v3.1.1...v4.0.0-dev.1
Deprecated the *withRotation* argument of the *CustomMaterialIndicator* widget. The rotation function will be removed in the upcoming version.
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v3.1.1...v3.1.2
Fixed *durations* parameter of *CustomRefreshIndicator* widget. Reported by @jccd1996 in #58.
Added ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.
ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.>=2.17.0 <4.0.0Added ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.
ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.>=2.17.0 <4.0.0Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v3.0.0...v3.1.0-dev.1
Deprecated *indicatorFinalizeDuration*, *indicatorSettleDuration*, *indicatorCancelDuration* and *completeStateDuration* parameters in favor of *durat…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.2.1...v3.0.0
Nothing published for this version
Deprecated *indicatorFinalizeDuration*, *indicatorSettleDuration*, *indicatorCancelDuration* and *completeStateDuration* parameters in favor of *durat…
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.2.1...v3.0.0-beta.2
Nothing published for this version
### Changes: - Fixed typos in documentation Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.2.0...v2.2.1
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.2.0...v2.2.1
Added *clipBehavior* and the *elevation* arguments of the *MaterialIndicatorDelegate* class.
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.1.0...v2.2.0
Updated the dart sdk constraints
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.0.1...v2.1.0
Added missing _isCanceling_ and _isSettling_ getters for _IndicatorState_ and _IndicatorController_ enum.
Changes:
Full Changelog: https://github.com/gonuit/flutter-custom-refresh-indicator/compare/v2.0.0...v2.0.1
Removed deprecated IndicatorStateHelper class. Instead use CustomRefreshIndicator.onStateChanged method.
autoRebuild flag, which is by default set to true.
There is no need to wrap widgets in the builder function with the AnimatedBuilder widget, as it will be automatically rebuilt. For optimization purposes, you can use the old behavior by setting the autoRebuild argument to false.extentPercentageToArmed argument to containerExtentPercentageToArmed which better describes what it exactly does.defaultContainerExtentPercentageToArmed from 0.20 to 0.1(6) to match the behavior of the built-in indicator widget.1.0.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Changes: - Pub.dev readme fixes
Nothing published for this version
Nothing published for this version
Implemented equality operator for *IndicatorStateChange* class.
Now, the *onRefresh* function will be triggered immediately when the indicator is released in the armed state. Previously, the *onRefresh* function wa
1.0.Nothing published for this version
Nothing published for this version
### Changes: - Update readme file
Flutter 3.0.0 migration backward compatibility fix (#31) by Jordan1122
Compatibility improvements for Flutter 3.0.
Fixed assertion issue reported and resolved by ziqq in #29. For more information, please take a look at the following issue #28
### Fixes: - Pub.dev readme file fix. - Fix code formatting issues
Replaced the deprecated disallowGlow method calls with disallowIndicator.
onRefresh method.disallowGlow method calls with disallowIndicator.onStateChanged function argument that allows tracking indicator state changes.IndicatorStateHelper class is now deprecated in favor of onStateChange function and IndicatorStateChange class.show, hide and refresh methods to the CustomRefreshIndicatorState class. It can be accessed via GlobalKey. Take a look at an programmatically-controlled screen example.flutter_lints package for analysis.leadingGlowVisible and trailingGlowVisible in favor of leadingScrollIndicatorVisible and trailingScrollIndicatorVisible arguments.reversed argument that allows you to trigger a refresh indicator from the end of the list.envelope example.pull to fetch more example.Nothing published for this version
Nothing published for this version
Replaced the deprecated disallowGlow method calls with disallowIndicator.
onRefresh method.disallowGlow method calls with disallowIndicator.onStateChanged function argument that allows tracking indicator state changes.IndicatorStateHelper class is now deprecated in favor of onStateChange function and IndicatorStateChange class.show, hide and refresh methods to the CustomRefreshIndicatorState class. It can be accessed via GlobalKey. Take a look at an programmatically-controlled screen example.flutter_lints package for analysis.leadingGlowVisible and trailingGlowVisible in favor of leadingScrollIndicatorVisible and trailingScrollIndicatorVisible arguments.reversed argument that allows you to trigger a refresh indicator from the end of the list.envelope example.pull to fetch more example.Replaced the deprecated disallowGlow method calls with disallowIndicator.
onRefresh method.disallowGlow method calls with disallowIndicator.onStateChanged function argument that allows tracking indicator state changes.IndicatorStateHelper class is now deprecated in favor of onStateChange function and IndicatorStateChange class.show, hide and refresh methods to the CustomRefreshIndicatorState class. It can be accessed via GlobalKey. Take a look at an programmatically-controlled screen example.flutter_lints package for analysis.leadingGlowVisible and trailingGlowVisible in favor of leadingScrollIndicatorVisible and trailingScrollIndicatorVisible arguments.reversed argument that allows you to trigger a refresh indicator from the end of the list.envelope example.pull to fetch more example.Replaced the deprecated disallowGlow method calls with disallowIndicator.
onRefresh method.disallowGlow method calls with disallowIndicator.onStateChanged function argument that allows tracking indicator state changes.IndicatorStateHelper class is now deprecated in favor of onStateChange function and IndicatorStateChange class.show, hide and refresh methods to the CustomRefreshIndicatorState class. It can be accessed via GlobalKey. Take a look at an programmatically-controlled screen example.flutter_lints package for analysis.leadingGlowVisible and trailingGlowVisible in favor of leadingScrollIndicatorVisible and trailingScrollIndicatorVisible arguments.Dart SDK constraints: >=2.12.0-0 <3.0.0
prevState from IndicatorController class.
Because flutter only marks the widget that it is ready for rebuild, it is possible that the controller state will change more than once during a single frame what causes one or more steps to be skipped. To still use prevState and didChangeState method, you can use IndicatorStateHelper. Take a look at check_mark_indicator.dart or warp_indicator.dart for example usage.IndicatorStateHelper class.IndicatorController unit tests.stopDrag method to the IndicatorController class. It allows you to stop current user drag.BREAKING: Removed prevState from IndicatorController class. Because flutter only marks the widget that it is ready for rebuild, it is possible that th
prevState from IndicatorController class.
Because flutter only marks the widget that it is ready for rebuild, it is possible that the controller state will change more than once during a single frame what causes one or more steps to be skipped. To still use prevState and didChangeState method, you can use IndicatorStateHelper. Take a look at check_mark_indicator.dart or warp_indicator.dart for example usage.IndicatorStateHelper class.IndicatorController unit tests.set Dart SDK constraints to: >=2.12.0-0 <3.0.0
Removed material package import.
isComplete and wasComplete controller getters.axis property as it can be handled by notificationPredicate.complete indicator state together with completeStateDuration parameter.IndicatorControler changes:
prevoiusState property.didStateChange helper method.wasArmed, wasDragging, wasLoading, wasHiding and wasIdle properties.notificationPredicate property to the CustomRefreshIndicator widget.check_mark_indicator. Example that shows how to make use of complete state.Added isComplete and wasComplete controller getters.
isComplete and wasComplete controller getters.axis property as it can be handled by notificationPredicate.Added optional complete indicator state together with completeStateDuration parameter.
complete indicator state together with completeStateDuration parameter.IndicatorController changes:
previousState property.didStateChange helper method.wasArmed, wasDragging, wasLoading, wasHiding and wasIdle properties.notificationPredicate property to the CustomRefreshIndicator widget.check_mark_indicator. Example that shows how to make use of complete state.Feedback improvements (thank you for your emails!):
CustomRefreshIndicatorData => IndicatorControllerCustomRefreshIndicatorState => IndicatorStateindicatorBuilder argument is no longer present. Instead use builder argument which has some significant changes.To animate indicator based on IndicatorControler you can use AnimationBuilder widget and pass IndicatorData object as animation argument. Because of that you can implement your own widget rebuild system what can improve your custom indicator performance (instead of building indicator eg. 300 times you can decide when you want to do it). Example:
return CustomRefreshIndicator(
child: ListView(children: <Widget>[/* ... */]),
builder: (
BuildContext context,
/// Subtree that contains scrollable widget and was passed
/// to child argument
Widget child,
/// Now all your data will be stored in controller.
/// To get controller outside of this function
/// 1. Create controller in parent widget and pass it to CustomRefreshIndicator
/// 2. Assign [GlobalKey] to CustomRefreshIndicator and access `key.currentState.controller`.
IndicatorController controller
) {
return AnimatedBuilder(
// IndicatorData extends ChangeNotifier class so it is possible to
// assign it to an AnimationBuilder widget and take advantage of subtree rebuild
animation: controller,
child: MyPrebuildWidget(),
child: child,
builder: (BuildContext context, Widget child) {
/// TODO: Implement your custom refresh indicator
},
);
},
onRefresh: myAsyncMethod,
);
Nothing published for this version
- Upgrade example to AndroidX - Improved README
Added support for BouncingScrollPhysics - ios default scroll physics
BouncingScrollPhysics - ios default scroll physicsExtracted inbox example to `letter_refresh_indicator` package
letter_refresh_indicator packageAdded basic CustomRefreshIndicator widget with CustomRefreshIndicatorData class.
CustomRefreshIndicator widget with CustomRefreshIndicatorData class.SimpleIndicatorContainer widget which simulate default RefreshIndicator containerNothing published for this version
One column per quarter.