
Butterfly Trail Cursor
Cursor
A branded 3D object effect where a stream of coffee beans scatters and swirls away from the pointer, for food, retail, hospitality, and campaign-led websites.
Coffee Bean Cursor turns pointer movement into atmosphere: a stream of 3D coffee beans scatters and swirls around the cursor.
It belongs on creative homepages, portfolios, campaign pages, and brand-led experiments where the cursor can become part of the visual language. It does not belong on dashboards, checkout, forms, or utility-heavy product screens.
In production, the risk is precision. The cursor layer must stay disposable, disable on coarse pointers, preserve visible focus, and never hide click intent. If removing the effect breaks the page, the cursor has been promoted past its pay grade.
import CoffeeBeanCursor from '@/components/effects/coffee-bean-cursor' const page = () => { return ( <> <CoffeeBeanCursor /> </> )} export default pageA specialty coffee roaster can use Coffee Bean Cursor in its homepage hero. A stream of 3D coffee beans flows across the screen behind the headline, and as the pointer moves through it the beans scatter and swirl away, then drift back into the flow, with a warm light following the cursor.
The outcome is a signature. The brand's product becomes the interaction, while the shop and subscription pages that follow stay free of the effect so ordering remains precise.
Not for dashboards, checkout, forms, dense product UIs, or any flow where precision beats atmosphere.
Use one full-viewport WebGL canvas, lower beanCount on weaker devices, rely on the built-in pause when offscreen or the tab is hidden, and disable Coffee Bean Cursor on coarse pointers.
Disable on coarse pointers and preserve normal touch behavior. Cursor-only reveals must have visible or tap-accessible alternatives.
| Prop | Type | Default | Description |
|---|---|---|---|
beanCount | number | 300 | Number of beans in the flowing cursor field. |
beanColor | string | #392416 | Coffee bean color. |
size | number | 22 | Rendered bean size. |
rotationSpeed | number | 1 | Rotation speed for each bean. |
mouseInteraction | boolean | true | Enables mouse-reactive bean movement. |
scatterIntensity | number | 1 | Strength and radius of the mouse scatter force. |
Use it when a food, retail, or campaign page needs a stream of branded 3D objects reacting to the cursor, not on utility flows.
It has no touch handling and keeps rendering the WebGL scene, so disable it on coarse pointers with CSS and JS pointer queries, then provide native touch behavior.
Only when the same content is visible or accessible without pointer movement. Cursor-only reveals are not suitable for critical information.
It must preserve native click meaning, visible focus, hover states, and modal layering.
The component has no reduced-motion check and the beans flow continuously, so swap in a static frame or drop the effect yourself. The native cursor is never hidden.
Need a custom effect? Tell us what to create.