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/Donut Particles

Donut Particles

Turn particles into a sculptural WebGL centerpiece for bold hero sections that need presence before the first scroll.

Three.js@react-three/fiber
DemoDemoDemo

Tune the Real Props

Particle Color

Overview

Donut Particles turns a particle field into a sculptural brand object. It is the “yes, this site has a GPU budget” moment, used carefully.

Use Donut Particles when a hero needs one bold visual center rather than a decorative background. Brand launches, creative studios, AI pages, and campaign microsites can use it when the particle form supports the message. The page job is presence: the object should make the brand feel more tangible before the visitor reads the supporting copy.

The production risk is excess. The sculpture always draws 25,000 particles, and it can cost more than it communicates if size, spin, glow intensity, and pointer stretch all compete at once. The scene needs a clear focal role next to the copy and a performance check on real devices.


Usage Code

page
1import DonutParticles from "@/components/effects/donut-particles";2 3const page = () => {4  return (5    <>6      <DonutParticles particleColor="#9973ff" mouseInteraction={true} />7    </>8  );9};10 11export default page;

Example Production Use Case

A brand launch page can place Donut Particles beside a short hero claim to create a memorable first screen. The torus-like form moves slowly while the copy stays sharp and clickable. The outcome is presence: the brand has a visual object instead of another gradient blob.


Best Used For

  • Bold brand heroes where one particle sculpture can carry the visual identity.
  • AI, creative, or technical launches that need a memorable WebGL centerpiece.
  • Desktop-first hero sections where the 3D object enhances copy instead of replacing it.

Not For

Not for text-heavy pages, dashboards, checkout flows, dense product sections, or mobile-first routes where the particle scene becomes the page’s heaviest asset.

Not for brands that need calm clarity more than a sculptural first impression.


Performance Budget

The particle count is fixed at 25,000 with no prop to change it, so the levers are the dpr prop (default [1, 2]), particleSize, rotationSpeed, and speed. The render loop already pauses when the canvas is offscreen or the tab is hidden, and the material and textures are disposed on unmount. Test on a mid-range laptop, not only on the machine that wrote the code.


Accessibility and Mobile

The canvas is already marked aria-hidden, so keep the headline and any meaningful copy in HTML around it. At viewport widths of 1025px and below the donut is drawn smaller and shifted, and pointer interaction is switched off. With reduced motion, the spin, waves and pointer stretch stop and the particles hold a still torus.


Common Mistakes

  • Making the particle object brighter than the CTA.
  • Pushing particleSize, intensity, and rotationSpeed up together before checking frame rate on the full page.
  • Letting the WebGL scene carry the only visual meaning of the page.

Changelog

Add prefers-reduced-motion support
Initial release

API Reference

PropTypeDefaultDescription
particleSizenumber1Scale multiplier applied to every particle's rendered size.
donutScalenumber3.5Scale applied to the particle donut.
particleColorcolor#9973ffBase color used for the particle glow cycle.
mouseInteractionbooleantrueEnables cursor-driven particle flow on desktop viewports.
speednumber1Playback speed multiplier for rotation and particle motion.
intensitynumber1Strength multiplier for particle glow and cursor interaction force.
morphDurationnumber1.5Seconds for scattered particles to settle back into the donut.
demorphIntensitynumber1How strongly the cursor pulls particles out of the donut shape.
rotationSpeednumber1Donut spin speed multiplier.
tiltXnumber-60Donut tilt around the X axis in degrees.
tiltYnumber45Donut tilt around the Y axis in degrees.

Questions, Answered.

When should I use Donut Particles?

Use it when a launch page or brand hero needs one sculptural WebGL particle object as the visual center.

How many particles does Donut Particles draw?

It always draws 25,000 particles; the count is fixed in the source and is not a prop. To lighten the scene, lower the dpr prop (default [1, 2]) or reduce particleSize and rotationSpeed, and measure on real devices with the full page around it.

Should Donut Particles be interactive?

By default the particles react to mouse movement on desktop; set mouseInteraction to false to turn that off. Interaction is switched off automatically at viewport widths of 1025px and below and under reduced motion. The visitor should not need to play with the object to understand the page.

What should happen on mobile?

At 1025px and below the component already shrinks the donut and turns off pointer interaction, but it still renders all 25,000 particles. If that is too heavy, lower dpr, slow speed and rotationSpeed, or swap in your own static image on small screens. The hero must still read without live WebGL.

Is Donut Particles good for product pages?

Only for short brand-led sections. For product explanation, use screenshots, diagrams, or feature sections where the product remains the focus.

Can Hyperiux adapt Donut Particles for a real brand system?

Yes. A custom version should define shape language, particle behavior, color system, performance budget, fallback design, source handoff, and implementation notes.

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

Book Flip
Pro
Three.js@react-three/fiber@react-three/drei

Book Flip

WebGL

Coffee Bean Cursor
Pro
Three.js@react-three/drei@react-three/fiber

Coffee Bean Cursor

Cursor

WebGL Slider
Pro
Three.jsGSAPLenis

WebGL Slider

Carousels