Skip to content
VenusUI
Get started

Orbiting Circles

Items placed evenly on a circle that orbit the center, staying upright.

Preview

Installation

npx shadcn@latest add @venusui/orbiting-circles

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/orbiting-circles.tsx

Usage

The code behind the preview above.

orbiting-circles-demo.tsx

import { Cloud, Database, GitBranch, Mail, Shield, Zap } from "lucide-react"

import { OrbitingCircles } from "@/components/ui/orbiting-circles"

const node = "flex size-9 items-center justify-center rounded-full border bg-card"

export default function OrbitingCirclesDemo() {
  return (
    <div className="relative flex size-72 items-center justify-center">
      <span className="z-10 rounded-xl border bg-foreground px-3 py-2 text-sm font-semibold text-background">Core</span>
      <OrbitingCircles radius={64} duration={18}>
        <span className={node}><Database className="size-4" /></span>
        <span className={node}><Shield className="size-4" /></span>
      </OrbitingCircles>
      <OrbitingCircles radius={120} duration={28} reverse>
        <span className={node}><Cloud className="size-4" /></span>
        <span className={node}><GitBranch className="size-4" /></span>
        <span className={node}><Mail className="size-4" /></span>
        <span className={node}><Zap className="size-4" /></span>
      </OrbitingCircles>
    </div>
  )
}

API reference

PropTypeDefaultDescription
childrenReactNode—Items to orbit, e.g. small icons. Required.
radiusnumber120Orbit radius in pixels.
durationnumber24Seconds per orbit.
reversebooleanfalseOrbit counter-clockwise.
pathbooleantrueDraw the dashed orbit line.

Only the props above, plus className.

Requirements

  • Tailwind CSS v4. The CLI adds the orbit keyframes. Works in Server Components.

Customization

  • Stack two or three with different radius and reverse for rings.
  • Put a logo in the center of the positioned parent.

Accessibility

  • Give icon-only items a visually hidden label.
  • With reduced motion items rest on the orbit without moving.

Troubleshooting

Items pile up in the middle.
Check that the orbit keyframes are in your CSS; the parent must be relative with a size.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

A tilted wall of vertically scrolling columns, for screenshots and showcases.

Loading preview

Background Beams

Backgrounds

Curved lines across a section with light traveling along them.

Loading preview

Beam Rain

Backgrounds

Beams of light fall to the floor and burst into sparks when they land.