OPUS/UI

Navigation

Custom Cursor

Dot + lagging ring that swells over links, morphs into a label with data-cursor-text, and squishes on press. Scoped or page-wide; off on touch.

cursorblend-mode2 files · 132 locdeps: clsx, tailwind-merge

Move inside this box — the native cursor is replaced only here.

Hover the links and

Installation

With the shadcn CLI, pointing at this platform’s registry:

npx shadcn@latest add https://opusui.131199999.xyz/r/custom-cursor.json

Or offline, straight from your opus55 checkout (copies every file it needs):

node ../tailwind_component/opus55/scripts/add.mjs custom-cursor

Usage

import { CustomCursor } from "@/components/opus/effects/custom-cursor";

<CustomCursor />  // in your root layout
<div data-cursor-text="View">…</div>

API

PropTypeDefaultDescription
colorstring"#ffffff"Cursor colour.
sizenumber36Ring diameter (px).
easenumber0.18Ring lag.
blend"difference" | "normal" | "exclusion""difference"mix-blend-mode.
hideNativebooleantrueHide the OS cursor in scope.
scopestring—Element id to restrict to.

Command palette