vibecodng.com

Free MCP betaIndex and tools live

Measured entry

uilayouts-image-mousetrail-small

cursor-effectspatialmotion on file

A client-side React cursor effect that cycles image elements into a trail as the pointer or touch position moves across a section. It ships as a shadcn registry component and relies on React, Tailwind utility and data-state classes, an aliased cn helper, and consumer-supplied image URLs.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of uilayouts-image-mousetrail-small at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-image-mousetrail-small at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of uilayouts-image-mousetrail-small 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-small
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 32.02s
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 usable, compact visual flourish for controlled hero sections, with clean verified mounting inside its expected environment. It needs a shadcn-style setup and still deserves cleanup for narrow layouts, motion preferences, generic alt text, and activation logging before production use.

Use it if

  • You want a decorative image trail for a desktop-led portfolio, campaign hero, or editorial landing section.
  • Your app already uses the shadcn project conventions, Tailwind utilities, and the aliased cn helper.
  • You can supply and optimize the image set and test the interaction against your actual page layout.

Skip it if

  • Your experience is mobile-first, since the verified narrow viewport overflows and the effect is primarily pointer-led.
  • You need reduced-motion handling, keyboard interaction, or meaningful image descriptions without modifying the source.
  • You want a quiet production component, since the source logs during activation and uses generic image alt text.
  • Your project does not use Tailwind or path aliases and you do not want to adapt the styling and utility import.

Install

Installation record for uilayouts-image-mousetrail-small
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 a client-capable React environment, configure Tailwind with the utility and data-state variants used by the component, create or replace the aliased cn class-merging helper, and ensure the alias resolves. Also remove the activation log and add your own responsive and reduced-motion treatment.

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.

Author repository

github.com/ui-layouts/uilayouts
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.