
Coffee Bean Cursor
Cursor
A pointer-driven image effect that sets how pixelated the whole image is from the pointer's horizontal position, from clear at the left edge to blocky at the right, for digital, retro, gaming, and experimental interfaces.
Pixelated Image turns pointer movement into atmosphere: the whole image becomes more or less pixelated depending on where the pointer sits across it, easing between sizes.
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.
In production, the risk is restraint. The image starts pixelated at the base pixel size and is only fully clear with the pointer at the left edge, so never rely on it to show detail people need. It also responds to touch, so keep it out of places where a drag should scroll the page. If the page falls apart once you remove the effect, the pointer was doing work it should not own.
import PixelatedImageEffect from "@/components/effects/pixelated-image-effect"; export default function Page() { return ( <> <PixelatedImageEffect src="https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/v-02.jpg" /> </> );}An indie game studio can use Pixelated Image Effect on the key art for an upcoming release. As the visitor moves the pointer across the image, the whole artwork sharpens as the pointer nears the left edge and breaks into larger pixel blocks as it moves right, so it shifts between finished render and retro texture.
The outcome is character. The pixel language of the game shows up in the interaction, and the clear image is always one move to the left edge away.
Not for dashboards, checkout, forms, dense product UIs, or any flow where precision beats atmosphere.
Each pointer move starts a short requestAnimationFrame tween (0.25s by default) that re-renders an SVG filter chain over the image, so keep the image block a moderate size, use one instance per view, and compress the source image.
It works with touch as well as a mouse: tapping or dragging sets the pixel size, and the image area uses touch-action: none, so page scrolling won't start from it. The image's alt text is fixed to "pixelated-image" in the source (an alt prop is declared but not applied), so set meaningful alt text there, and keep anything important visible outside the image.
| Prop | Type | Default | Description |
|---|---|---|---|
pixelSize | number | 16 | Baseline pixel size for the SVG pixelation filter. |
duration | number | 0.25 | Smoothing duration for pixel-size changes. |
Use it when a technical or editorial page needs an image that sharpens or breaks into pixel blocks as the pointer moves across it, not on utility flows.
Yes. Tapping or dragging across the image sets the pixel size, clear on the left and blockiest on the right. The image area uses touch-action: none, so page scrolling won't start from it.
Only when the same content is visible or accessible without pointer movement. Cursor-only reveals are not suitable for critical information.
It is a self-contained image block with the filter applied only to that block, so it does not sit over other links or buttons. Keep controls outside the filtered area, because the filter pixelates everything inside it.
Pixelated Image has no reduced-motion mode: the pixel size keeps easing to follow the pointer position. Leave it unmounted if reduced motion should mean a plain image.
Need a custom effect? Tell us what to create.