cursor-orb
ESM 25.5 kB
Gzip 6.6 kB
Dependencies None
Docs

Smooth following, automatic hover feedback, velocity stretch, click ripples, magnetic targets, contextual labels, and hidden zones in one small browser utility.

One orb that understands the element beneath it.

Automatic

Hover scale

Buttons, links, controls, roles, and focusable elements are recognized.

Contextual

Cursor label

The label comes directly from the target's data attribute.

orb hidden
inside
Priority state

Hidden zone

Hide the orb over media, embeds, or any marked subtree.

Velocity turns a small circle into directional motion.

Move quickly Sweep the pointer from side to side

Every press can pulse the orb and release a ripple.

Filled target

Pulse + ripple

Click directly on the circular action to see both effects.

Outlined target

Exact origin

The expanding ring starts at the real pointer coordinates.

Compact target

Native interaction

Pointer feedback never captures or blocks the original click.

The cursor leans toward the center of interactive targets.

Compact

Small target

Subtle attraction helps the orb settle over precise controls.

Balanced

Medium target

The same strength adapts naturally to a different rectangle.

Expanded

Large target

Geometry stays aligned through scrolling and layout changes.

Let the pointer explain what will happen next.

Save

Button intent

Draggable media
Drag

Gesture hint

Tune the global orb, then revisit every example above.

Appearance size + color
Motion speed + stretch
Interaction hover + click
Context magnetic + label
import CursorOrb from "cursor-orb";

const orb = new CursorOrb();