
Milky Way
WebGL
A WebGPU image effect that draws a single built-in photograph on a Three.js plane and bulges it like a fish-eye lens around the pointer while the cursor is over it, easing back to flat when the cursor leaves.
Fish Eye Cursor turns pointer movement into atmosphere: when the cursor moves over its image, the picture bulges outward around the pointer like a fish-eye lens, following it smoothly and settling back to flat when the cursor leaves. It warps only its own image; it does not affect other content or replace the native 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.
The production risks are content and touch. The image is a single hard-coded photograph (there is no src prop, so swap DEFAULT_IMAGE_SRC in the source), it is drawn in a canvas with no alt text, and on coarse-pointer devices the component renders nothing at all. Size it with its parent, which needs an explicit height, and provide the image or an alternative for touch users in your own markup.
import FishEye from '@/components/effects/fish-eye' export default function page() { return ( <> <div className='h-screen w-full bg-zinc-200 max-md:p-[20vw] max-sm:p-[10vw] max-md:flex-col flex items-start p-[5vw] pt-[6.5vw] justify-between max-md:justify-center max-md:gap-[10vw] max-md:items-center'> <div className='h-[30vw] w-[30vw] max-md:size-[40vw] relative'> <FishEye /> </div> </div> </> )}A landscape photographer can use Fish Eye Cursor for a featured image on a portfolio homepage, swapping the built-in photograph for their own in the source. As the pointer moves over the photograph, a bulge distortion follows it and enlarges the area underneath, inviting visitors to look closer at texture, light, and detail.
The outcome is curiosity. With a mouse, the photograph reads as a complete image until the pointer enters it. On touch devices the component renders nothing, so the page needs its own image or content for that space, and gallery navigation should live outside the effect.
Not for dashboards, checkout, forms, dense product UIs, or any flow where precision beats atmosphere.
Each instance creates its own WebGPU canvas and fetches its image, and the render loop stops when the canvas is offscreen or the tab is hidden. Use one or two instances per page, keep the image file small, and note that coarse-pointer devices skip the canvas, though the image is still fetched before the component switches to its touch state.
The image is drawn in a canvas with no alt text or role, so give the surrounding section a text description if the photograph carries meaning. On coarse pointers the component returns null, leaving touch behaviour native but the space empty, so supply your own image or content for mobile.
| Prop | Type | Default | Description |
|---|---|---|---|
bulgeEffect | number | 1 | Strength of the fish-eye bulge distortion. |
duration | number | 0.125 | Smoothing duration for bulge strength changes. |
smoothness | number | 0.083 | Cursor-follow smoothing duration. |
mouseInteractive | boolean | true | Enables cursor-driven fish-eye distortion. |
Use it when an image-led desktop page needs one featured photograph to bulge under the pointer on hover, not on utility flows.
No. On coarse pointers the component renders nothing, so touch behaviour stays native and the layout needs its own content for that space.
Yes, by changing DEFAULT_IMAGE_SRC in the component source; there is no image prop. The image is fetched with CORS, so host it somewhere that allows cross-origin requests. The texture stretches to the canvas size, so match the container's aspect ratio to the image.
No. The warp is confined to the component's own canvas and the native cursor stays visible, so nearby links, focus rings and hover states are untouched. Avoid placing controls on top of the canvas, since it captures pointer events for the bulge.
Fish Eye Cursor has no reduced-motion mode: the bulge keeps following the pointer across the image. It never replaces the native cursor.
Need a custom effect? Tell us what to create.