# gsap-effects

gsap-effects — a rule with drop-in GSAP patterns for HyperFrames: typewriter text and an audio visualizer driven by the timeline. Useful when the agent renders videos frame by frame with deterministic output.

- rule · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/gsap-effects.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/rules/gsap-effects

## What it does

The rule covers two self-contained effects. Typewriter reveals text character by character, with options for a blinking cursor, backspacing, word rotation, and multi-line handoff. Audio visualizer takes pre-extracted audio data and pushes Canvas or DOM rendering through timeline calls.

Both effects obey a seek-driven contract: every animation is deterministic and the timeline is registered on `window.__timelines`. No randomness is allowed. The visualizer section warns against Web Audio API at render time because there is no playback when the timeline seeks. Instead, run the bundled Python extractor ahead of time — it needs `ffmpeg` and `numpy`. Load the resulting JSON synchronously; an async `fetch()` would leave the timeline unbuilt when HyperFrames reads it right after page load.

The typewriter part gets into details that break easily. Backspace needs manual substring removal because TextPlugin deletes from the front. A cursor must blink when idle and go solid while typing. Next to static text, use `margin-left` on a wrapper span rather than flex `gap`, which would push the cursor away.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/rules/gsap-effects.md` — The paths frontmatter field limits the files

### Codex

**AGENTS.md**
- Codex reads AGENTS.md: paste the rule text there

### Cursor

**Manually: put the files in place**
- File: `.cursor/rules/gsap-effects.mdc` — Frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/instructions/gsap-effects.instructions.md` — The applyTo field sets which files it applies to

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/gsap-effects.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/gsap-effects.md`

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/gsap-effects.md

## When to use it
- Reveal text character by character with a blinking cursor
- Drive an audio visualizer from the timeline without Web Audio API
- Extract RMS and frequency bands from mp3 or mp4 files
- Build a deterministic timeline that survives seeking
- Hand a cursor off between typewriter lines

## Example prompts
- Add a typewriter effect with a blinking cursor to this HyperFrames scene
- Set up word rotation with typing, holding, backspacing, and the next word
- Extract audio data from video.mp4 and hook a Canvas visualizer into the timeline

## Similar
- [gsap](https://affpapa.org/en/nevibecode/skills/gsap.md) — skill · 3 installs
- [gsap-plugins](https://affpapa.org/en/nevibecode/skills/gsap-plugins.md) — skill · 81000 installs
- [gsap-utils](https://affpapa.org/en/nevibecode/skills/gsap-utils.md) — skill · 78400 installs
- [gsap-react](https://affpapa.org/en/nevibecode/skills/bbeierle12-gsap-react.md) — skill · 728 installs
- [hyperframes](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes.md) — skill · 1600000 installs
- [gsap-router](https://affpapa.org/en/nevibecode/skills/gsap-router.md) — skill · 102 installs

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
