Measured entry

magicui-pointer

cursor-effectspatialmotion on file

A client-side React cursor replacement distributed as a shadcn registry component. It listens to pointer movement on its parent, hides that parent’s native cursor, and animates a fixed overlay with Motion. It also expects Tailwind utility classes and the usual shadcn `cn` helper backed by clsx and tailwind-merge.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of magicui-pointer at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-pointer at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-pointer at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for magicui-pointer
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal71.8 KB (137.3 KB build, 65.5 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

✗ Build failed in 4m 24s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/pointer.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

A focused, reusable effect that behaves cleanly in its intended stack and supports custom pointer content. It needs a shadcn-style setup before it will build in a bare React project, so it is a better fit for existing registry-based apps than dependency-conscious sites.

Use it if

  • You want a custom cursor confined to a specific interactive panel or showcase.
  • Your React app already uses Tailwind, Motion, and a shadcn-style utility layout.
  • You need to swap the default pointer graphic for custom React content.

Skip it if

  • Your experience is primarily touch-driven, where a hover cursor adds little value.
  • Preserving the familiar native cursor is important for usability in the target interaction.
  • You are avoiding Motion for a small decorative effect because dependency weight matters.
  • The parent area contains precise controls where hiding the native cursor could reduce clarity.

Install

Installation record for magicui-pointer
Declared dependenciesmotion, clsx, tailwind-merge
Missing on installnone
Bare installfails once the shadcn-style helpers are removed, so it needs that setup
Providerno provider required in the harness

In a non-shadcn project, add Motion, clsx, tailwind-merge, and Tailwind styling. Create a compatible `cn` utility and configure the `@` source alias, or replace the aliased utility import with a local relative path.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

License
MIT
Record published
2026-08-17

Alternatives

Other published entries for the cursor-effect pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.