NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #351 most downloaded on pub.dev
Provides a collection of Flutter grids layouts (staggered, masonry, quilted, woven, etc.).
Latest stable
0.7.0
Last release 18 days ago
04 Nov 2026
Ships unpredictably
gaps range from 9 days to 3.3 years
Nearly every release is documented
notes for 26 of 26 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
41 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Third pre-release of 0.8.0, with three new options for the layouts. Please try it and report any issue before the stable 0.8.0.
Third pre-release of 0.8.0, with three new options for the layouts. Please try it and report any issue before the stable 0.8.0.
dependencies:
flutter_staggered_grid_view: ^0.8.0-dev.3Full span children in masonry grids (#337): with isFullSpan, some children of a MasonryGridView or a SliverMasonryGrid span the whole width of the grid, like a banner or a section header. They start below all the columns, and the columns are aligned after them.
MasonryGridView.count(
crossAxisCount: 2,
itemCount: items.length,
isFullSpan: (index) => items[index] is Ad,
itemBuilder: (context, index) => ...,
);Sparse placement of StaggeredGrid (#284): with placement: StaggeredGridPlacement.sparse, each tile is placed after the previous one, so the tiles appear in their order, instead of filling the holes left before previous tiles (the default, dense).
alternateDirections on SliverStairedGridDelegate (#261, thanks to whynot-dev for #357): with false, all the tracks of a staired grid are placed in the same direction (a 'Z' sequence) instead of going back and forth.
The example app has an option for each of them, in the app bar of the Masonry, Staggered and Staired pages.
SliverMasonryGridParentData.crossAxisIndex is null for the children spanning the whole cross axis.The package still supports Flutter 3.16 and later. See the CHANGELOG for the details.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
alternateDirections on SliverStairedGridDelegate to place all the tracks in the same direction (a 'Z' sequence) instead of going back and forth (https://github.com/letsar/flutter_staggered_grid_view/issues/261, thanks to whynot-dev for https://github.com/letsar/flutter_staggered_grid_view/pull/357).placement on StaggeredGrid to place the tiles in their order with StaggeredGridPlacement.sparse, instead of filling the holes left before previous tiles (https://github.com/letsar/flutter_staggered_grid_view/issues/284).isFullSpan on MasonryGridView and SliverMasonryGrid to make some children span the whole cross axis, like a banner or a section header (https://github.com/letsar/flutter_staggered_grid_view/issues/337). It is not called after the number of children given by the delegate; when this number is unknown, it can be called with the index following the last child.SliverMasonryGridParentData.crossAxisIndex is null for the children spanning the whole cross axis.Second pre-release of 0.8.0. It contains the masonry layout rewritten in 0.8.0-dev.1, and fixes most of the remaining issues of the other grids. Pleas
Second pre-release of 0.8.0. It contains the masonry layout rewritten in 0.8.0-dev.1, and fixes most of the remaining issues of the other grids. Please try it and report any issue before the stable 0.8.0.
dependencies:
flutter_staggered_grid_view: ^0.8.0-dev.2StaggeredGrid no longer crashes when the spacings are larger than the available space (#362), nor with a reversed axis direction and tiles fitting their content.Infinity or NaN toInt without available space (#361).[1x1, 1x1, 2x2] with 3 columns) no longer throw a RangeError (#221): the tile is placed in the next row where it fits.maxCrossAxisExtent no longer crash without available space.AlignedGridView and SliverAlignedGrid no longer rebuild all their visible children every time they are scrolled (#320).StaggeredGridDelegate and its implementations are exported, so StaggeredGrid.custom can be used (#344).itemBuilder of MasonryGridView and SliverMasonryGrid can return null to end the grid, like ListView.builder (#301, thanks to angcyo for #365).example folder, so it's shown on pub.dev (#333).SliverMasonryGrid and SliverAlignedGrid (#328), the Tile widget used in its examples (#331), and how to give the tiles of a StaggeredGrid another aspect ratio (#308).flutter analyze reports no issues.The package still supports Flutter 3.16 and later. See the CHANGELOG for the details.
StaggeredGridDelegate and its implementations are exported, so that StaggeredGrid.custom can be used (https://github.com/letsar/flutter_staggered_grid_view/issues/344)itemBuilder of MasonryGridView and SliverMasonryGrid can return null to indicate that there are no more children, like ListView.builder (https://github.com/letsar/flutter_staggered_grid_view/issues/301, thanks to angcyo for https://github.com/letsar/flutter_staggered_grid_view/pull/365)example folder, so that it's shown on pub.dev (https://github.com/letsar/flutter_staggered_grid_view/issues/333).SliverMasonryGrid and SliverAlignedGrid (https://github.com/letsar/flutter_staggered_grid_view/issues/328), the Tile widget used in its examples (https://github.com/letsar/flutter_staggered_grid_view/issues/331), and how to size the tiles of a StaggeredGrid with another aspect ratio (https://github.com/letsar/flutter_staggered_grid_view/issues/308).flutter analyze reports no issues.StaggeredGrid when the spacings are larger than the available space (https://github.com/letsar/flutter_staggered_grid_view/issues/362)StaggeredGrid with a reversed axis direction and tiles fitting their content.Infinity or NaN toInt in patterned grids (staired, woven, quilted) without available space (https://github.com/letsar/flutter_staggered_grid_view/issues/361)RangeError with quilted patterns where a tile does not fit in the remaining space of a row (https://github.com/letsar/flutter_staggered_grid_view/issues/221)maxCrossAxisExtent without available space.AlignedGridView and SliverAlignedGrid no longer rebuild all their visible children every time they are scrolled (https://github.com/letsar/flutter_staggered_grid_view/issues/320)Pre-release of the new masonry layout. Please try it and report any issue before the stable 0.8.0.
Pre-release of the new masonry layout. Please try it and report any issue before the stable 0.8.0.
MasonryGridView and SliverMasonryGrid keep the placement of every child laid out once: no more jumps or children changing columns when scrolling back, and multiple masonry grids in a CustomScrollView scroll correctly.mainAxisExtentBuilder: when the extents of the children are known (for example the aspect ratio of images returned by an API), the children are placed without being built. Jumping far or changing the number of columns only builds the visible children, and the scroll extent is exact from the start.MasonryGridView.count(
crossAxisCount: 3,
itemCount: photos.length,
mainAxisExtentBuilder: (index, crossAxisExtent) =>
crossAxisExtent / photos[index].aspectRatio,
itemBuilder: (context, index) => Image.network(photos[index].url),
);ListView), unless mainAxisExtentBuilder is provided.crossAxisCount keeps the first visible child in place.crossAxisCount keeps the state of the visible children; the previous children are placed again when scrolling back.SliverMasonryGrid replaces the children moved with keys, like SliverList.SliverMasonryGridParentData.lastMainAxisExtent has been removed.#338, #335, #299, #286, #265, #244, #330, #356, #313, #105.
See the CHANGELOG for the details.
mainAxisExtentBuilder on MasonryGridView and SliverMasonryGrid to place the children without building them when their extents are known.RenderSliverMasonryGrid.itemCount, the exact number of children set by SliverMasonryGrid, to forget the placement of removed children.RenderSliverMasonryGrid keeps the placement of every child laid out once, instead of guessing the placement of the previous children when scrolling back.ListView), unless mainAxisExtentBuilder is provided.crossAxisCount, the visible children keep their state. The placement of the previous children is checked again when scrolling back, so they can move while the first visible child stays in place. With mainAxisExtentBuilder, every child is placed again right away.crossAxisCount or the mainAxisSpacing of a masonry grid places every child again, and the children are built again (like before).SliverMasonryGrid replaces the children moved with keys, like SliverList, so that inserting a child keeps the state of the others.SliverMasonryGridParentData.lastMainAxisExtent.SliverMasonryGrid in a CustomScrollView (https://github.com/letsar/flutter_staggered_grid_view/issues/338, https://github.com/letsar/flutter_staggered_grid_view/issues/335, https://github.com/letsar/flutter_staggered_grid_view/issues/299, https://github.com/letsar/flutter_staggered_grid_view/issues/286, https://github.com/letsar/flutter_staggered_grid_view/issues/265)estimatedMaxScrollOffset >= endScrollOffset - leadingScrollOffset assertion (https://github.com/letsar/flutter_staggered_grid_view/issues/313)crossAxisCount of a masonry grid keeps the first visible child in place (https://github.com/letsar/flutter_staggered_grid_view/issues/105)crossAxisSpacing is larger than the available space.Bump minimal Flutter version to 3.7.0
Issue with Quilted layout algorithm.
Issue when childCount is 0 with Quilted layout.
SliverAlignedGrid and AlignedGridView widgets.
add StaggeredTile.fit constructor
add StaggeredTile.fit constructor
### Changed * Stable release
Make the childCount parameter of SliverMasonryGrid constructors, null…
Make the childCount parameter of SliverMasonryGrid constructors, null…
childCount parameter of SliverMasonryGrid constructors, nullable and not required.fixed position issue with staired pattern
fixed position issue with staired pattern
bump version 0.5.0-dev.6
bump version 0.5.0-dev.6
Remove extra space on fixed quilted grid (#216).
Issue with Woven pattern layout flow in second run.
Issue with Woven pattern and text direction.
### Fixed * Issue with Quilted pattern.
Complete rewriting of the package. It comes now with 5 differents grid layouts (Staggered, Masonry, Quilted, Woven, Staired).
Add option to disable keepAlives
### Changed * Stable null safety version
LateInitializationError: Local firstIndex has not been initialized.
firstIndex has not been initialized. (https://github.com/letsar/flutter_staggered_grid_view/issues/151)### Added * Support for state restoration
### Added * Null Safety Support
Nothing published for this version
KeepAliveBucket logic, should improve performances
### Added * Support for state restoration.
### Fixed * Flutter version dependency.
### Fixed * Static analysis issues.
Upgrade to AndroidX and fixes the BoxHitTestResult exception
Better fix for the bug where items are built only once.
Fix a bug where items are built only once.
Use the new SliverWithKeepAliveWidget.
### Fixed * Dart 2.1 mixin support.
Fix the rtl support (https://github.com/letsar/flutter_staggered_grid_view/issues/17).
* Add Dart 2 support.
Fix #10 StatefulWidget.createState must return a subtype of State .
StatefulWidget.createState must return a subtype of State<AutomaticKeepAliveVariableSizeBox>.Add a way to let the tile's content to define the tile's extent in the main axis.
fit constructor to StaggeredTile.Add countBuilder and extendBuilder constructors to SliverStaggeredGrid
countBuilder and extendBuilder constructors to SliverStaggeredGrid* Remove Flutter SDK constraint
Remove update Flutter SDK constraint
* Fix images in readme * Add dynamic resizing demo
* Initial Open Source release
One column per quarter.