How do I install the Image Wave?

Run npx shadcn@latest add @aceternity/image-wave. Before installing, add the Aceternity Pro registry to your components.json and set your API token as the ACETERNITY_PRO_TOKEN environment variable. The CLI adds the file to components/interactions/image-wave.tsx and installs Motion. You can also ask an agent with the shadcn MCP server connected, or copy the prompt with the full source into any AI tool.

Is the Image Wave included with All-Access?

Yes. Interactions are included with the Aceternity UI All-Access plan (1-Year License, Lifetime, or an active yearly subscription). Anyone can play with the preview and the controls; All-Access unlocks the code, the CLI and MCP install, and the prompt.

Can I change how the Image Wave moves?

Yes. Use the controls next to the preview to change the timing and the motion in real time. Every control is a prop of the component.

Yes. It uses native elements and ARIA roles, works with the keyboard, follows your shadcn/ui theme tokens, and reduces motion when the system asks for reduced motion.

14 / 14

Image Wave

An image on a thin 3D slab that a slow wave rolls through, with light running along the crests. Drag it to turn it and see its edge and back; it keeps turning and settles back.

Dependencies

motionthree

Frequently asked questions

How do I install the Image Wave?: Run npx shadcn@latest add @aceternity/image-wave. Before installing, add the Aceternity Pro registry to your components.json and set your API token as the ACETERNITY_PRO_TOKEN environment variable. The CLI adds the file to components/interactions/image-wave.tsx and installs Motion. You can also ask an agent with the shadcn MCP server connected, or copy the prompt with the full source into any AI tool.
Is the Image Wave included with All-Access?: Yes. Interactions are included with the Aceternity UI All-Access plan (1-Year License, Lifetime, or an active yearly subscription). Anyone can play with the preview and the controls; All-Access unlocks the code, the CLI and MCP install, and the prompt.
Can I change how the Image Wave moves?: Yes. Use the controls next to the preview to change the timing and the motion in real time. Every control is a prop of the component.
Is it accessible?: Yes. It uses native elements and ARIA roles, works with the keyboard, follows your shadcn/ui theme tokens, and reduces motion when the system asks for reduced motion.

Set up the CLI and MCP · All interactions

Dependencies

Tags

Frequently asked questions