Skip to content

Installation

smart_refresher is a powerful Flutter widget designed to provide seamless pull-to-refresh and infinite-scroll loading for any scrollable widget. It is compatible with Flutter 3.47+ and Dart 3.12+, built on the decoupled material_ui and cupertino_ui design packages.

  1. Add Dependency Add smart_refresher to your pubspec.yaml file:

    dependencies:
    smart_refresher: ^1.2.0
  2. Install Package Run the following command in your terminal to fetch the package:

    Terminal window
    flutter pub get
  3. Import the Library Add the import statement to your Dart files where you intend to use the refresher:

    import 'package:smart_refresher/smart_refresher.dart';

smart_refresher supports all major Flutter platforms out of the box:

Platform Support Status
Android ✅ Supported Full Material 3 Support
iOS ✅ Supported Native iOS 17 Feel & Haptics
Web ✅ Supported WASM / CanvasKit Optimized
Desktop ✅ Supported macOS, Windows, Linux
  • Flutter: 3.47.0 or higher
  • Dart: 3.12.0 or higher
  • Design packages: material_ui (^1.1.1) and cupertino_ui (^1.0.2) are declared as direct dependencies and are resolved automatically — no manual setup is needed.
  • Older Flutter? Use smart_refresher ^1.0.x, which targets Flutter 3.27+.