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/Phantom Image Trail

Phantom Image Trail

A fading image trail cursor effect where ghosted visuals follow the pointer and dissolve across the page.

GSAP
DemoDemoDemo

Tune the Real Props

Overview

Phantom Image Trail turns pointer movement into atmosphere: images ghost behind the cursor path.

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 risk in production is precision. The cursor layer must stay disposable, disable on coarse pointers, preserve visible focus, and never hide click intent. If removing the effect breaks the page, the cursor has been promoted past its pay grade.


Usage Code

page
1import PhantomImageTrail from "@/components/effects/phantom-image-trail";2 3const page = () => {4    return (5        <>6        <div className="w-screen h-screen relative  bg-[#f8fdfe]">7             <PhantomImageTrail8                images={images}9                enableRotation={true}10                idleSpawn={false}11                idleDelay={300}12                cursorOffsetX={-12}13                cursorOffsetY={-12}14                popOutDuration={0.8}15                fadeOutDuration={0.5}16                idlePopOutMultiplier={2.2}17                idleFadeMultiplier={1.8}18                imageMultiplier={3}19            />20        </div>21        </>22    );23};24 25export default page;26 27 28 29const images = [30  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-11.jpg", alt: "Gradient 1" },31  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-12.jpg", alt: "Gradient 2" },32  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-13.jpg", alt: "Gradient 3" },33  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-14.jpg", alt: "Gradient 4" },34  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-15.jpg", alt: "Gradient 5" },35  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-01.jpg", alt: "Gradient 6" },36  { src: "https://pub-8abee449136941f5b0a1cd2c014534e9.r2.dev/vault-listing-images/assets-images/h-02.jpg", alt: "Gradient 7" },37];38 

Example Production Use Case

A fashion photographer can use Phantom Image Trail on a portfolio homepage. As the pointer moves, images from recent shoots pop in along its path, tilting slightly as they grow, then shrink and fade away, so a visitor sees a quick sequence of the work before choosing a series to open.

The outcome is momentum. The trail builds interest in the portfolio, while the series list and navigation stay fully accessible underneath.


Best Used For

  • Creative portfolios where ghosted previews can build momentum before case-study selection.
  • Image-led homepages where motion creates memory while the work remains directly accessible.
  • Phantom Image Trail 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 Phantom Image Trail on coarse pointers.


Accessibility and Mobile

Disable on coarse pointers and preserve normal touch behavior. Cursor-only reveals must have visible or tap-accessible alternatives.


Common Mistakes

  • Letting Phantom Image Trail cover focus rings or clickable controls.
  • Forgetting to disable the effect on coarse pointers.
  • Hiding useful content behind mouse-only movement.

Changelog

Added reduced-motion support, restyled the reduced-motion notice, and removed per-frame setState calls from the mouse tracker to cut wasted re-renders.
Initial release

API Reference

PropTypeDefaultDescription
imageMultipliernumber3Sets how many copies of the image set can be in flight.
triggerDistancenumber100Distance the cursor must move before spawning a new image.
lerpFactornumber0.1Cursor smoothing factor.
popOutDurationnumber0.8Image pop-in duration.
fadeOutDurationnumber0.5Image fade-out duration.
startScalenumber0.2Image starting scale.
endScalenumber1Image settled scale.
exitScalenumber0Image exit scale.
enableRotationbooleantrueEnables random image tilt.
maxStartRotationnumber35Maximum starting tilt. Needs Enable Rotation on.
maxExitRotationnumber15Maximum exit tilt. Needs Enable Rotation on.
idleSpawnbooleanfalseSpawns images while the cursor rests.
idleDelaynumber300Delay before idle spawning starts. Needs Idle Spawn on.
idlePopOutMultipliernumber2.2Multiplier for idle pop-in timing. Needs Idle Spawn on.
idleFadeMultipliernumber1.8Multiplier for idle fade-out timing. Needs Idle Spawn on.

Questions, Answered.

When should I use Phantom Image Trail?

Use it when a portfolio or campaign page needs images ghosting behind the cursor path — not on utility flows.

Does Phantom Image Trail work on mobile?

On coarse pointers it spawns an image wherever you tap, by default. Set enableMobileTap={false} to stop tap spawning, or disableOnMobile to stop the trail and idle spawning there.

Can Phantom Image Trail 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 Phantom Image Trail behave around links and buttons?

It must preserve native click meaning, visible focus, hover states, and modal layering.

What should reduced motion do for Phantom Image Trail?

Phantom Image Trail has no reduced-motion mode: images keep spawning as the pointer moves, because the motion is the effect. Leave it unmounted if reduced motion should mean no trail.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Interactive Blur Reveal
WebGL Shader

Interactive Blur Reveal

WebGL

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

Coffee Bean Cursor

Cursor

Butterfly Trail Cursor
Pro
Three.js@react-three/fiber@react-three/drei

Butterfly Trail Cursor

Cursor

Colorful Cursor Aura
Pro
GSAP

Colorful Cursor Aura

Cursor