Measured entry

magicui-light-rays

background-effectaurora-meshmotion on file

A client-side React background layer that creates randomized, softly swinging light beams with Motion and CSS gradients. It ships as a shadcn registry component, uses Tailwind utility classes and the shared cn helper, and needs no provider. Its absolute layout is intended to sit inside a positioned container.

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

Verdict

A polished but very subtle dark-surface accent with useful controls and clean verified behavior. Adopt it when Motion is already justified. It needs a shadcn-style setup because the standalone build cannot resolve the shared cn utility.

Use it if

  • You need a restrained animated atmosphere behind a dark hero, banner, or feature panel.
  • Your project already uses Tailwind, the shadcn utility convention, and Motion.
  • You want to tune the ray color, blur, pace, length, or density through component props.

Skip it if

  • You need deterministic visuals, since ray placement and timing are randomized in the browser.
  • Your motion policy requires a built-in reduced-motion fallback or pause control.
  • You want a dependency-light decorative background and do not otherwise use Motion.
  • Your design is primarily light-surfaced, where the screen-blended rays may be too faint.

Install

Installation record for magicui-light-rays
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 or replace that call, configure the @ alias if retaining the import, and ensure Tailwind processes the component's utility classes. Place it inside a positioned container with defined dimensions and clipping.

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