Skip to content

NewMCP server for your coding agent. Set it up ›

Nexus UI
Get Pro

Circular Carousel, animated React component

Cards hung round the rim of a wheel, with the active card at the top and its neighbours tipping away down each side. Drag or fling the wheel and it coasts to the nearest card while the cards swing on their pins and settle, and the counter in the middle rolls to the new number; arrows, dots and keys work too.

  • Free
  • Cards
  • Spring

Ticks each time a new card comes to the top from your drag, keys, buttons, dots or card tap. Sound is off on this site until you switch it on.

Like Circular Carousel? 256 more are in Pro.

Pro unlocks all 256 Pro components, every template and block, and everything we release next. Circular Carousel stays free.

Play with it

Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.

01/ 06Shape the brief. Goals, audience and the one thing to get right.
Drag the wheel, or use the arrow keys.

Props

PropTypeDefaultWhat it does
items6 sample stepsEach { id, title, description, tag?, accent? }.
activeIndex—Controlled active card; the wheel turns the short way round to it.
onActiveChange—Called with the new active index.
autoplayfalseSteps to the next card every autoPlayInterval ms until someone touches it.
autoPlayInterval2600Time between autoplay steps, in ms.
hint"Drag the wheel, or use the arrow keys."Caption under the controls. An empty string hides it.
className—Extra classes for the root.
enableSoundtruePlays interface sounds on interaction. They follow the sound switch (setSoundsEnabled, on by default) and stay silent on hover. Autoplay makes the same sounds once the visitor has used the page. Pass false to silence this component.

Add it to your project

  1. 1

    Set up your project once

    You need a Next.js project with Tailwind CSS and the @/ import alias. In its root folder, run this once. It creates components.json and the cn() helper in src/lib/utils.ts:

    npx shadcn@latest init -d

    Starting from nothing? The Quick Start walks through the whole thing.

  2. 2

    Connect the registry

    Run this once per project. It writes the Nexus UI entry into components.json for you:

    npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"

    Type it exactly as shown. {name} is filled in by the CLI with the component you ask for, so you never replace it.

  1. 3

    Add the component

    Run this from your project root. It adds the component, the helpers it imports and its npm packages.

    npx shadcn@latest add @nexus-labs/circular-carousel
  2. 4

    Check what was added

    With a project made as in the Quick Start (a src/ folder), these files land in it:

    components/
    circular-carousel/
    circular-carousel.tsx
    index.ts
  3. 5

    Copying by hand? Skip the registry

    Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that cn() exists. Install the packages:

    npm install framer-motion

    Then show the source and create each file at the path it gives:

  4. 6

    Use it in a page

    Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:

    // src/app/page.tsx
    import { CircularCarousel } from "@/components/circular-carousel";
    
    export default function Page() {
      return (
        <main>
          <CircularCarousel />
        </main>
      );
    }

Like Circular Carousel? 256 more are in Pro.

Pro unlocks all 256 Pro components, every template and block, and everything we release next. Circular Carousel stays free.

About Circular Carousel

The Circular Carousel arranges content cards in an orbital ring around a central focal point. The active card stays centered and at full scale while adjacent cards arc around it at reduced scale. Framer Motion spring animations handle the orbital transitions when the active card changes. Navigation controls and auto-rotation are both supported. Compatible with any card content including images, text blocks, and interactive React elements.

Good for

  • Product feature carousels
  • Testimonial and review rotators
  • Team member profile carousels
  • Portfolio and project showcases

Circular Carousel questions

What data does the carousel need?

Pass `items` as an array of `{ id, title, description, tag? }`. Up to five cards are shown on the arc, and the center shows the active number out of the total.

How does autoplay work?

`autoPlay` is on by default and advances every `autoPlayInterval` ms (default 4000). It pauses while the carousel is hovered or focused.

Can I control the active slide from outside?

Yes. Pass `activeIndex` and handle `onActiveChange` to make it a controlled component.

Is it keyboard accessible?

The carousel is focusable and responds to the Left and Right arrow keys. The previous and next buttons and the dot indicators have aria-labels.

Does it make sound, and how do I turn it off?

Ticks each time a new card comes to the top from your drag, keys, buttons, dots or card tap. Sounds are synthesised with the Web Audio API, so there are no audio files, and they only play after a click or key press. Pass `enableSound={false}` to silence this component, or call `setSoundsEnabled(false)` from `@/lib/ui-sounds` to switch every sound off at once. The CLI installs `@/lib/ui-sounds` with the component.