quick_carousel_grid 1.0.0

A Flutter widget that displays image thumbnails in a compact grid with cached network images, an infinite carousel strip, and a full-screen zoomable photo viewer.

Quick Carousel Grid

A Flutter package that displays image thumbnails in a compact grid with cached network images, an infinite carousel strip, and a full-screen zoomable photo viewer.

Features

• Compact image grid — shows up to 4 thumbnails with a +N overflow badge.
• Cached network images — powered by cached_network_image.
• Full-screen viewer — pinch-to-zoom via photo_view.
• Infinite carousel strip — swipeable thumbnail strip in the viewer.
• Customisable — grid dimensions, spacing, carousel behaviour, and more.

Getting Started

Add quick_carousel_grid to your pubspec.yaml:

dependencies:
  quick_carousel_grid: ^1.0.0

Then import it:

import 'package:quick_carousel_grid/quick_carousel_grid.dart';

Usage

CarouselGrid(
  height: 285,
  width: 400,
  listUrlImages: [
    'https://picsum.photos/id/1015/600/400',
    'https://picsum.photos/id/1016/600/400',
    'https://picsum.photos/id/1018/600/400',
    'https://picsum.photos/id/1020/600/400',
    'https://picsum.photos/id/1021/600/400',
  ],
  titleGallery: 'My Gallery',
  iconBack: const Icon(Icons.arrow_back, color: Colors.white),
)

Parameters

Parameter	Type	Default	Description
width	double	required	Total width the grid occupies.
height	double	285	Total height the grid occupies.
listUrlImages	List<String>?	null	Image URLs to display.
iconBack	Icon	required	Back-button icon in the full-screen viewer.
gridCount	int	2	Number of columns.
gridMainExtent	double	130.0	Main-axis extent (row height) for each cell.
gridMainSpacing	double	5.0	Vertical spacing between cells.
gridCrossSpacing	double	5.0	Horizontal spacing between cells.
titleGallery	String?	null	Title shown in the viewer app bar.
fitCarouselList	BoxFit	BoxFit.cover	BoxFit for carousel thumbnails.
loopCarouselList	bool	true	Whether the carousel strip loops.
activeCarouselList	bool	true	Whether to show the bottom carousel strip.
downloadButton	ValueChanged<String>?	null	Called with the image URL on download tap.

Example

See the example directory for a complete sample app.

License

MIT — see LICENSE for details.