Skip to content

React Bits Grid Notes

Animated text effects, shaders, cursors and interactive backgrounds installed as source code in four variants (`-JS-CSS`, `-JS-TW`, `-TS-CSS`, `-TS-TW`).

Grid NotesVersion registryUI librariesChecked 2026-11-04
Setup & agent config

Install and prerequisites

What your agent should install or configure before writing code with this pack.
Terminal
npx shadcn@latest add @react-bits/SplitText-TS-TW
Packages:@react-bits

Always append the language and styling suffix (-TS-TW for TypeScript + Tailwind) to the component name when running shadcn add.

Framework setup

Production-ready wiring for React 19, Next.js App Router and Tailwind CSS v4.

Wrapping an animated text or background component accessibly

Keep the real heading text intact for screen readers and render decorative canvas or per-character effects inside an aria-hidden layer.

components/hero-heading.tsx
"use client";

import SplitText from "@/components/SplitText";

export function HeroHeading({ text }: { text: string }) {
  return (
    <h1 className="text-4xl font-semibold tracking-tight">
      <span className="sr-only">{text}</span>
      <span aria-hidden="true">
        <SplitText text={text} className="inline-block" delay={30} />
      </span>
    </h1>
  );
}

Gotchas for agents

Real-world traps — version mismatches, licence boundaries, main-thread stalls and CSS layer rules — that trip AI agents up.
  1. Variant suffix is required in registry names

    npx shadcn@latest add @react-bits/SplitText fails because every item in the @react-bits registry ends with its variant: -TS-TW, -TS-CSS, -JS-TW or -JS-CSS.

  2. MIT + Commons Clause licence

    React Bits components may be used in commercial apps and client websites, but the Commons Clause prohibits reselling or redistributing the components themselves as a UI kit, template library or competing registry.

  3. Heavy WebGL/OGL backgrounds on battery

    Shader backgrounds (Aurora, Iridescence, LiquidChrome) run continuous WebGL loops (ogl or three). Pause them with IntersectionObserver when scrolled off-screen and disable them under prefers-reduced-motion: reduce.

Accessibility and reduced motion

How to keep animations and interactive components accessible across keyboard, screen readers and prefers-reduced-motion.

Reduced motion

Many React Bits components start continuous loops on mount without checking prefers-reduced-motion. Gate WebGL backgrounds and looping text effects with a reduced-motion media query and provide a pause button if a loop runs past 5 seconds.

Keyboard and screen readers

Custom cursor Followers (SplashCursor, BlobCursor) must have pointer-events-none and aria-hidden="true" so they never block clicks or pollute the accessibility tree.