# vertical-spring-ticker

vertical-spring-ticker is a rule for Claude Code and Codex that defines a slot-machine vertical ticker with additive GSAP spring physics. Each spring advances the stack one discrete step instead of a smooth scroll.

- 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/vertical-spring-ticker.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/vertical-spring-ticker

## What it does

The rule targets Claude Code and Codex. It gives the agent a complete blueprint: a fixed-height container with `overflow: hidden`, a vertical stack inside, and a transform computed as `translateY = -ITEM_HEIGHT * sum(spring.progress)`. Several spring objects accumulate into one step-counter — the agent follows this exact pattern rather than inventing its own.

The structure covers HTML slots `{item0}…{itemN}`, CSS where `.ticker` and `.item` heights must be identical (a mismatch lets the adjacent item bleed past the mask), and a GSAP timeline firing each spring with `back.out(BOUNCE_FACTOR)`. The relationship between `STEP_SPACING` and `STEP_DUR` matters: if spacing exceeds duration, springs stop overlapping and the additive effect disappears — the ticker degrades into a plain sequential scroll.

The rule also documents every tuneable constant: `STEPS` controls how many clicks occur, `BOUNCE_FACTOR` ranges from a polished 1.4 to a game-show 2.5+, and `BRAND_DELAY` sets the gap before the footer line fades in after the final step.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/rules/vertical-spring-ticker.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/vertical-spring-ticker.mdc` — Frontmatter: description, globs, alwaysApply

### GitHub Copilot

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/vertical-spring-ticker.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/vertical-spring-ticker.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/vertical-spring-ticker.md

## When to use it
- build a slot-machine-style vertical ticker with spring physics
- set up an additive GSAP timeline where multiple springs combine into one transform
- configure the masked container so off-screen items do not bleed past the clip
- sequence several ticker states with individually tuned overshoot per step
- reveal a footer element after the last ticker click has settled

## Example prompts
- Build a slot-machine ticker with three clicks, `ITEM_HEIGHT` 120px, and `BOUNCE_FACTOR` 2.0
- Add a spring ticker with five slots and a `BRAND_DELAY` of 0.3s before the footer appears
- Generate the ticker following the `vertical-spring-ticker` rule: two steps, `STEP_DUR` 0.45, `STEP_SPACING` 0.4

## Similar
- [pixijs-ticker](https://affpapa.org/en/nevibecode/skills/pixijs-ticker.md) — skill · 7000 installs
- [scroll-scrubbed-word-reveal](https://affpapa.org/en/nevibecode/skills/scroll-scrubbed-word-reveal.md) — skill · 1800 installs
- [react-spring-physics](https://affpapa.org/en/nevibecode/plugins/react-spring-physics.md) — plugin · ★ 1428 repo stars
- [gsap-scrolltrigger-generate_animation](https://affpapa.org/en/nevibecode/commands/gsap-scrolltrigger-generate-animation.md) — command · ★ 1428 repo stars
- [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

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
