Skip to content

Aceternity UI Grid Notes

Dramatic landing-page hero sections, 3D card perspectives, spotlights, beams and macbook scroll effects built with React 19, Tailwind CSS v4 and Motion.

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 @aceternity/bento-grid
Packages:@aceternitymotion

React 19, Tailwind CSS v4 and motion. Free items install from @aceternity/*; Pro items require ACETERNITY_PRO_TOKEN.

Framework setup

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

Installing and scoping an Aceternity component

Keep pointer-tracking and canvas effects in isolated leaf client components so the surrounding server component page stays static.

components/feature-bento.tsx
import { BentoGrid, BentoGridItem } from "@/components/ui/bento-grid";

export function FeatureBento({ items }: { items: { title: string; description: string }[] }) {
  return (
    <BentoGrid className="mx-auto max-w-5xl">
      {items.map((item) => (
        <BentoGridItem key={item.title} title={item.title} description={item.description} />
      ))}
    </BentoGrid>
  );
}

Gotchas for agents

Real-world traps — version mismatches, licence boundaries, main-thread stalls and CSS layer rules — that trip AI agents up.
  1. Hard-coded dark or zinc colours

    Many Aceternity components arrive with fixed bg-black, bg-neutral-900 or text-neutral-400 classes that break light mode or fail WCAG AA contrast (4.5:1). Replace fixed neutral classes with your design system's semantic surface and ink tokens immediately after adding.

  2. Continuous SVG beam and canvas loops

    BackgroundBeams, SparklesCore and WavyBackground run continuous requestAnimationFrame or SVG loops. Pause them when off-screen and disable them when prefers-reduced-motion: reduce is set.

  3. Never commit ACETERNITY_PRO_TOKEN

    If using Pro registry items, reference ${ACETERNITY_PRO_TOKEN} in components.json headers and keep the token value in .env.local (git-ignored).

Accessibility and reduced motion

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

Reduced motion

Guard 3D tilt (3d-card), mouse-follow spotlights and continuous beam animations behind (prefers-reduced-motion: no-preference) so vestibular-sensitive users see a stable card.

Keyboard and screen readers

Check that interactive cards use real <Link> or <button> elements inside the card rather than onClick handlers on a <div> with no keyboard access.