Orbit Spiral Gallery
A compact, autoplaying image gallery that responds to scroll while flowing along a smooth 3D spiral.
Installation#
pnpm dlx shadcn@latest add @davinciui/orbit-spiral-galleryUsage#
Replace the example paths with your own local files or remote image URLs. Every image should include meaningful alternative text.
API Reference#
| Prop | Type | Default |
|---|---|---|
itemsImages arranged along the 3D spiral. | OrbitSpiralSlide[] | — |
radiusMaximum horizontal radius of the spiral in pixels. | number | 235 |
verticalGapVertical pitch between neighboring images. | number | 64 |
cardWidthMaximum width of each image plane in pixels. | number | 255 |
cardAspectRatioWidth divided by height for every image plane. | number | 1.5 |
autoRotateAutomatically advances the spiral while it is idle. | boolean | true |
autoSpeedAutomatic movement measured in slides per second. | number | 0.13 |
scrollSensitivityAmount of spiral movement produced by scrolling. | number | 0.0024 |
smoothingInterpolation strength used for smooth movement. | number | 0.065 |
blurStrengthMaximum blur applied as images move away from focus. | number | 1.65 |
bendAmount each segmented image plane curves into the spiral. | number | 0.17 |
fovPerspective camera field of view in degrees. | number | 44 |
ariaLabelAccessible name for the gallery region. | string | "Spiral image gallery" |
classNameAdditional classes for the scene. | string | — |
Accessibility#
A region with aria-label wraps the WebGL canvas, and every slide alt is duplicated into an sr-only list. There are no focusable controls or keyboard paging, and auto-rotation cannot be paused from the UI.
Motion#
The spiral advances via autoSpeed, follows wheel and page scroll scaled by scrollSensitivity, and eases toward its target using smoothing. matchMedia reduced motion stops auto-rotation and removes smoothing while scroll movement remains.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

