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.