Complete Feature Set

Everything You Need
For Professional Galleries

A comprehensive set of features designed to create stunning, performant, and accessible image galleries.

Grid & Masonry Layouts

Choose between clean grid layouts or Pinterest-style masonry. Responsive columns adapt to any screen size.

  • Grid layout with customizable aspect ratios
  • Masonry layout for varied image sizes
  • Responsive column breakpoints
  • Auto or manual column control
  • +1 more features

Category Filtering

Filter images by categories with smooth animations. Dynamic category detection from your data.

  • Dynamic category detection
  • Smooth filter transitions
  • Multiple category support
  • Active filter highlighting
  • +1 more features

Advanced Modal Lightbox

Full-featured modal with zoom, pan, autoplay, and extensive customization options.

  • Full-screen modal view
  • Zoom and pan functionality
  • Touch gesture support
  • Keyboard navigation
  • +3 more features

Image Transform Controls

Rotate, flip, and zoom images with smooth animations. Perfect for detailed image viewing.

  • 360° rotation controls
  • Horizontal and vertical flip
  • Zoom in/out buttons
  • Pinch-to-zoom on touch
  • +2 more features

Slideshow & Autoplay

Automatic slideshow with customizable speed, progress tracking, and smooth transitions.

  • Play/pause autoplay
  • Adjustable speed (1-5 seconds)
  • Visual progress indicator
  • Smooth transitions
  • +2 more features

Thumbnail Navigation

Horizontal thumbnail strip for quick navigation. Toggle visibility and customize styles.

  • Horizontal thumbnail strip
  • Active thumbnail highlighting
  • Smooth scrolling
  • Toggle visibility
  • +2 more features

Extensive Customization

50+ CSS variables and configuration options for complete theming control.

  • Custom accent colors
  • Corner styles (rounded/flat)
  • Card shadows
  • Image filters
  • +4 more features

Performance Optimized

Lightweight and fast with lazy loading, zero dependencies, and optimized rendering.

  • Zero dependencies
  • Lazy image loading
  • Intersection Observer API
  • Debounced resize handlers
  • +2 more features

Mobile Responsive

Touch-optimized for all devices with gestures, swipe navigation, and responsive breakpoints.

  • Touch gestures
  • Swipe navigation
  • Pinch-to-zoom
  • Responsive breakpoints
  • +2 more features

Accessibility Features

Built with accessibility in mind. Full keyboard navigation and screen reader support.

  • Keyboard navigation
  • ARIA labels
  • Focus management
  • Screen reader support
  • +2 more features

Advanced Features

Additional powerful features including download, share, fullscreen, and more.

  • Single image preview mode
  • Randomize gallery order
  • Download images
  • Share links
  • +3 more features

Developer Friendly

Easy to integrate, well-documented API, TypeScript support, and flexible configuration.

  • Simple initialization
  • Comprehensive API
  • TypeScript definitions
  • Event callbacks
  • +2 more features

Configuration Options

Complete reference of all available configuration options

Layout Options

layout
grid | masonry
columns
auto | number | {mobile, tablet, desktop}
gap
number (px)
itemAspectRatio
string (e.g., "16/9") | null

Visual Theme

cornerStyle
rounded | flat
showCardShadow
boolean
galleryMaxWidth
string | number | null
accentColor
CSS color | null

Gallery UI

showGalleryFilter
boolean
showGalleryCaption
always | hover | hide
imageFilter
none | grayscale | sepia | blur | brightness | contrast | saturate
imageFilterAmount
number (0-100 for grayscale/sepia, 0-200 for others)
imageFilterOnHover
color | filter | none

Modal Settings

enableModal
boolean
modalTheme
dark | light
modalBackdropOpacity
0.0 - 1.0
modalTransition
fade | crossfade | slide
enableCaptions
boolean

Modal Controls

showModalPlayPause
boolean
showModalSpeed
boolean
showModalCount
boolean
showModalThumbnails
boolean
showModalThumbnailsToggle
boolean
showModalFullscreen
boolean
showModalZoomControls
boolean
showModalTransformControls
boolean | null (master toggle for all transform controls)
showModalRotateControls
boolean
showModalFlipControls
boolean
showModalThemeToggle
boolean
showModalDownload
boolean
showModalShare
boolean
showModalAutoplayProgress
boolean

Behavior

randomize
boolean
showSingleImage
boolean
modalAutoplayInterval
number (ms)
modalSwipeThreshold
number (px)
disableModalRightClick
boolean

Thumbnail Settings

modalThumbnailHeight
number (px)
modalThumbnailStyle
crop | natural
50+
CSS Variables
0
Dependencies
100%
Customizable
∞
Possibilities

Ready to Get Started?

Explore the playground to see all features in action, or check out the documentation for detailed guides.

Try PlaygroundView Documentation