Arc Carousel
A drag, wheel, and keyboard driven fan of media that rides a circular arc. Tiles stay tangent to the arc, wrap infinitely, and settle with inertia plus a soft critically damped spring.
Installation#
pnpm dlx shadcn@latest add @davinciui/arc-carouselUsage#
API Reference#
| Prop | Type | Default |
|---|---|---|
itemsMedia tiles riding the arc. Each item has src, optional type ('image' | 'video'), and alt. Fewer than 10 items are duplicated internally for a seamless loop. | ArcCarouselItem[] | — |
eyebrowSmall uppercase label above the heading. | string | "OUR WORK" |
headingTwo-line display heading nested inside the arc. | string | "The most complete view of the work" |
descriptionSupporting copy below the heading. | string | A living archive... |
childrenOverrides the default eyebrow/heading/description block with your own content. | React.ReactNode | — |
tileSizeSquare tile edge in pixels. Auto uses 17.9% of the container width, clamped to 120–340px (42% on mobile). | number | "auto" | "auto" |
radiusArc radius in pixels. Auto uses 0.587 × container width (0.9 × on mobile). | number | "auto" | "auto" |
stepAngleAngular distance between neighboring tiles in degrees. Mobile defaults to 20. | number | 16 |
frictionPer-16ms velocity decay applied during release inertia. Higher values glide longer. | number | 0.94 |
snapSettles to the nearest tile with a soft spring after the velocity decays. | boolean | true |
autoPlayAdds a slow idle drift when the carousel is not being dragged. Disabled under reduced motion. | boolean | false |
onActiveChangeFires whenever the tile nearest the top of the arc changes. | (index: number) => void | — |
classNameAdditional classes for the section container. | string | — |
Accessibility#
The section is a focusable region labelled by the heading with aria-roledescription='carousel'; Left and Right arrows move tiles and a polite live region announces position. Tiles sit in an aria-hidden container, so image alt text is not exposed to screen readers.
Motion#
Drag release decays by friction, then snap settles on a critically damped spring; autoPlay adds a slow drift and arrow or wheel input eases over 240ms. A matchMedia listener disables drift and shortens jumps under reduced motion.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

