# Carousel

> Single-item carousel layout with slide transitions and gesture support.

Source: https://gallerykit.n.yatsyk.com/docs/carousel

# @gallerykit/carousel

**@gallerykit/carousel** registers a `carousel` layout with the GalleryKit core registry and exposes a `<Carousel>` component plus `useGalleryCarousel` hook for fully custom render scenarios.

The carousel supports enter/exit/hover animations and video items.

* **Stability:** experimental
* **Peer dependencies:** `react`, `react-dom`, `framer-motion`
* **Dependencies:** `@gallerykit/core`

## Install

```bash
pnpm add @gallerykit/carousel
```

## Quick example

```tsx
import { Carousel } from "@gallerykit/carousel";

const photos = [
  { id: "1", src: "/a.jpg", alt: "A" },
  { id: "2", src: "/b.jpg", alt: "B" }
];

export default function Hero() {
  return <Carousel items={photos} effect="slide" />;
}
```

See [Getting Started](./getting-started.mdx) for the full walkthrough and [API](./api.mdx) for the public exports.