vibecodng.com

Free MCP betaIndex and tools live

Measured entry

motion-primitives-text-shimmer-wave

text-effectgradient-glowmotion on file

A client-side React text effect shipped as a TypeScript registry component. It splits a string into individual spans, then uses Motion to loop color, depth, position, scale, and rotation across the letters. It also depends on Tailwind utility classes and a project-local cn helper imported through the usual shadcn alias.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of motion-primitives-text-shimmer-wave at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of motion-primitives-text-shimmer-wave at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of motion-primitives-text-shimmer-wave 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 motion-primitives-text-shimmer-wave
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal66.8 KB (132.2 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 36.82s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/text-shimmer-wave.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

A focused, configurable accent for short display text, and the verified configured harness renders it cleanly. It needs a shadcn-style setup because the bare project cannot resolve the local cn utility import. Adopt it when Motion is already justified, not solely for this flourish.

Use it if

  • You want a looping wave shimmer for a short headline, status, or promotional phrase.
  • Your React app already uses Motion, Tailwind utilities, and a shadcn-style cn helper.
  • You need control over the rendered element, timing, spread, movement, scale, rotation, and transition.
  • You are comfortable limiting the effect to short strings so each character can animate independently.

Skip it if

  • You need static or reduced-motion-first text without adding your own motion preference handling.
  • You are animating long copy where one animated element per character would be excessive.
  • Your project does not use Tailwind and you do not want to translate the utility classes.
  • You want a standalone package component with no local utility alias or source integration.

Install

Installation record for motion-primitives-text-shimmer-wave
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, provide Tailwind with dark-mode support, and add a compatible cn class-merging helper at the expected alias or replace that import. Keep the client directive in frameworks that separate server and client components, and add reduced-motion behavior if your product requires it.

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/ibelick/motion-primitives
License
MIT
Record published
2026-08-14

Alternatives

Other published entries for the text-effect pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.