aceternity-ui

Install and configure 100+ animated Aceternity UI React components in Next.js projects via the shadcn CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up Aceternity UI in a Next.js project involves multiple error-prone steps: initializing the shadcn CLI, configuring a custom component registry, installing motion dependencies, and debugging issues like missing "use client" directives or a missing cn utility. This Skill provides vetted installation commands, a complete component catalog, and troubleshooting guidance to avoid those failures. ## Core Features & Use Cases - Guided Installation: Step-by-step setup for Next.js 13+ with the shadcn CLI, including the @aceternity registry configuration in components.json and a manual fallback path. - Component Catalog: 100+ animated components organized into 15 categories (backgrounds, cards, parallax, text effects, buttons, navigation, forms, modals, carousels, 3D, loaders) with install commands and use cases. - Troubleshooting & Best Practices: Fixes for common errors (missing motion module, cn not defined, animations not running, dark mode issues) plus performance, accessibility, and dark mode patterns. - Use Case: A developer building a landing page needs an animated hero section. The Skill directs them to install background-beams and typewriter-effect via the shadcn CLI and provides ready-to-adapt TSX code combining both components. ## Quick Start Ask the assistant to set up Aceternity UI in your Next.js project and add an animated background-beams hero section using the shadcn CLI.

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 URL to components.json, then run npx shadcn@latest add @aceternity/component-name. Components are copied into your components/ui directory as editable source code.

What is Aceternity UI used for in React projects?

Aceternity UI provides 100+ animated React components for Next.js, including backgrounds, 3D cards, parallax scroll effects, typewriter text, and animated modals. Components use Tailwind CSS and Framer Motion and support dark mode.

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

Yes, Aceternity UI supports Next.js 13+ with the App Router. Because components use Framer Motion, you must add the "use client" directive at the top of files that import them, since they require client-side rendering.

Why is my Aceternity component not animating?

The most common cause is a missing "use client" directive at the top of the file. Also verify the motion package is installed, the cn utility exists in lib/utils.ts, and Tailwind directives are present in globals.css.

Can I use Aceternity UI without the shadcn CLI?

Yes, manual installation works as a fallback. Install motion, clsx, and tailwind-merge, create the cn helper in lib/utils.ts, then copy component source code directly from ui.aceternity.com into your project.