Measured entry

ruixen-particle-text-dots

cursor-effectunclassifiedmotion on file

A client-side React canvas component that samples a text glyph into animated dots, then pushes and settles them in response to pointer movement. It ships as a shadcn registry TSX file and relies on browser canvas APIs, ResizeObserver, animation frames, Tailwind utilities, and a local cn helper backed by clsx and tailwind-merge.

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

What the harness recorded

BARE BUILD

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

Verdict

A focused decorative effect that builds, mounts, and adapts cleanly in the prepared harness. It needs a shadcn-style setup out of the box, and teams should add semantic fallback text plus reduced-motion behavior before using it for meaningful copy.

Use it if

  • You want a decorative hero or campaign panel where a short label reacts to pointer movement.
  • Your React app already supports client components, Tailwind utilities, and a shadcn-style cn helper.
  • You can provide separate semantic text for the message represented by the canvas.

Skip it if

  • The rendered words must remain selectable, searchable, or exposed to assistive technology by this component itself.
  • Your interface must honor reduced-motion preferences without modifying the animation loop.
  • You need a lightweight static title rather than a continuously animated canvas.
  • Your design system cannot accommodate its fixed panel treatment, gradients, border, and shadow without source edits.

Install

Installation record for ruixen-particle-text-dots
Declared dependenciesclsx, tailwind-merge
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 support for the supplied utility classes, install clsx and tailwind-merge, create or replace the local cn helper, and configure the import alias or change it to a relative path. Run it only on the client where canvas, ResizeObserver, pointer events, and animation frames are available.

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.