1. Blocks
Loading preview...

The remote MCP server is temporarily paused due to usage limits. Learn more

  1. Blocks
  2. Cursor Trail Reveal

component

Cursor Trail Reveal

Desktop cursor trail with CSS clip-path reveals as the pointer moves — no Motion or GSAP.

Released November 14, 2026
Made by Axyl

Installation

npx shadcn@latest add @soralabs/cursor-trail-reveal

File Structure

cursor-trail-reveal.tsx

Usage

You must pass images — there is no built-in default. The trail only runs on desktop (viewport wider than desktopBreakpoint, default 1000px). On smaller screens it renders an empty layer and does nothing.

Place it inside a relatively positioned section that fills the area you want the trail to cover (usually full viewport). Layer your copy above the trail with a higher z-index (for example z-[1]). The trail container uses pointer-events-none, so buttons and links in the overlay stay clickable.

Match maskColor to the section background so the clip-path strips blend in during the reveal.

import CursorTrailReveal from "@/components/sora-ui/blocks/cursor-trail-reveal";
import TextRevealBlock from "@/components/sora-ui/texts/text-reveal-block";

const trailImages = Array.from(
  { length: 19 },
  (_, index) =>
    `https://cdn.soralabs.studio/media/demo/cursor-trail-reveal/trail-${index + 1}.jpg`
);

export default function ContactPage() {
  return (
    <section className="relative h-svh overflow-hidden bg-[#1a1a1a]">
      <CursorTrailReveal images={trailImages} maskColor="#1a1a1a" />

      <div className="relative z-[1] flex h-svh items-center justify-center">
        <TextRevealBlock animateOnScroll={false} blockColor="#c8e600">
          <h1>Your copy on top</h1>
        </TextRevealBlock>
      </div>
    </section>
  );
}

Images spawn only while the pointer moves inside the trail container and travels at least mouseThreshold pixels since the last spawn. URLs are cycled in order; when the list ends, it starts again from the first image.

Use the preview panel for the full contact-page demo with sample trail images.

Props

PropTypeDefault
images?
readonly string[]
-
maskColor?
string
"var(--background, #1a1a1a)"
imageSize?
number
175
mouseThreshold?
number
150
desktopBreakpoint?
number
1000
layout?
"default" | "fill"
"default"
className?
string
-

Accessibility

The trail is a pointer-driven visual effect and does not change keyboard navigation, tab order, or underlying DOM accessibility. Screen readers and keyboard users interact with the page content normally.

Text Reveal Box

Scroll-pinned word-by-word text reveal with a highlight flash, powered by GSAP ScrollTrigger.

Built by Axyl. A motion-first component registry for React.

Loading preview...