dash_responsive_grid 0.0.1

Lightweight, dependency-free responsive grid widget for Flutter. Auto column count by screen width, with loading/empty/error states.

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.