# Motion Cursor Image Trail

Images appear and fade along the cursor path in a section.

- id: `motion-cursor-image-trail`
- Page: https://agentic-ui-kit.com/components/motion-cursor-image-trail
- Live preview: https://agentic-ui-kit.com/live/component/motion-cursor-image-trail?piece=motion-cursor-image-trail

## Install

```bash
agentic-ui add motion-cursor-image-trail
npx shadcn@4.17.0 add @agentic-ui/motion-cursor-image-trail
```

## Metadata

- **Level:** block
- **Category:** motion
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** image-trail-on-pointer-path, spawn-by-distance, pooled-elements, tilt-into-travel, drift-and-fade, custom-images, scoped-to-a-section, fine-pointer-only, no-react-render-per-move, reduced-motion-fallback
- **Intents:** communicate, explore-detail
- **Suits domains:** marketing, media, ecommerce, travel, social
- **Interaction:** pointer-move
- **Screen role:** overview
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** images appear and fade along the cursor path in a section, mouse trail that spawns pictures as you move, cursor image trail effect for a portfolio hero, pointer-following photo trail disabled on touch and reduced motion
- **Avoid when:** A single hover preview is wanted (use motion-image-reveal-hover), A custom cursor is wanted instead of pictures (use motion-cursor-follower or motion-cursor-variants), The section holds forms or dense reading text that the trail would distract from, Touch-first products, where nothing would show
- **Preserve when adapting:** aria-hidden-layer, fine-pointer-only, pooled-elements, behind-the-content
- **Replace when adapting:** images, size, min-distance, lifetime, pool, children
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **npm dependencies:** @agentic-ui/motion, @agentic-ui/tokens, react
- **Motion:** profile expressive, library css, reduced-motion fallback yes, target 60 fps
- **Registry dependencies:** lib-motion