Measured entry

uilayouts-mousetrail

cursor-effectdark-futuristicmotion on file

A client-side React cursor effect shipped as a shadcn registry component. It cycles native image elements under mouse or touch movement, mutating their position and status in place. It has no declared package dependencies, but its styling assumes Tailwind utilities and it imports the shadcn-style cn helper through the @ alias.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of uilayouts-mousetrail at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-mousetrail at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of uilayouts-mousetrail 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 uilayouts-mousetrail
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal27.4 KB (92.8 KB build, 65.4 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

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

Verdict

A lively effect for nonessential visual atmosphere. It builds and mounts in the prepared harness and adds no declared packages, but it needs a shadcn-style setup to mount as supplied. Adopt it only after addressing narrow-screen containment, image semantics, and source cleanup.

Use it if

  • You want a decorative image trail inside a bounded hero, gallery intro, or campaign panel.
  • Your app already uses Tailwind and can supply the expected cn utility and path alias.
  • You can provide curated image URLs and test the interaction with real mouse and touch input.

Skip it if

  • The effect must fit narrow screens without extra responsive work; the verified demo overflowed at the narrow viewport.
  • Meaningful images need descriptive accessible text; the component generates only generic alt labels.
  • You want a drop-in for plain React or CSS Modules; the source assumes shadcn and Tailwind conventions.
  • You need strict production polish without cleanup; the source suppresses type checking and leaves a console log in the activation path.

Install

Installation record for uilayouts-mousetrail
Declared dependenciesnone declared
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 Tailwind processing, configure the @ path alias, and provide src/lib/utils with a cn class-merging helper. Add an ease-out-expo utility if you want the authored easing, then remove the type-check suppression and debug log. No context provider is required.

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-14

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.