vibecodng.com

Free MCP betaIndex and tools live

Measured entry

magicui-particles

background-effectaurora-meshmotion on file

A client-only React background effect that draws drifting, pointer-responsive particles on a canvas and runs them through an ongoing animation loop. It ships as a shadcn registry component, uses Tailwind utility classes, and imports the project-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 magicui-particles at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of magicui-particles at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-particles 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-particles
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal30.8 KB (96.3 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 727ms
error during build:
[vite:load-fallback] Could not load <sandbox>re-c0d24d025187/src/lib/utils (imported by src/cut/particles.tsx): ENOENT: no such file or directory, open '<sandbox>re-c0d24d025187/src/lib/utils'

Verdict

A capable, configurable canvas backdrop that builds and mounts cleanly in its intended environment, with no reported accessibility violations. It needs a shadcn-style setup and does not mount bare; narrow layouts also need deliberate overflow containment.

Use it if

  • You need a decorative particle field behind a hero or other bounded section.
  • Your React app already has Tailwind and a shadcn-style cn utility.
  • You want configurable particle density, color, drift, and pointer response without adding a canvas library.

Skip it if

  • Your layout must remain overflow-free on narrow screens without extra containment work.
  • You need a static or reduced-motion-first background with no continuous canvas loop.
  • You want a dependency-free drop-in for a plain React project.
  • The added client bundle cost is hard to justify for a purely decorative effect.

Install

Installation record for magicui-particles
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 clsx and tailwind-merge, create the cn helper under the expected lib alias or change the import, configure that alias, and provide Tailwind equivalents for the sizing and pointer-event utility classes. Keep it in a client-rendered boundary.

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/magicuidesign/magicui
License
MIT
Record published
2026-08-17

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.