build69
build69  /  Components  /  Media & Files  /  ImageList

ImageList

v1.0.1Updated 20 Jul 2026

Uniform image grid with title / subtitle overlays and configurable aspect ratios. For photo galleries and product catalogues.

Preview

Live · 9 stories
Photo GalleryOpen ↗
Why this is recommendedimage-listgallerygridaspect+3

ImageList in a gallery layout — photo.

Recommended for+14
  • Photo galleries
  • Product catalogues
  • Wallpaper / asset pickers
Tags+6
image-listgallerygridaspectmuimediaphoto
Features+4
  • Uniform aspect ratio (square / 4:3 / 16:9 / portrait)
  • Title + subtitle overlay
  • Responsive column count
  • Hover affordance
Not recommended for−2
  • Mixed-height items (use Masonry)
  • List rows with text (use List)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "ImageList" })

Usage

import { ImageList } from '@/components/media/image-list';

<ImageList items={photos} columns={4} aspect="square" />

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
items

Image items

ImageListItem[]yes
columns

Column count

number
aspect

Aspect ratio

'square' | '4-3' | '16-9' | 'portrait'

Related