Pixel Bloom Cursor turns pointer movement into atmosphere: pixels bloom from the pointer path.
It fits creative homepages, portfolios, campaigns, and brand-led experiments where the pointer becomes part of the identity, and not dashboards, checkout, forms, or dense product screens.
The main risk is keeping the pointer optional. The effect must turn off cleanly on coarse pointers, leave focus outlines intact, and never sit between the user and a click. A page that breaks when the cursor layer is removed has leaned on it too hard.
Use this as cursor-system implementation guidance. Verify the shipped component export, pointer-tracking model, coarse-pointer disablement, z-index behavior, focus safety, cleanup, and reduced-motion handling before relying on exact props, defaults, imports, or installation steps.
Best Used For
Technical and launch pages where pointer movement can leave a crisp digital trace.
Desktop hero sections that benefit from pixel energy without hiding links or proof.
Pixel Bloom 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 cursor layer, throttle movement with requestAnimationFrame, avoid full-screen filter effects, and disable Pixel Bloom Cursor on coarse pointers.
Accessibility and Mobile
Turn the effect off on touch and keep native gestures intact, and give any cursor-only reveal a visible or tappable alternative.
Common Mistakes
Letting Pixel Bloom Cursor cover focus rings or clickable controls.
Forgetting to disable the effect on coarse pointers.
Hiding useful content behind mouse-only movement.
Changelog
v1.0.1
Jul 23, 2026
Added reduced-motion support, added a gridImageUrls prop with a safe fallback, and removed debug logging.
v1.0.0
Jun 4, 2026
Initial release
Props
Prop
Type
Default
Description
gridSize
number
35
Pixel grid cell size.
effectRadius
number
40
Radius of the cursor bloom.
maxTrailLength
number
8
Maximum number of active trail points.
cellLifetime
number
100
How long each pixel cell remains active.
Frequently Asked Questions
When should I use Pixel Bloom Cursor?
Use it when a launch page or technical brand needs pixels blooming from the pointer path — not on utility flows.
Does Pixel Bloom Cursor work on mobile?
Disable it on coarse pointers with CSS and JS pointer queries, then provide native touch behavior.
Can Pixel Bloom 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 Pixel Bloom Cursor behave around links and buttons?
Clicks, focus outlines, hover states, and modal layering must all behave normally with the effect in place.
What should reduced motion do for Pixel Bloom Cursor?
Disable trails, lag, ripples, and pointer-following motion, then return to the native cursor.