Measured entry

motion-primitives-animated-background

background-effectaurora-meshmotion on file

A client-side React selection and highlight primitive shipped as a shadcn registry TypeScript file. It clones children carrying data-id, animates a shared absolute background with Motion, and relies on React, Tailwind utility classes, the motion package, and a local cn helper.

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

Verdict

A focused primitive that works well when its children already provide the interaction semantics. The clean harness result is encouraging, but it needs a shadcn-style setup because the bare project cannot resolve the expected local utility import.

Use it if

  • You want one animated highlight to move between buttons, tabs, filters, or navigation choices.
  • Your React interface already uses Motion and Tailwind utilities.
  • You want click selection or a pointer-hover preview with a change callback.

Skip it if

  • You need a controlled value prop rather than internal active-state management.
  • You need tab semantics, keyboard navigation, focus management, or selection ARIA built into the component.
  • You do not want the Motion dependency for a small highlight effect.
  • You need hover behavior that works equivalently for touch and keyboard users without adaptation.

Install

Installation record for motion-primitives-animated-background
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 a cn class-merging helper, and either configure the at-sign source alias for the expected utility path or rewrite that import. Add Tailwind utility support, keep it in a client-rendered React boundary, and supply semantic interactive children with data-id attributes.

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 background-effect pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.