
Coffee Bean Cursor
Cursor
A playful cursor trail effect that leaves butterfly-like forms behind the pointer for creative, retail, culture, and campaign pages.
Butterfly Trail Cursor turns pointer movement into atmosphere: small playful forms trail behind 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 production 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 ButterflyTrailCursor from "@/components/effects/butterfly-trail-cursor";import React from "react"; const page = () => { return ( <> <ButterflyTrailCursor /> </> );}; export default page;A botanical garden can use Butterfly Trail Cursor on the landing page for its spring exhibition. As the visitor moves the pointer across the hero, small animated butterflies appear along the path, flutter away, and fade out.
The outcome is delight. The season's theme becomes something the visitor sets in motion, and because the layer is decorative, ticket and opening-hours links stay clear and work without it.
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 Butterfly Trail Cursor 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 |
|---|---|---|---|
butterflyCount | number | 14 | Number of trail butterflies. |
trailDistance | number | 18 | Distance between trail items. |
wingColor | string | #ffffff | Primary butterfly wing color. |
size | number | 28 | Rendered butterfly size. |
followSpeed | number | 0.18 | How quickly the trail follows the pointer. |
Use it when a creative homepage, portfolio, or campaign section needs small playful forms trailing the pointer not on utility flows.
It runs on touch screens too: there is no coarse-pointer switch, and each tap spawns a burst of butterflies. Gate it behind a pointer media query yourself if you want it off on touch.
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.
Butterfly Trail Cursor has no reduced-motion mode. Butterflies keep spawning and drifting with pointer movement, since that motion is the whole effect, and the native cursor stays visible throughout.
Need a custom effect? Tell us what to create.