Scroll Reveal Text, animated React component
A paragraph that reads itself as you scroll: each word, character or line rises out of a blur and passes through the accent colour on its way from grey to ink, so a bright reading wave travels through the text. Scroll progress is smoothed by a spring, and it can track the page or any scrollable container.
- Free
- Motion Effects
- Scroll
- Spring
Like Scroll Reveal Text? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Scroll Reveal Text stays free.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
We design tools that people actually want to open every single morning.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| text | string | — | The text to reveal. In line mode, \n separates lines. |
| mode | "word" | "character" | "line" | "word" | Granularity of each reveal step. |
| as | "p" | "h2" | "h3" | "div" | "p" | Root element. |
| mutedColor | string | — | Colour of unread text. Defaults to #d2d2d7 (#3a3a3c in dark mode). |
| accentColor | string | — | Colour text passes through while revealing. Defaults to #0071e3 (#0a84ff in dark mode). |
| activeColor | string | — | Colour of revealed text. Defaults to #1d1d1f (#f5f5f7 in dark mode). |
| startOffset | number | 0.05 | Scroll progress (0 entering, 1 leaving) where the reveal begins. |
| endOffset | number | 0.75 | Scroll progress where the reveal is complete. |
| blurAmount | number | 6 | Starting blur in px. 0 turns it off. |
| stagger | number | 0.65 | 0 reveals everything together, 1 strictly one unit after another. |
| fontSize | string | "clamp(1.75rem, 4.5vw, 3.75rem)" | CSS font-size. |
| align | "left" | "center" | "right" | "left" | Text alignment. |
| container | RefObject<HTMLElement | null> | — | Scrollable ancestor to track instead of the page. Give it position: relative. |
| className | string | — | Classes for the root element. |
| autoplay | boolean | false | Plays the reveal on a loop until someone scrolls. With a container it scrolls the container itself, so handing over is seamless. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry
Run this once per project. It writes the Nexus UI entry into
components.jsonfor you:npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"Type it exactly as shown.
{name}is filled in by the CLI with the component you ask for, so you never replace it.
- 3
Add the component
Run this from your project root. It adds the component, the helpers it imports and its npm packages.
npx shadcn@latest add @nexus-labs/scroll-reveal-text
- 4
Check what was added
With a project made as in the Quick Start (a
src/folder), these files land in it:components/scroll-reveal-text/index.tsscroll-reveal-text.tsx - 5
Copying by hand? Skip the registry
Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that
cn()exists. Install the packages:npm install framer-motion
Then show the source and create each file at the path it gives:
- 6
Use it in a page
Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:
// src/app/page.tsx import { ScrollRevealText } from "@/components/scroll-reveal-text"; export default function Page() { return ( <main> <ScrollRevealText /> </main> ); }
Like Scroll Reveal Text? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Scroll Reveal Text stays free.
About Scroll Reveal Text
Scroll Reveal Text is a scroll-driven word illumination effect where words in a paragraph brighten sequentially as the user scrolls through the section. Words start in a muted state and transition to full opacity as the scroll progress advances through each word's position in the text. Built with Framer Motion useScroll and useTransform, the effect creates a reading-pace animation that ties content reveal directly to user attention. Best for mission statements, product stories, and feature descriptions.
Good for
- Mission statements and manifesto sections
- Feature and product story descriptions
- Hero section subheading reveals
- Scroll-driven marketing copy animations
Scroll Reveal Text questions
How do I install scroll reveal text?
Run `npx shadcn@latest add @nexus-labs/scroll-reveal-text`. It adds the ScrollRevealText component and installs framer-motion.
Can it reveal by word, character or line?
Yes. Set `mode` to "word" (default), "character" or "line"; in line mode, separate lines with ` ` in `text`.
How do I control when the reveal starts and ends?
`startOffset` and `endOffset` (0–1, defaults 0.05 and 0.75) set where in the element's scroll progress the reveal runs. `stagger` goes from 0 (all units at once) to 1 (fully one after another), and `blurAmount` sets the starting blur in pixels.
Does it respect reduced motion?
Yes. With prefers-reduced-motion on, the text renders in `activeColor` with no scroll-linked animation.