
Butterfly Trail Cursor
Cursor
An image trail cursor effect that pulls project visuals toward pointer movement for portfolios, studio pages, and work indexes.
Magnetic Image Trail turns pointer movement into atmosphere: work previews follow the pointer.
Use it on creative homepages, portfolios, campaign pages, and brand experiments where the cursor can carry the visual language. Keep it off dashboards, checkout, forms, and utility-heavy product screens.
The main risk is restraint. Treat the cursor layer as throwaway: switch it off on touch, keep focus states visible, and let nothing about clicking depend on it. If the page falls apart once you remove the effect, the cursor was doing work it should not own.
import MagneticImageTrail from '@/components/effects/magnetic-image-trail' const page = () => { return ( <> <MagneticImageTrail /> </> )} export default pageA motion design studio can use Magnetic Image Trail on its work page. A cluster of project stills streams along a diagonal path behind the pointer, growing larger toward the center, and moving the cursor faster speeds up the stream and pushes images in the direction of travel.
The outcome is memory. Visitors get a quick, physical sense of the studio's range before they reach the project list, which stays in place as the real way into each case study.
Not for dashboards, checkout, forms, dense product UIs, or any flow where precision beats atmosphere.
Use one cursor layer, throttle movement with requestAnimationFrame, avoid full-screen filter effects, and disable Magnetic Image Trail on coarse pointers.
Switch it off for coarse pointers and leave touch native; anything revealed by the cursor needs a visible or tap-accessible alternative.
| Prop | Type | Default | Description |
|---|---|---|---|
trailLength | number | 18 | Maximum visible images in the trail. |
magnetStrength | number | 1 | Strength of magnetic pull, speed boost, and directional push. |
scaleIn | number | 0.06 | Minimum scale for images entering and leaving the center path. |
scaleOut | number | 1.48 | Maximum directional scale for images pushed away by movement. |
lerp | number | 0.18 | Pointer smoothing amount; higher values follow faster. |
size | number | 1 | Overall image size multiplier. |
Use it when a portfolio or agency page needs work previews following the pointer — not on utility flows.
Below 1025px wide the component renders the page content with an open-on-desktop note and no trail, so touch behaviour stays native.
Only when the same content is visible or accessible without pointer movement. Cursor-only reveals are not suitable for critical information.
Native click targets, visible focus, hover states, and modal stacking all have to keep working underneath it.
Magnetic Image Trail has no reduced-motion mode: images keep streaming toward the cursor. It never replaces the native cursor.
Need a custom effect? Tell us what to create.