Loading
Loading
Loading
mobile footer

Build the Interaction Layer Your Website is Missing.

Browse All EffectsBrowse All EffectsBrowse All EffectsUpgrade to ProUpgrade to ProUpgrade to Pro

70+ effects free, forever. No credit card.

© 2026 Hyperiux. All Rights Reserved.

AI Component CatalogueHey AI, Learn About Us
Platform

Vault

  • Documentation
  • Pricing
  • Blog
  • Community
  • NPM
  • MCP

Categories

  • All Effects
  • WebGL
  • Text
  • Backgrounds
  • Buttons
  • Carousels
  • Scroll
  • Components
  • Navigation
  • Cursor
  • Transitions
  • Loaders

Documents

  • Introduction
  • Installation
  • CLI
  • Dependencies
  • License

Legal

  • License Agreement
  • Terms of Service
  • Privacy Policy
  • Refund Policy
Socials
  • Twitter / X
  • LinkedIn
  • GitHub
  • Instagram
Contact Us
  • hello@hyperiux.com
New effects, in your inbox

Every new drop, plus the occasional behind-the-scenes build. No spam. Unsubscribe anytime.

All Effects
Featured ComponentsText AnimationsAnimated BackgroundsAnimated ButtonsCarousel EffectsScroll EffectsCreative ComponentsNavigationsCursor EffectsTransitionsLoadersWebGL & 3D Effects
Templates
IntroductionInstallationCLIDependenciesLicense
PricingBlogGithubNPMMCP Doc
Loading
Home/effects/Coffee Bean Cursor

Coffee Bean 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.

Three.js@react-three/drei@react-three/fiber
DemoDemoDemo

Tune the Real Props

Bean Color

Overview

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.


Usage Code

page
1import CoffeeBeanCursor from '@/components/effects/coffee-bean-cursor'2 3const page = () => {4  return (5    <>6    <CoffeeBeanCursor />7    </>8  )9}10 11export default page

Example Production Use Case

A 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.


Best Used For

  • Food, retail, and campaign pages where a field of branded 3D objects can react to the pointer.
  • Experience-led homepages where the bean stream adds delight but ordering and navigation stay precise.
  • Coffee Bean Cursor gives pointer movement a brand role without hiding core controls or content.

Not For

Not for dashboards, checkout, forms, dense product UIs, or any flow where precision beats atmosphere.


Performance Budget

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.


Accessibility and Mobile

Disable on coarse pointers and preserve normal touch behavior. Cursor-only reveals must have visible or tap-accessible alternatives.


Common Mistakes

  • Letting Coffee Bean Cursor cover focus rings or clickable controls.
  • Forgetting to disable the effect on coarse pointers.
  • Hiding useful content behind mouse-only movement.

Changelog

reduce-motion applied
Initial release

API Reference

PropTypeDefaultDescription
beanCountnumber300Number of beans in the flowing cursor field.
beanColorstring#392416Coffee bean color.
sizenumber22Rendered bean size.
rotationSpeednumber1Rotation speed for each bean.
mouseInteractionbooleantrueEnables mouse-reactive bean movement.
scatterIntensitynumber1Strength and radius of the mouse scatter force.

Questions, Answered.

When should I use Coffee Bean Cursor?

Use it when a food, retail, or campaign page needs a stream of branded 3D objects reacting to the cursor, not on utility flows.

Does Coffee Bean Cursor work on mobile?

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.

Can Coffee Bean Cursor reveal important content?

Only when the same content is visible or accessible without pointer movement. Cursor-only reveals are not suitable for critical information.

How should Coffee Bean Cursor behave around links and buttons?

It must preserve native click meaning, visible focus, hover states, and modal layering.

What should reduced motion do for Coffee Bean Cursor?

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.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Butterfly Trail Cursor
Pro
Three.js@react-three/fiber@react-three/drei

Butterfly Trail Cursor

Cursor

Split Canvas
GSAP Three.jsLenis

Split Canvas

Scroll

Character Trail
Pro
Vanilla JS

Character Trail

Cursor

Donut Particles
Pro
Three.js@react-three/fiber

Donut Particles

WebGL

Numeric Tunnel Loader
GSAP @react-three/fiber@react-three/drei

Numeric Tunnel Loader

Loaders