Measured entry

motion-primitives-cursor

cursor-effectdark-futuristicmotion on file

A client-side React cursor replacement distributed as a shadcn registry component. It follows pointer movement with Motion values, can hide the system cursor globally or only over its parent, and accepts custom animation variants. It depends on Motion plus a cn utility backed by clsx and tailwind-merge.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of motion-primitives-cursor at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of motion-primitives-cursor at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of motion-primitives-cursor 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 motion-primitives-cursor
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal72.3 KB (137.8 KB build, 65.5 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

A flexible, working cursor primitive for portfolios and immersive demos, with clean mounting and no provider requirement. Use it selectively: the global mode changes the body cursor, and the parent hover listener cleanup should be corrected for long-lived dynamic views.

Use it if

  • You want a branded pointer treatment for a focused interactive demo or showcase.
  • You need either a page-wide cursor replacement or one scoped to a parent region.
  • Your React interface already uses Motion and Tailwind-style utility classes.

Skip it if

  • Your product must preserve familiar native cursor feedback across controls.
  • You want to avoid adding Motion for a small decorative interaction.
  • Your interface is primarily touch-driven, where a custom pointer adds little value.
  • You need strict cleanup of parent hover listeners without revising the source.

Install

Installation record for motion-primitives-cursor
Declared dependenciesmotion, clsx, tailwind-merge
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

In a non-shadcn project, add Motion, clsx, and tailwind-merge, provide a compatible cn helper, replace the path alias if needed, and ensure the utility classes used by the component are available in your styling setup. Keep it client-side.

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.

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.