How do I install the Gravity Trail?

Run npx shadcn@latest add @aceternity/gravity-trail. 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/gravity-trail.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 Gravity Trail 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 Gravity Trail 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.

3 / 9

Gravity Trail

Images drop from your cursor as you move, flung with its speed, and fall under gravity out of the box. No walls, no bounce.

Move yourcursor

Dependencies

motion

Frequently asked questions

How do I install the Gravity Trail?: Run npx shadcn@latest add @aceternity/gravity-trail. 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/gravity-trail.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 Gravity Trail 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 Gravity Trail 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