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/Fish Eye Cursor

Fish Eye Cursor

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.

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

Tune the Real Props

Overview

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.


Usage Code

page
1import FishEye from '@/components/effects/fish-eye'2 3export default function page() {4    return (5        <>6        <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'>7            <div className='h-[30vw] w-[30vw] max-md:size-[40vw] relative'>8                <FishEye />9            </div>10        </div>11           </>12    )13}

Example Production Use Case

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.


Best Used For

  • Image-led portfolios and campaign pages where one featured photograph can bulge under the pointer on desktop.
  • Desktop moments where a touch fallback image or copy is provided separately in your layout.
  • Fish Eye 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

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.


Accessibility and Mobile

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.


Common Mistakes

  • Letting Fish Eye Cursor cover focus rings or clickable controls.
  • Forgetting that coarse-pointer devices see nothing, and leaving an empty gap on mobile.
  • Placing the component in a parent with no explicit height, so the canvas has nothing to fill.

Changelog

Added reduced-motion support and restyled the reduced-motion notice for legibility.
Initial release

API Reference

PropTypeDefaultDescription
bulgeEffectnumber1Strength of the fish-eye bulge distortion.
durationnumber0.125Smoothing duration for bulge strength changes.
smoothnessnumber0.083Cursor-follow smoothing duration.
mouseInteractivebooleantrueEnables cursor-driven fish-eye distortion.

Questions, Answered.

When should I use Fish Eye Cursor?

Use it when an image-led desktop page needs one featured photograph to bulge under the pointer on hover, not on utility flows.

Does Fish Eye Cursor work on mobile?

No. On coarse pointers the component renders nothing, so touch behaviour stays native and the layout needs its own content for that space.

Can I use my own image with Fish Eye Cursor?

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.

Does Fish Eye Cursor affect links and buttons around it?

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.

What should reduced motion do for Fish Eye Cursor?

Fish Eye Cursor has no reduced-motion mode: the bulge keeps following the pointer across the image. It never replaces the native cursor.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Milky Way
Three.jsGSAPLucide-react

Milky Way

WebGL

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

Coffee Bean Cursor

Cursor

Grid Lift
Pro
canvas

Grid Lift

Backgrounds

Interactive Arrows
Pro
canvas

Interactive Arrows

Cursor

Gooey Counter
canvas

Gooey Counter

Components