Measured entry

fancy-text-cursor-proximity

cursor-effectspatialmotion on file

A client-side React text effect that splits plain text into individual letters and adjusts selected CSS properties as the pointer approaches each glyph. It ships as a shadcn registry component and depends on Motion, a companion mouse-position hook, the shadcn cn utility, path aliases, and Tailwind utility classes.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of fancy-text-cursor-proximity at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of fancy-text-cursor-proximity at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of fancy-text-cursor-proximity 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 fancy-text-cursor-proximity
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal67.6 KB (133.0 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 42.94s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/fancy/text/text-cursor-proximity.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

A flexible, focused effect for short display copy, with clean verified mounting and no reported accessibility violations. Its per-letter frame loop and dependency cost make it a selective accent, not a default text primitive. It needs a shadcn-style setup before it will build and mount.

Use it if

  • You want a pointer-reactive display heading or short callout.
  • You need configurable style interpolation and falloff behavior rather than a fixed preset.
  • Your project already uses shadcn conventions and Motion.

Skip it if

  • Your text must accept rich nested React content because the component reduces children to plain text.
  • You need a lightweight effect without a substantial Motion dependency cost.
  • Your layout must work unchanged on narrow screens, where the tested demo overflowed.
  • You want animation to stop when the effect is offscreen or reduced motion is requested.

Install

Installation record for fancy-text-cursor-proximity
Declared dependenciesmotion
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, install Motion, add the companion mouse-position hook and a cn class-merging utility, configure the source path aliases, and provide equivalents for the inline-block and screen-reader-only Tailwind utilities. Keep the file as a client component.

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.