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/Circle Text Reveal

Circle Text Reveal

A full-screen hover reveal where a circular mask follows the cursor and uncovers a second, hidden line of text in a contrasting colour, growing larger while the pointer is over the text.

Motion
DemoDemoDemo

Tune the Real Props

Text Color

Base text color.

Circle Color Bg

Reveal circle background color.

Revealed Text Color

Text color inside the revealed layer.

Overview

Circle Text Reveal hides a second line beneath a headline: a small circle trails the cursor across a full-screen section, and when the pointer moves over the text it expands to show the hidden line in a contrasting colour on a solid fill.

Best on a short pair of high-emphasis lines: a statement and its twist, a question and its answer. Both lines are hard-coded in the component, so edit them in the source; there is no text prop. Avoid it for body copy, errors, legal text, or instructions, where legibility cannot be negotiable.

The main risk is putting essential content in the hidden line: it only appears for a fine pointer after the cursor first moves, so touch users never see it. Keep the visible line self-sufficient, and note that with reduced motion the circle still follows the cursor, simply snapping to it without lag or easing.


Usage Code

page
1import CircleTextReveal from '@/components/effects/circle-text-reveal'2 3const page = () => {4 return (5 <>6 <div className="relative">7 <CircleTextReveal8 textColor="#111"9 circleColorBg="#ff5f00"10 RevealedTextColor="#ffffff"11 />12 </div>13 </>14 )15}16 17 18export default page

Example Production Use Case

An art gallery's exhibition microsite can use Circle Text Reveal on the opening statement. A circle follows the visitor's cursor and uncovers a second line hidden beneath the first, so the page rewards curiosity in the same way the exhibition does.

The outcome is discovery. Because the reveal depends on a mouse, it works best as a desktop moment. On touch devices the main statement still reads in full and, below the large breakpoint, a short prompt suggests opening the page on desktop; opening hours, tickets, and directions belong in ordinary text elsewhere on the page.


Best Used For

  • Campaign moments where the circular mask is part of the art direction.
  • Short statements that read fully on their own, with the hidden line as a bonus rather than a requirement.
  • Desktop hero sections where a cursor-driven reveal rewards visitors who explore, while the main line stays a real, indexable h1.

Not For

Avoid it on body copy, labels, error and legal text, or any wording that has to be read on sight.


Performance Budget

The circle is a CSS mask moved by a requestAnimationFrame loop that pauses when the tab is hidden or the section is offscreen. Pointer position is held in React state, so each mouse move re-renders the component; keep it free of heavy children and use one instance per page.


Accessibility and Mobile

Both lines are whole, unsplit headings, so assistive technology hears each phrase once; the revealed line only renders for fine pointers after the cursor first moves.


Common Mistakes

  • Using Circle Text Reveal on long body copy.
  • Removing the readable text from the DOM.
  • Putting information only in the hidden line, which touch users never see.

Changelog

Added reduced motion support.
Initial release

API Reference

PropTypeDefaultDescription
textColorstring#111111Base text color.
circleColorBgstring#ff5f00Reveal circle background color.
RevealedTextColorstring#fefefeText color inside the revealed layer.
lerpnumber0.15Pointer-follow smoothing amount; higher values track faster.
smoothnessnumber0.5Mask-size transition duration in seconds.
circleSizenumber500Expanded reveal circle size in pixels.

Questions, Answered.

When should I use Circle Text Reveal?

Use it on a desktop-focused hero where a circle following the cursor should uncover a second, hidden line beneath the main statement.

How do I keep Circle Text Reveal accessible?

Both lines are whole headings with no split characters, so screen readers hear each phrase once. The hidden line only renders for fine pointers after the first mouse move, so keep the visible line meaningful on its own and check the colour contrast of both text colours against their backgrounds.

Does Circle Text Reveal affect SEO?

The main line is a real h1 in the rendered HTML, so it is indexable. The hidden line is an h2 that only renders on the client after the first mouse move, so do not rely on it for anything search engines need to see.

How do I avoid layout shift with Circle Text Reveal?

The component does not shift layout: it fills the viewport, the visible line is static, and the revealed layer is absolutely positioned over it. Text is sized in vw, so check wrapping at narrow widths.

What should reduced motion do for Circle Text Reveal?

Circle Text Reveal stays cursor-driven with reduced motion: the circle snaps to the pointer with no lag or easing, and nothing animates on its own.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Split Canvas
GSAP Three.jsLenis

Split Canvas

Scroll

Circular Split Roll
GSAPLenis

Circular Split Roll

Scroll

Helix Slider
Pro
Three.js@react-three/fiber

Helix Slider

Scroll

Parallax Image
Pro
GSAP

Parallax Image

Scroll

Sticky Content Wrapper
GSAPLenis

Sticky Content Wrapper

Scroll