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.
Install and prerequisites
npx shadcn@latest add @aceternity/bento-grid@aceternitymotionReact 19, Tailwind CSS v4 and motion. Free items install from @aceternity/*; Pro items require ACETERNITY_PRO_TOKEN.
Framework setup
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.
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
Hard-coded dark or zinc colours
Many Aceternity components arrive with fixed
bg-black,bg-neutral-900ortext-neutral-400classes 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.Continuous SVG beam and canvas loops
BackgroundBeams,SparklesCoreandWavyBackgroundrun continuous requestAnimationFrame or SVG loops. Pause them when off-screen and disable them whenprefers-reduced-motion: reduceis set.Never commit ACETERNITY_PRO_TOKEN
If using Pro registry items, reference
${ACETERNITY_PRO_TOKEN}incomponents.jsonheaders and keep the token value in.env.local(git-ignored).
Accessibility and 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.
More Grid Notes
- shadcn/uiCopy-in React components built on Base UI or Radix UI and Tailwind CSS v4, plus an official MCP server that searches and installs from any namespaced registry.
- React BitsAnimated text effects, shaders, cursors and interactive backgrounds installed as source code in four variants (`-JS-CSS`, `-JS-TW`, `-TS-CSS`, `-TS-TW`).
- Magic UIOver 150 animated landing-page components — marquees, Bento grids, shimmer buttons, globes and device mocks — built with React, Tailwind CSS and Motion.
- Motion PrimitivesComposable, minimal React motion building blocks — animated groups, text effects, morphing dialogs, docks and carousels — built on Motion and Tailwind CSS.
- coss uiOpen-source React components built on Base UI (`@base-ui/react`) and Tailwind CSS v4 (formerly Origin UI; `originui.com` redirects here).
- Fancy ComponentsExperimental, playful React components — letter swaps, variable-font hover effects, physics gravity, gooey SVG filters and image trails — built with Tailwind CSS and Motion.



