Skip to content
VenusUI
Get started

Wireframe Orb

A WebGL wireframe sphere with glowing vertices that turns and leans toward the pointer.

Preview

Installation

npx shadcn@latest add @venusui/wireframe-orb

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.

  • @/hooks/use-scene-state.tsfrom use-scene-state
  • @/components/ui/wireframe-orb.tsx

Usage

The code behind the preview above.

wireframe-orb-demo.tsx

import { WireframeOrb } from "@/components/ui/wireframe-orb"

export default function WireframeOrbDemo() {
  return <WireframeOrb className="max-w-xs" />
}

API reference

PropTypeDefaultDescription
detailnumber2Geometry detail: 0 is a plain icosahedron, 3 is nearly round.
follownumber0.5How strongly it leans toward the pointer.
labelstring"Rotating wireframe sphere"Accessible description.
classNamestring—Classes for the wrapper; set the color with a text class.

Only the props above.

Requirements

  • three and @react-three/fiber. The CLI installs both, plus @types/three as a dev dependency.
  • A browser with WebGL.

Customization

  • detail={1} gives a crisp geometric look; 3 looks like a globe.
  • Set follow={0} to turn off the pointer lean.

Accessibility

  • Exposed as a labelled image.
  • Pauses off screen and with reduced motion.

Troubleshooting

It looks jagged.
The canvas renders at up to 2× device pixel ratio; make sure the wrapper isn’t scaled with CSS transforms.
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

Cards arranged in a ring that turns in 3D, with buttons, arrow keys and announcements.

Loading preview

A CSS-only cube with six content faces that tumbles slowly and pauses on hover.

Loading preview

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