Carousel
Slides per view by the carousel's own width, drag and flick with resistance at the ends, arrows, dots, loop and autoplay with a pause button. Off-screen slides are hidden from Tab and screen readers.
The decision inside it
Autoplay always stops
It pauses while the pointer is over it or focus is inside, never autoplays with reduced motion, and always has a pause button: movement people cannot stop fails WCAG.
When to use it
Use Carousel for a row of similar items people browse one or a few at a time: testimonials, screenshots, product cards. Pass the slides as children. For a full-screen photo view use Lightbox.
Installation
How you get it
Paste this into Claude Code, Cursor, Codex or any coding agent. It installs the file and uses it as it is, instead of writing a new one.
Use Layro's Carousel for this.
Install it: npx shadcn@latest add @layro/carousel
(the @layro registry is set up in components.json, with LAYRO_KEY in .env.local)
Import it from @/components/ui/carousel.
Do not rewrite or restyle it. Pass my data through its props
and keep its built-in states.For the full brief with every prop and the mistakes assistants usually make, use Copy prompt above. Free components install through the @layro registry with your CLI token: see the Namespaced tab.
Usage
import { Carousel } from "@/components/ui/carousel";
export function Testimonials({ quotes }: { quotes: { id: string; text: string; who: string }[] }) {
return (
<Carousel aria-label="Testimonials" slidesPerView={{ base: 1, md: 2 }} gap={16} loop>
{quotes.map((q) => (
<figure key={q.id} className="rounded-2xl border p-6">
<blockquote>{q.text}</blockquote>
<figcaption className="mt-3 text-sm text-muted-foreground">{q.who}</figcaption>
</figure>
))}
</Carousel>
);
}API reference
“Copy prompt” above puts a full brief on your clipboard — install command, dependencies, props, and the mistakes an assistant usually makes with this component.
Props
Read from the component’s own TypeScript interface when the site is built, so this table cannot drift from the file you install.
| Prop | Type | Notes |
|---|---|---|
childrenrequired | React.ReactNode | The slides. Each child is one slide. |
index | number | The first visible slide. Controlled. |
defaultIndex | number | The starting slide when uncontrolled. Default 0. |
onIndexChange | (index: number) => void | Called with the new first visible slide. |
slidesPerView | number | { base: number; md?: number; lg?: number } | Slides visible at once, or by the carousel's width: base, md (560px+), lg (840px+). Default 1. |
gap | number | Space between slides in pixels. Default 16. |
loop | boolean | After the last slide, go back to the first. Default false. |
autoplay | number | false | Milliseconds between slides, or false. Default false. |
showArrows | boolean | Previous and next buttons. Default true. |
showDots | boolean | A dot per position. Default true. |
orientation | "horizontal" | "vertical" | Vertical needs a height on the carousel (className). Default horizontal. |
Dependencies
npm packages
clsxframer-motionlucide-reacttailwind-mergeLayro foundations, installed alongside it
layro-themeStates
All of them are drawn by the component. None is left for you to design.
- One at a time
- Several
- Dragging
- Autoplay
- Paused
Accessibility
- Keyboard reachable throughout, in visual order
- Focus trapped in overlays, Escape closes them
- Focus returns to whatever opened it
- Live regions announce what changed, not that something did
- Honours prefers-reduced-motion
Responsive behavior
- Sizes to its container, not the viewport
- Usable from 320px up
- Pointer-based interaction, so trackpad and touch both work
- No hover-only affordances
Lifetime access
Every component, and everything we ship next.
- All 232 components, source included
- Every template, and everything released after you buy
- shadcn CLI or download — React 18/19, Tailwind v4
- One payment. No subscription.
More in Data & feedbackAll Data & feedback components
Swipe to Delete
A list row that slides aside to show its actions; swipe all the way to run the main one.
Infinite Scroll
A list that loads the next page as the reader nears its end, with loading, end and error states.
Stacked Cards
Notifications or tips piled one behind another that fan out into a list on hover or focus.
Image Compare
Two pictures one over the other with a handle to wipe between them: before and after.
Data Table
TanStack table with sorting, search, row selection, bulk actions, column toggle and pagination.
Charts
Area, bar and donut charts, KPI cards and sparklines, each with a data table for screen readers.