riverpod_paging_utils 1.0.0

Flutter/Riverpod pagination utilities. Easily build screens with loading/error states. Supports page, offset, and cursor-based pagination.

1.0.0 - 2026-01-04

Breaking Changes

• Riverpod 3.0 migration
  • Requires flutter_riverpod ^3.0.0
  • Removed dependency on copyWithPrevious (now @internal in Riverpod 3)
  • Load-more state is now managed within PagingData using LoadNextStatus enum
  • Added loadNextStatus, loadNextError, loadNextStackTrace fields to PagingData
• SDK requirements updated
  • Dart SDK: >=3.7.0
  • Flutter SDK: >=3.32.0

Added

• LoadNextStatus enum (idle, loading, error) for tracking load-more state
• isLoadingNext and hasLoadNextError getters on PagingData
• PagingHelperViewTheme now exported as public API
• showSecondPageError property added to PagingHelperViewTheme

Migration Guide

1. Update flutter_riverpod to ^3.0.0
2. Run dart run build_runner build to regenerate code
3. If using showSecondPageError parameter directly on PagingHelperView, move it to PagingHelperViewTheme

Notes

• ProviderListenable and Refreshable are imported from package:flutter_riverpod/misc.dart
  • These are no longer exported from the public Riverpod API
  • Import path may change in future Riverpod versions

0.8.1 - 2025-06-17

• ｀test: add comprehensive test coverage for paging utilities by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/43
• feat(example): Add GridView support example by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/47
• feat: Add PagingHelperSliverView for CustomScrollView support by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/48

0.8.0 - 2025-04-07

• add: melos by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/33
• improve: update packages by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/40

0.7.0 - 2024-06-15

• Refactor!: Ensure endItemView is non-null by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/29
• refactor: class modifier by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/31
• Chore: new sample by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/32

0.6.1 - 2024-06-13

• [Refactor]: Refactor CI by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/25
• [Improve]: add format check and code gen check by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/27

0.6.0 - 2024-06-03

• refactor: onRefresh callback by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/21
• del!: Since we added an error UI on the second page and beyond, we will remove the error display in the Snackbar. by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/23

0.5.0 - 2024-06-02

• UI Customization Sample by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/16
• change lint package by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/18
• skip unnecessary ci check by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/19
• add: enableRefreshIndicator and enableErrorSnackBar to PagingHelperVi… by @K9i-0 in https://github.com/K9i-0/riverpod_paging_utils/pull/20

0.4.3 - 2024-06-01

0.4.2 - 2024-06-01

0.4.1

• Update Readme.

0.4.0

• Added support for using Riverpod providers with family and keepAlive: true.

0.3.1

• Added GIFs to README

0.3.0

• Added a screen for when an error occurs while fetching the second page and beyond.
• You can disable the new error screen by setting showSecondPageError to false.
• Added an example to example that demonstrates the behavior when an error occurs.

0.2.0

• Added PagingHelperViewTheme: Introduced a new ThemeExtension to enable highly customizable styling for the PagingHelperView widget. Developers can now easily tailor the loading, error, and end-of-list views to match their application's design.

ThemeData(
  extensions: [
    PagingHelperViewTheme(
      loadingViewBuilder: (context) => CircularProgressIndicator(),
      // ... other customizations
    ),
  ],
  // ... rest of your theme
)

0.1.0

• Initial version.