Skip to content
pubscout

waterfall_flow

3.1.1, released 2 years ago by fluttercandies.com

A Flutter grid view that builds waterfall flow layouts quickly.

WASM-ready
$ flutter pub add waterfall_flow
Source repository

What it does

Provides a custom grid view and sliver implementation that renders items in a waterfall (masonry) layout. Supports fixed cross axis count and max cross axis extent delegates with customizable spacing and garbage collection tracking.

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

Use it when

  • You need a masonry or waterfall style grid layout in Flutter.
  • Items in your grid have variable heights.

Skip it when

  • You only need a standard uniform GridView where all items are the same size.

Strengths

  • Supports both fixed cross axis count and max cross axis extent.
  • Provides callbacks for garbage collection and viewport tracking.
  • Handles custom last child layout types like footers or load-more items.

Weaknesses

  • Depends on extended_list_library which might increase maintenance surface.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
2
WaterfallFlow.builder(
  padding: EdgeInsets.all(5.0),
  gridDelegate: SliverWaterfallFlowDelegateWithFixedCrossAxisCount(
    crossAxisCount: 2,
    crossAxisSpacing: 5.0,
    mainAxisSpacing: 5.0,
  ),
  itemBuilder: (context, index) {
    return Container(child: Text('Item $index'));
  },
)

Alternatives

Packages that do the same job and could replace waterfall_flow.

Works with

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