Measured entry

kokonut-beams-background

background-effectdark-futuristicdo not usemotion on file

A client-side, full-viewport canvas background that sends blurred, pulsing color beams upward and overlays a Motion-powered fade plus fixed heading copy. It ships as a shadcn registry component and depends on React, Motion, Tailwind utility classes, a dark-mode class on the document, and the usual cn utility alias.

This entry is a do-not-use verdict

It is published because it broke, not in spite of it. The run stopped at the mount, and the recorded output is printed further down this page.

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

Verdict

A convincing atmospheric hero effect for the stack it targets, but not a neutral drop-in. It builds in the prepared harness yet needs a shadcn-style setup to resolve its utility helper and alias, and the unsuccessful mount result warrants an integration check before adoption.

Use it if

  • You need an animated hero backdrop that fills the viewport and supports class-based light and dark themes.
  • Your React app already uses Tailwind, Motion, and the shadcn-style cn helper and import alias.
  • You are comfortable editing the bundled heading or extracting the canvas layer for your own hero content.

Skip it if

  • You need a drop-in background that accepts arbitrary children, because the declared children prop is not rendered and the heading is fixed.
  • You need motion to respect reduced-motion preferences without adding that behavior yourself.
  • You want a lightweight static treatment or need to avoid a continuously animated, full-window canvas.
  • Your layout should size the effect to a container rather than the browser viewport without source changes.

Install

Installation record for kokonut-beams-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, add React and Motion, configure Tailwind with class-based dark mode, then provide the cn class-merging helper at the expected import alias or replace that import with a local equivalent. Also replace the fixed heading and add a reduced-motion path if required.

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.