Scroll Reveal Heading
Freev1.0.0A section heading that animates once when it scrolls into view.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { ScrollRevealHeading } from "@/components/ui/notchset/scroll-reveal-heading";
export function ScrollRevealHeadingExample() {
return (
<ScrollRevealHeading eyebrow="RELEASE NOTES" lines={["EVERY DEPLOY", "IS MEASURED"]}>Body copy.</ScrollRevealHeading>
);
}Props
lines–string[]Explicit lines.
eyebrow–ReactNodeA mono line above.
children–ReactNodeBody copy under it.
once / threshold–boolean / numberPlay once (default) at 60% visible.
replayKey–numberChange it to replay.
Anatomy
- Uses Text Reveal's headline type.
- No primitive needed: one file serves both builds.
- Fires once by default, then disconnects.
ScrollRevealHeadingdata-slot="scroll-reveal-heading"The title block.
Source
components/ui/notchset/scroll-reveal-heading.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/scroll-reveal-heading.jsonRadix
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/radix-nova/scroll-reveal-heading.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @beautiful-ui registry added, @beautiful-ui/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/scroll-reveal-heading.tsx
- components/ui/notchset/text-reveal.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), Text Reveal, the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Section headings on long pages: release notes, changelogs, marketing
Use something else when
- Above the fold: use Text Reveal on mount
Mistakes to avoid
- Give each line its own string; lines never wrap
Agents find it by
- in view title, scroll reveal, section heading, intersection observer, release notes heading, Notchset
Where agents read it
- Guide for this component: https://beautiful-ui.dev/md/scroll-reveal-heading.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://beautiful-ui.dev/api/mcp(setup)
Behaviour
Keyboard
- —
- Not interactive
Accessibility
- The heading carries the full title as its label
- Reduced motion shows everything at once
Motion
- Baselines
- Trace in (420ms), 140ms a line, then cool from ink to rule (500ms, +900ms)
- Words
- Rise from 110% (680ms), +220ms after their line, 55ms apart
- Body
- Fades and settles 8px (+820ms)
Responsive
- Size the title to fit its column.
Performance
- One IntersectionObserver, disconnected after it fires.
Changelog
v1.0.0 · 2026-10-02
First release
