Docs/Infinite Image Field

Infinite Image Field

An endless, cursor-driven photo canvas. Images tile infinitely in all directions — move your cursor to pan the field, and it glides fluidly toward where you point.

Installation

$pnpm dlx shadcn@latest add @componentry/infinite-image-field

Usage

API Reference

PropTypeDefault
imagesArray of image URLs tiled across the infinite canvas. Images repeat in a deterministic pattern so the same grid cell always shows the same photo.
string[]12 built-in sci-fi Unsplash images
imageWidthWidth of each image tile in CSS pixels.
number300
imageHeightHeight of each image tile in CSS pixels.
number200
gapSpacing between adjacent tiles in CSS pixels.
number28
maxSpeedMaximum pan speed when the cursor is at the edge of the canvas (pixels per frame).
number5
smoothingLerp factor controlling how quickly velocity catches up to the cursor direction. Lower values feel heavier and dreamy; higher values feel snappy.
number0.07
borderRadiusCorner radius applied to each image tile.
number0
classNameAdditional classes applied to the root container.
string—

Click on the icon in the top right of the example preview to view the source code for specific variants.

Keep in mind

This component is inspired by various open-source projects and patterns. Please verify licenses and implementation details before using in production.

Have any questions?
Contact on@harshjdhv
import { InfiniteImageField } from "@/components/ui/infinite-image-field"

<InfiniteImageField className="w-full h-screen" />