Dithering for React - GSAP component

Q: Does Dithering work in Next.js App Router?

Yes. The component includes the `'use client'` directive and uses `useGSAP` for proper cleanup across Server Component re-renders. Drop it into any page or component inside `app/`.

Q: Does Dithering work in React 18 and React 19?

Yes. The component uses `useGSAP` which is React-version-agnostic. It also handles Strict Mode double-invocation correctly via `gsap.context` scoping.

Annnimate

Every component, in every framework.

Dithering is one of 50+ GSAP components, each shipping in React, Vue, and HTML/CSS/JS with the same production tuning.

Open Dithering Browse the library

Where it goes in your React app

Dithering is a leaf-level interactive component, so it needs to render on the client. In a Next.js App Router project, add the 'use client' directive at the top of the file (it's already there in the component you copy).

The component is self-contained: it manages its own refs, useGSAP scope, and cleanup. Mount it inside any Server Component, Client Component, or page. It does not require a provider or wrapper.

If your project uses TypeScript, the component is typed - the props it accepts match the data-anm-* attributes documented on the main detail page.

React-specific gotchas

Always use the useGSAP hook, not useEffect

useGSAP (from @gsap/react) handles cleanup automatically: kills tweens and ScrollTriggers on unmount, and uses gsap.context scoping so selectors only match inside your component. Plain useEffect works but leaks animations on hot-reload and Strict Mode double-invocations.

Refs over className selectors

When passing targets to gsap.to / gsap.from, use refs (elementRef.current) instead of class selectors. Refs survive Strict Mode double-renders and don't accidentally match sibling components that share class names.

gsap.registerPlugin(ScrollTrigger, SplitText, ...) must run client-side only. Wrap in if (typeof window !== 'undefined') or place inside the component body - never at module top level in SSR contexts.

Common questions

Does Dithering work in Next.js App Router?

Yes. The component includes the 'use client' directive and uses useGSAP for proper cleanup across Server Component re-renders. Drop it into any page or component inside app/.

Does Dithering work with Server Components?

The component itself runs on the client (it needs the DOM for GSAP), but the parent page can be a Server Component. Import the component normally; React's "use client" boundary handles the rest. No additional configuration needed.

Does Dithering work in React 18 and React 19?

Yes. The component uses useGSAP which is React-version-agnostic. It also handles Strict Mode double-invocation correctly via gsap.context scoping.

Will the animation flash before hydration?

Brief flash is possible on first paint because GSAP needs the client to initialize. The component sets the parked ("starting") state via gsap.set on mount before the first frame, so any visible jump is sub-frame and rarely perceived. For above-the-fold use, pair with a CSS opacity:0 default that the component clears on mount.

Every component, in every framework.

Dithering in React.

Install Dithering in your React project

Where it goes in your React app

React-specific gotchas

Common questions

Copy the React code