staggered_flow_grid 1.0.1 copy "staggered_flow_grid: ^1.0.1" to clipboard
staggered_flow_grid: ^1.0.1 copied to clipboard

A high-performance, zero-dependency Flutter widget that renders children in a staggered waterfall grid layout using a custom shortest-column RenderObject.

Changelog #

All notable changes to staggered_flow_grid will be documented in this file.

The format follows Keep a Changelog. This project adheres to Semantic Versioning.


1.0.1 — 2026-04-13 #

Fixed #

  • Reduced pubspec.yaml description length to strictly under 180 characters, granting the final 10 points to achieve a perfect 160/160 pub.flutter-io.cn score.

1.0.0 — 2026-04-13 #

Initial Release #

  • Core Framework:

    • StaggeredFlowGrid widget — zero-dependency staggered (waterfall) grid powered by a custom RenderBox.
    • RenderStaggeredFlowGrid — public render object for advanced composition and layout.
    • StaggeredGridParentData — optimized parent-data class for direct offset positioning.
    • Shortest-column waterfall algorithm with O(n) layout pass per frame.
  • Features:

    • Full compatibility with SingleChildScrollView scaling and SliverToBoxAdapter contexts.
    • Built-in parameter constraints for crossAxisCount, mainAxisSpacing, and crossAxisSpacing.
    • Native RTL (Right-to-Left) directional support — automatically reads from the ambient Directionality widget and correctly mirrors the column flow positioning.
    • Direct computeDryLayout optimization for deep intrinsic sizing (e.g., inside Column or IntrinsicHeight).
  • Quality Assurance:

    • Validated including spacing clamps, RTL assertions, negative bounds, and zero-child behaviors.
    • Uses strictly compliant modern static analysis via flutter_lints: ^5.0.0.
    • Zero performance warnings, zero static analyzer violations, and full cross-platform compatibility metrics enabled.
  • Showcase Example:

    • Comprehensive modern production-level Example app built on Material 3 with seamless dark/light theme switching.
    • Embedded examples featuring dynamic network images mimicking Pinterest cards (CachedNetworkImage with custom ShimmerBox loading states).
    • High-performance, mixed-height article and stats cards, isolating repaint layers.
    • Built-in Interactive Playground to manually adjust column spacing, padding, and constraints real-time.
0
likes
160
points
12
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

A high-performance, zero-dependency Flutter widget that renders children in a staggered waterfall grid layout using a custom shortest-column RenderObject.

Repository (GitHub)
View/report issues

Topics

#grid #layout #staggered-grid #waterfall #masonry

License

MIT (license)

Dependencies

flutter

More

Packages that depend on staggered_flow_grid