Skip to main content
Clever Ops

Vault Dials

Concentric instrument dials rotate and lock as loading advances, each quarter seats a ring with a spring snap until the keyway aligns at 100. React and Tailwind spectacle preloader.

Preview & code

Loading Vault Dials preview

Installation

pnpm dlx shadcn@latest add @cleverui/loader-vault-dials

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx
import { LoaderVaultDials } from '@/components/ui/loader-vault-dials'
Exampletsx
'use client'

import { useEffect, useState } from 'react'
import { useReducedMotion } from 'motion/react'
import { LoaderVaultDials } from '@/components/ui/loader-vault-dials'

export default function LoaderVaultDialsDemo() {
  const reduced = useReducedMotion()
  const [progress, setProgress] = useState(6)

  useEffect(() => {
    if (reduced) {
      setProgress(62)
      return
    }
    const start = performance.now()
    let raf = 0
    const tick = (now: number) => {
      const t = Math.min(1, (now - start) / 8500)
      const eased = 1 - Math.pow(1 - t, 2.1)
      setProgress(6 + eased * 94)
      if (t < 1) raf = requestAnimationFrame(tick)
    }
    raf = requestAnimationFrame(tick)
    return () => cancelAnimationFrame(raf)
  }, [reduced])

  return (
    <div className="mx-auto flex w-full max-w-5xl flex-col gap-10 px-4 py-10 sm:px-6">
      <div className="overflow-hidden rounded-2xl border border-border/60">
        <LoaderVaultDials
          progress={progress}
          rings={4}
          label="Sealing vault"
        />
      </div>
      <div className="overflow-hidden rounded-2xl border border-border/60">
        <LoaderVaultDials rings={4} label="Hunting alignment" speed={1} />
      </div>
    </div>
  )
}

API reference

LoaderVaultDials accepts the following props.

PropTypeDefaultDescription
progressnumberdeterminate 0-100; ring i seats at the (i+1)*25 milestone. Omit for indeterminate coprime hunt
ringsnumber4concentric rings, clamped 3-5; determinate mode divides 100 evenly between them
labelstring'Loading'mono micro-label under the percent; seeds the aria announcement
speednumber1indeterminate hunt rate multiplier

…plus everything from React.HTMLAttributes<HTMLDivElement>: className, event handlers, aria attributes and the rest pass straight through.

Frequently asked questions

How do I install the Vault Dials component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/loader-vault-dials`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Vault Dials require?

Vault Dials uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Vault Dials to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Want this built for you?

CleverUI is built by the Clever Ops web team. If you'd rather ship a hand-coded, fast, custom website than assemble one, we build them for Australian businesses every week.

Explore web development services