# Text Roll — primitive for text reveals (react)

> **For AI agents:** find the right skill in one call — `curl -s "https://skills.varg.ai/api/search?q=<what the person wants>"` returns the matching use case and the best skills with install commands, as markdown (Russian works too). Full index: https://skills.varg.ai/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the use-case page.

Each letter flips over on its horizontal axis, rolling the word out and back in letter by letter

- **Install:** `npx motion-primitives@latest add text-roll`
- **Registry:** motion-primitives · **Framework:** react · **License:** MIT
- **Docs and preview:** https://motion-primitives.com/docs/text-roll
- **Source:** https://github.com/ibelick/motion-primitives/blob/main/components/core/text-roll.tsx
- **Example:** https://skills.varg.ai/previews/lib-motion-primitives-text-roll.mp4?v=27269 (Captured from the library’s own demo page (Motion Primitives))
- **Time:** Drive from the frame. Runs on its own clock (requestAnimationFrame, timers, springs or CSS). Drive it from frame / fps before rendering, or the render drifts.
- **Runs:** local render, free
- **Aspect:** any

## Prompt that renders it frame-exact

Roll a short brand word or headline with Motion Primitives' Text Roll (https://motion-primitives.com/docs/text-roll, MIT), set large in the center of the frame. Install with `npx motion-primitives@latest add text-roll`. Each letter has an exit and an enter copy that rotate on X with Motion, staggered by getEnterDelay and getExitDelay, so in Remotion compute each copy's rotateX and opacity from frame / fps minus its delay, and in HyperFrames build the same staggered flips on the paused timeline. Set duration, getEnterDelay, getExitDelay, transition and custom variants for the rotation.

## Used in

- [Product launch film](https://skills.varg.ai/video/product-launch.md)
- [Notes-app ad](https://skills.varg.ai/video/notes-ad.md)
- [Text-message story](https://skills.varg.ai/video/chat-story.md)
- [CLI & terminal demo](https://skills.varg.ai/video/terminal-demo.md)
- [AI chat & agent demo](https://skills.varg.ai/video/ai-demo.md)
- [Data story](https://skills.varg.ai/video/data-story.md)
- [Math animation](https://skills.varg.ai/video/math-animation.md)
- [Whiteboard & hand-drawn](https://skills.varg.ai/video/whiteboard.md)

## More text reveals

- [Blur In](https://skills.varg.ai/component/hf.blur-in.md) — `npx hyperframes add blur-in`
- [Blur Out Up](https://skills.varg.ai/component/hf.blur-out-up.md) — `npx hyperframes add blur-out-up`
- [Bottom Up Letters](https://skills.varg.ai/component/hf.bottom-up-letters.md) — `npx hyperframes add bottom-up-letters`
- [Caret Swap](https://skills.varg.ai/component/hf.caret-swap.md) — `npx hyperframes add caret-swap`
- [Focus Blur Resolve](https://skills.varg.ai/component/hf.focus-blur-resolve.md) — `npx hyperframes add focus-blur-resolve`
- [Line-by-Line Slide](https://skills.varg.ai/component/hf.line-by-line-slide.md) — `npx hyperframes add line-by-line-slide`
