Measured entry

uilayouts-image-mousetrail-default

cursor-effectspatialmotion on file

A client-side React and TypeScript cursor effect that cycles supplied image URLs beneath pointer or touch movement. It ships as a shadcn registry component, has no declared package dependencies, and relies on Tailwind utility classes plus the conventional aliased cn helper.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of uilayouts-image-mousetrail-default at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-image-mousetrail-default at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of uilayouts-image-mousetrail-default 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-image-mousetrail-default
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal27.5 KB (92.9 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 34.56s
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 focused, configurable trail effect that builds and mounts cleanly in its intended environment. It needs a shadcn-style setup out of the box, and the narrow-screen overflow plus small source-quality issues make it better as a starting point than an untouched production drop-in.

Use it if

  • You want an image trail inside a bounded hero, portfolio panel, or campaign section.
  • Your project already uses Tailwind and the standard shadcn utility alias.
  • You can supply and optimize the image set yourself.

Skip it if

  • Your layout must avoid horizontal overflow on narrow screens without component-level adjustments.
  • You need a keyboard-driven equivalent to the pointer and touch interaction.
  • You want a dependency-free drop-in for a plain React project with no Tailwind or path aliases.
  • You need strict production polish without removing the component's debug logging and tightening its image rendering details.

Install

Installation record for uilayouts-image-mousetrail-default
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 with support for the component's data-state utilities, provide a cn class-merging helper at the expected aliased path or replace that import, and run it in a client-side React environment. Add your own responsive sizing and overflow adjustments for narrow layouts.

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.