aceternity-ui

Install and configure animated React components for Next.js via the shadcn CLI.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aashahin/ai-skills --skill aceternity-ui-aashahin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aceternity-ui
Source: https://github.com/aashahin/ai-skills/tree/main/aceternity-ui
Command: npx skills add https://github.com/aashahin/ai-skills --skill aceternity-ui-aashahin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires motion, clsx, tailwind-merge, and includes references (resource) components.

What problem does it solve? Building animated, interactive landing pages in Next.js requires writing complex Framer Motion and Tailwind code from scratch, and integrating Aceternity UI components often fails due to registry misconfiguration, missing dependencies, or incorrect shadcn CLI setup. ## Core Features & Use Cases - Component Installation Guidance: Step-by-step setup of the Aceternity registry in components.json and installation of 100+ components via the shadcn CLI with bun, npm, or pnpm. - Component Catalog: A categorized reference of 100+ components covering backgrounds, 3D cards, parallax scroll, text effects, modals, carousels, and more, each with install commands and use cases. - Troubleshooting: Fixes for common errors such as missing motion dependency, undefined cn utility, missing "use client" directive, and dark mode misconfiguration. - Use Case: Build a landing page hero section by combining BackgroundBeams, TypewriterEffect, and a MovingBorder CTA button in a Next.js App Router project. ## Quick Start Ask the assistant to set up Aceternity UI in your Next.js project and add an animated background-beams hero section.

Frequently Asked Questions about aceternity-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Aceternity UI components in Next.js?▼

Initialize shadcn with npx shadcn@latest init, add the Aceternity registry to components.json, then run npx shadcn@latest add @aceternity/component-name. Components are copied into your components/ui directory for full customization.

How to fix module not found motion error in Aceternity UI?▼

Install the motion package with bun add motion, npm install motion, or pnpm add motion. Aceternity components depend on Framer Motion (now distributed as motion) for animations, and the error disappears once it is installed.

Does Aceternity UI work with Next.js App Router?▼

Yes, Aceternity UI supports Next.js 13+ with App Router, which is the recommended setup. Because components use Framer Motion, add the "use client" directive at the top of files that import them.

Why are my Aceternity components not animating?▼

The most common cause is a missing "use client" directive, since Framer Motion requires client-side rendering. Also verify the motion package is installed and that Tailwind directives are present in globals.css.

Can I customize Aceternity UI component source code?▼

Yes, components are copied directly into your project rather than installed as an npm package, so you can edit the source files freely. You can also override styles via the className prop using Tailwind classes.

Does Aceternity UI support dark mode with Tailwind?▼

Yes, all components support dark mode through Tailwind's dark: variant classes. Ensure tailwind.config.ts sets darkMode to "class" so the dark variants activate correctly.