Skip to content
VenusUI
Get started

Spirit Level

A spirit level you tilt by dragging; the bubble drifts and the vial turns green when it's level.

Preview

Installation

npx shadcn@latest add @venusui/spirit-level

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/spirit-level.tsx

Usage

The code behind the preview above.

spirit-level-demo.tsx

import { SpiritLevel } from "@/components/ui/spirit-level"

export default function SpiritLevelDemo() {
  return <SpiritLevel />
}

API reference

PropTypeDefaultDescription
defaultAnglenumber4Starting tilt in degrees.
rangenumber12Largest tilt either way.
onAngleChange(angle: number) => void—Called as the tilt changes.

All <div> props.

Requirements

  • React 19 and Tailwind CSS v4.

Customization

  • Use it as a playful alignment control, or feed it real device orientation.

Accessibility

  • It's a slider: the arrow keys tilt it and Home levels it; it announces “Level” when flat.

Troubleshooting

Something looks different from the preview.
Components use your project’s theme tokens, so surrounding colours and radius follow your styles.
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 café dial for choosing a drink, with a cup that shows what goes into it.

Loading preview

A wall plate of rocker switches that light a row of pendant bulbs.

Loading preview

A graphic equalizer panel with faders, LED columns, a response curve and presets.