Loader

Seventeen loading animations behind one Loader component: comet, helix, metaballs and Newton's cradle next to classic spinners, bouncing dots and bars, a dot matrix, dithered noise, morphing shapes, a text scramble, a percent counter and five ASCII spinners. One size prop, currentColor, role="status".

Preview

Loader preview width

Install

Add it with the shadcn CLI, or copy the source manually.

$ bunx --bun shadcn add @karaui/loader
@karaui not found? Add it to components.json
{
  "registries": {
    "@karaui": "https://karaui.kamisama-v0.my.id/r/{name}.json"
  }
}

@karaui is in shadcn's public registry directory, so the latest CLI needs no setup. On an older CLI, merge this into the existing file once and every @karaui/… install resolves.

API Reference

variant?
"dots" | "metaballs" | "spinner" | "bars" | "dot-matrix" | "dither" | "ascii" | "ascii-line" | "ascii-braille" | "ascii-blocks" | "ascii-bounce" | "morph" | "comet" | "scramble" | "newton" | "helix" | "percent"

Which animation to render.

spinner
size?
number

Base square size in px. Everything scales from this.

32
speed?
number

Seconds per animation cycle.

1
label?
string

Accessible label announced to screen readers.

Loading
className?
string
—

Updated