
Split Canvas
Scroll
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.
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.
import CircleTextReveal from '@/components/effects/circle-text-reveal' const page = () => { return ( <> <div className="relative"> <CircleTextReveal textColor="#111" circleColorBg="#ff5f00" RevealedTextColor="#ffffff" /> </div> </> )} export default pageAn 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.
Avoid it on body copy, labels, error and legal text, or any wording that has to be read on sight.
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.
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.
| Prop | Type | Default | Description |
|---|---|---|---|
textColor | string | #111111 | Base text color. |
circleColorBg | string | #ff5f00 | Reveal circle background color. |
RevealedTextColor | string | #fefefe | Text color inside the revealed layer. |
lerp | number | 0.15 | Pointer-follow smoothing amount; higher values track faster. |
smoothness | number | 0.5 | Mask-size transition duration in seconds. |
circleSize | number | 500 | Expanded reveal circle size in pixels. |
Use it on a desktop-focused hero where a circle following the cursor should uncover a second, hidden line beneath the main statement.
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.
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.
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.
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.
Need a custom effect? Tell us what to create.