Motion Cursor Image Trail
Images appear and fade along the cursor path in a section.
Choose the primitives library your project already uses. Both look the same: your theme, not the variant, controls colors, shape, type and motion.
About this motion
What it's 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.
For A single hover preview is wanted, use Motion Image Reveal Hover.
Includes
- 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
Works with
- Radix UI and Base UI primitives (pick the one your project uses)
- React 19 and Tailwind CSS 4 in Next.js (App Router), Vite, React Router or TanStack Start, installed with the agentic-ui or shadcn CLI
- Your theme tokens, in light and dark mode
Install
Included with Agentic UI Kit (one-time license). Install needs your license key: see pricing · connect your project.
Agentic UI CLI
agentic-ui add motion-cursor-image-trailInstalls through shadcn and adapts the component to your design tokens.
shadcn CLI
npx shadcn@4.17.0 add @agentic-ui/motion-cursor-image-trailUsed in
A standalone component: drop it into any screen.
- Type
- Motion
- Variants
- Radix UI and Base UI
- Themes
- Light and dark
- Widths
- Preview it at desktop, tablet and mobile widths above.
- Motion
- Animated, with a reduced-motion fallback
- npm packages
- None beyond your project's React and Next.js
- Registry dependencies
lib-motion- Files
10 files
- components/agentic-ui/motion-cursor-image-trail/motion-cursor-image-trail/motion-cursor-image-trail.tsx
- components/agentic-ui/motion-cursor-image-trail/styles/motion-cursor-image-trail.css
- components/agentic-ui/motion-cursor-image-trail/motion-cursor-image-trail/use-image-trail.ts
- components/agentic-ui/motion-cursor-image-trail/motion-cursor-image-trail/trail-model.ts
- components/agentic-ui/motion-cursor-image-trail/_shared/clamp.ts
- components/agentic-ui/motion-cursor-image-trail/motion-cursor-image-trail/default-images.tsx
- components/agentic-ui/motion-cursor-image-trail/_shared/use-fine-pointer.ts
- components/agentic-ui/motion-cursor-image-trail/_shared/types.ts
- components/agentic-ui/motion-cursor-image-trail/_shared/policy-options.ts
- components/agentic-ui/motion-cursor-image-trail/_shared/apply-defaults.ts
Related components
Motion Accordion
Setup checklist with per-step status.
Details and live previewMotion Achievement Unlock
Learning or fitness app that reveals a badge in a corner toast when the first lesson of the day is done.
Details and live previewMotion AI Thinking Orb
Assistant status next to the chat composer while a reply is thinking or streaming.
Details and live previewMotion Animated Beam
Animated beam connecting integration logos to a central hub.
Details and live preview