Communitygithub.com

rbrown101010/codex-marketing-skills

Referência de animação GSAP para composições HyperFrames. Aborda gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), parâmetro de posição, rótulos, aninhamento, reprodução) e performance (transformações, will-change, quickTo). Use ao escrever animações GSAP em composições HyperFrames.

O que é codex-marketing-skills?

Este skill é uma referência abrangente de animação GSAP projetada especificamente para o ecossistema HyperFrames. Ele resume os métodos centrais de animação (gsap.to, from, fromTo e set), detalha uma ampla gama de propriedades comuns como duração, easing, stagger e callbacks, e explica as melhores práticas para trabalhar com transformações CSS (como x, y, scale, rotation) e autoAlpha como alternativa à opacidade. O documento também aprofunda o uso de timelines com parâmetro de posição, rótulos e aninhamento, facilitando a criação de sequências complexas. Além disso, aborda estratégias de performance – como preferir transformações e opacidade, utilizar gsap.quickTo() para atualizações frequentes e empregar stagger em vez de múltiplos tweens manuais – e fornece orientações sobre acessibilidade com gsap.matchMedia(). O recurso é voltado para desenvolvedores que utilizam agentes de IA como Claude Code, Cursor ou Codex, e inclui referências a efeitos prontos (typewriter, visualizador de áudio) em arquivo auxiliar. Por priorizar boas práticas e evitar armadilhas comuns (como animar propriedades de layout ou ignorar a limpeza de tweens), ele se torna uma fonte confiável para gerar animações performáticas e manuteníveis dentro de HyperFrames.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/hyperframes-gsap

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

GSAP

Métodos Principais de Tween

  • gsap.to(targets, vars) — anima do estado atual para vars. Mais comum.
  • gsap.from(targets, vars) — anima de vars para o estado atual (entradas).
  • gsap.fromTo(targets, fromVars, toVars) — início e fim explícitos.
  • gsap.set(targets, vars) — aplica imediatamente (duração 0).

Sempre use nomes de propriedades em camelCase (ex.: backgroundColor, rotationX).

Propriedades Comuns (vars)

  • duration — segundos (padrão 0.5).
  • delay — segundos antes do início.
  • ease — "power1.out" (padrão), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — número 0.1 ou objeto: { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (padrão), true ou "auto".
  • repeat — número ou -1 para infinito. yoyo — alterna direção com repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — padrão true para from()/fromTo(). Defina como false em tweens posteriores que visam a mesma propriedade+elemento para evitar sobrescrita.

Transformações e CSS

Prefira os atalhos de transformação do GSAP em vez da string transform bruta:

Propriedade GSAPEquivalente
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y em %
scale, scaleX, scaleYscale
rotationrotate (graus)
rotationX, rotationYrotate 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — prefira em vez de opacity. Em 0: também define visibility: hidden.
  • Variáveis CSS — "--hue": 180.
  • svgOrigin (apenas SVG) — origem no espaço de coordenadas global do SVG. Não combine com transformOrigin.
  • Rotação direcional — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" ou separado por vírgulas; remove estilos inline ao finalizar.
  • Valores relativos — "+=20", "-=10", "*=2".

Valores Baseados em Função

gsap.to(".item", {
  x: (i, target, targets) => i * 50,
  stagger: 0.1,
});

Easing

Eases nativos: power1–power4, back, bounce, circ, elastic, expo, sine. Cada um possui .in, .out, .inOut.

Defaults

gsap.defaults({ duration: 0.6, ease: "power2.out" });

Controlando Tweens

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia() (Responsivo + Acessibilidade)

Executa a configuração apenas quando uma media query corresponde; reverte automaticamente quando deixa de corresponder.

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (context) => {
    const { isDesktop, reduceMotion } = context.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

Timelines

Criando uma Timeline

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

Parâmetro de Posição

O terceiro argumento controla o posicionamento:

  • Absoluto: 1 — em 1s
  • Relativo: "+=0.5" — após o fim; "-=0.2" — antes do fim
  • Rótulo: "intro", "intro+=0.3"
  • Alinhamento: "<" — mesmo início do anterior; ">" — após o anterior terminar; "<0.2" — 0.2s após o início do anterior
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // mesmo início que .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0.2s após .b iniciar

Rótulos

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

Opções da Timeline

  • paused: true — cria pausada; chame .play() para iniciar.
  • repeat, yoyo — aplica-se a toda a timeline.
  • defaults — vars mescladas a cada tween filho.

Aninhando Timelines

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

Controle de Reprodução

tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().


Performance

Prefira Transformação e Opacidade

Animar x, y, scale, rotation, opacity permanece no compositor. Evite width, height, top, left quando transformações alcançam o mesmo efeito.

will-change

will-change: transform;

Apenas em elementos que realmente animam.

gsap.quickTo() para Atualizações Frequentes

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

Stagger > Muitos Tweens

Use stagger em vez de tweens separados com delays manuais.

Limpeza

Pause ou mate animações fora da tela.


Referências (carregadas sob demanda)

  • references/effects.md — Efeitos prontos: texto typewriter, visualizador de áudio. Leia quando precisar de padrões de efeito prontos para HyperFrames.

Melhores Práticas

  • Use nomes de propriedades em camelCase; prefira atalhos de transformação e autoAlpha.
  • Prefira timelines em vez de encadeamento com delay; use o parâmetro de posição.
  • Adicione rótulos com addLabel() para sequenciamento legível.
  • Passe defaults no construtor da timeline.
  • Armazene o valor de retorno do tween/timeline ao controlar a reprodução.

Não Faça

  • Animação de propriedades de layout (width/height/top/left) quando transformações forem suficientes.
  • Use svgOrigin e transformOrigin no mesmo elemento SVG.
  • Encadeie animações com delay quando uma timeline pode sequenciá-las.
  • Crie tweens antes do DOM existir.
  • Pule a limpeza — sempre mate tweens quando não forem mais necessários.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas