vertical-spring-ticker — Claude Code rule: what it does
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.
AGPL-3.0 ★ 78,316 updated 2026-10-24
.claude/rules/vertical-spring-ticker.mdWhat vertical-spring-ticker 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.
What it helps with
- 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 for the agent
- Build a slot-machine ticker with three clicks,
ITEM_HEIGHT120px, andBOUNCE_FACTOR2.0 - Add a spring ticker with five slots and a
BRAND_DELAYof 0.3s before the footer appears - Generate the ticker following the
vertical-spring-tickerrule: two steps,STEP_DUR0.45,STEP_SPACING0.4
How to install vertical-spring-ticker
Manually: put the files in place
.claude/rules/vertical-spring-ticker.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/vertical-spring-ticker.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/vertical-spring-ticker.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/vertical-spring-ticker.mdManually: put the files in place
.clinerules/vertical-spring-ticker.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about vertical-spring-ticker
How do I install vertical-spring-ticker in Claude Code?
Place the rule file at .claude/rules/vertical-spring-ticker.md in your project root. Claude Code picks it up from there automatically.
What does the vertical-spring-ticker rule do?
It tells the agent how to build a vertical ticker: the HTML slot structure, masked-container CSS, and a GSAP timeline where additive springs produce one discrete scroll step each.
What is the constraint between STEP_SPACING and STEP_DUR?
STEP_SPACING must be less than or equal to STEP_DUR. When spacing exceeds duration the springs no longer overlap, the additive accumulation breaks, and the result looks like an ordinary sequential scroll rather than a slot machine.