Skip to main content
Clever Ops

Glyph Cycle

A single mono glyph slot rolls through a deterministic character set behind a mask, and when the done prop flips, it rolls once more onto a primary check and stops. A one-character machine.

Preview & code

Loading Glyph Cycle preview

Installation

pnpm dlx shadcn@latest add @cleverui/loader-glyph-cycle

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

Usage

tsx
import { LoaderGlyphCycle } from '@/components/ui/loader-glyph-cycle'
Exampletsx
'use client'

import { useEffect, useState } from 'react'
import { LoaderGlyphCycle } from '@/components/ui/loader-glyph-cycle'

export default function LoaderGlyphCycleDemo() {
  const [done, setDone] = useState(false)

  useEffect(() => {
    const t = setTimeout(() => setDone(true), 4200)
    return () => clearTimeout(t)
  }, [])

  return (
    <div className="mx-auto flex min-h-[360px] max-w-md flex-col items-center justify-center gap-10 px-6 py-20">
      <div className="flex flex-col items-center gap-4 text-center">
        <p className="font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground">
          Export queue
        </p>
        <LoaderGlyphCycle done={done} label="Compiling ledger export" />
        <p className="max-w-xs text-sm leading-relaxed text-muted-foreground">
          {done
            ? 'Northwind Q2 journal pack is ready, 1,284 rows, three ledgers.'
            : 'Compiling journal lines for Northwind Q2 close…'}
        </p>
      </div>
    </div>
  )
}

API reference

LoaderGlyphCycle accepts the following props.

PropTypeDefaultDescription
glyphsstring'·+×◇'cycle set, one character per step, fixed order
donebooleanfalsewhen true, settle onto a check and stop
labelstring'Loading'sr-only status text; announces Done on settle

…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 Glyph Cycle 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-glyph-cycle`. 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 Glyph Cycle require?

Glyph Cycle 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 Glyph Cycle 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