Skip to content
pubscout

infinite_grouped_list

2.1.0, released 9 days ago by esentis.dev

Dynamic scrolling list that efficiently groups items and loads more data as the user scrolls.

WASM-readyUses material_ui
$ flutter pub add infinite_grouped_list
Source repository

What it does

Provides an infinite scrolling list widget that organizes items into groups with sticky headers. It supports both a reactive pattern for state management libraries like BLoC, Riverpod, and Provider, and an imperative pattern with direct data fetching.

AI-written summary of version 2.1.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to display large lists or grids with infinite scrolling and item grouping.
  • You require sticky group headers and group anchoring functionality.
  • You want support for both internal data fetching and modern reactive state management.

Skip it when

  • Your project still relies exclusively on `package:flutter/material.dart` and cannot migrate to `material_ui` (version 2.0.0+).
  • You only need a simple un-grouped list or basic grid without pagination.

Strengths

  • Supports both reactive and imperative usage patterns.
  • Includes features like sticky group headers, group anchoring, and pull-to-refresh.
  • Automatically fetches pages if content does not fill the viewport.

Weaknesses

  • Requires migration to the standalone `material_ui` package for version 2.0.0+.
  • Minimum SDK raised to Dart 3.12.0 / Flutter 3.44.0.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
2

Requires adding material_ui package for version 2.0.0 and above.

InfiniteGroupedList(
  onLoadMore: (paginationInfo) async {
    return await apiService.fetchItems(
      page: paginationInfo.page,
      limit: paginationInfo.limit,
    );
  },
  itemBuilder: (item) => ListTile(title: Text(item.name)),
  groupBy: (item) => item.category,
  groupCreator: (category) => category,
  groupTitleBuilder: (title, _, __, ___) => Text(title),
)

Alternatives

Packages that do the same job and could replace infinite_grouped_list.

Works with

Packages commonly used together with infinite_grouped_list: ones it builds on, ones built on it, and its own family.