Workspace / effect / overlay

Grid Ripple

3D tiles that ripple in staggered waves around the cursor over your live HTML.

Workspaceeffectoverlay

npx shadcn@latest add @pax-sh/grid-ripple-reactlocal only

Tier: medium. Reduced motion: flat grid

GridRipple.tsx
"use client";

import { useEffect, useRef } from "react";
import { gridRippleEffect } from "@pax-sh/effects";

export interface GridRippleProps {
  className?: string;
  reducedMotion?: boolean;
  tier?: "low" | "medium" | "high";
  children?: React.ReactNode;
}

export function GridRipple(props: GridRippleProps) {
  const rootRef = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const target = rootRef.current;
    if (!target) return;
    const instance = gridRippleEffect.mount(target, {
      className: props.className,
      reducedMotion: props.reducedMotion,
      tier: props.tier,
    });
    return () => instance.dispose();
  }, [props.className, props.reducedMotion, props.tier]);

  return (
    <div ref={rootRef} className={props.className} data-pax-effect="grid-ripple">
      {props.children}
    </div>
  );
}