dash_responsive_grid

A Flutter grid that picks its own column count from screen width — no LayoutBuilder, no breakpoint math. Zero dependencies.

Install

dependencies:
  dash_responsive_grid: <latest_version>

Usage

import 'package:dash_responsive_grid/dash_responsive_grid.dart';

ResponsiveGridView.builder(
  itemCount: items.length,
  minColumnWidth: 160,        // columns auto-fit to width
  itemBuilder: (context, index) => MyCard(items[index]),
)

Prefer fixed breakpoints instead? Pass breakpoints: GridBreakpoints.defaultBreakpoints (mobile: 2 cols, tablet: 4, desktop: 6, web: 8) or your own GridBreakpoints(...). Neither given → defaults kick in automatically.

Loading / empty / error

ResponsiveGridView.builder(
  itemCount: items.length,
  minColumnWidth: 160,
  isLoading: isLoading,
  hasError: hasError,
  itemBuilder: (context, index) => MyCard(items[index]),
)

Built-in spinner / "No items" / error message — override with loadingBuilder, emptyBuilder, errorBuilder.

Horizontal scroll

SizedBox(
  height: 260,
  child: ResponsiveGridView.builder(
    itemCount: items.length,
    scrollDirection: Axis.horizontal,
    minRows: 2,
    maxRows: 2,
    itemBuilder: (context, index) => MyCard(items[index]),
  ),
)

Key parameters

Parameter	What it does
`minColumnWidth` / `breakpoints`	pick a column-count strategy
`minColumns` / `maxColumns`	clamp column count
`minRows` / `maxRows`	same, but for horizontal scroll
`itemSpacing` / `rowSpacing`	gaps between tiles
`childAspectRatio`	tile width/height ratio
`isLoading` / `hasError` / `loadingBuilder` / `emptyBuilder` / `errorBuilder`	state handling
`scrollDirection`	`Axis.vertical` (default) or `Axis.horizontal`

Full list in the dartdoc on ResponsiveGridView. Runnable demo: example/.

Bugs & Credits

Report bugs and ask questions on GitHub Issues. Maintained by Dashstack Infotech, Surat.