Communitygithub.com

scroll-motion

Añade animaciones impulsadas por desplazamiento y de entrada a un sitio web con GSAP, ScrollTrigger y Lenis, incluyendo revelaciones, paralaje, secciones fijadas, desplazamiento horizontal, dibujo de líneas, contadores y precargadores.

¿Qué es scroll-motion?

La habilidad scroll-motion proporciona un conjunto completo de herramientas para crear animaciones web fluidas y de alto impacto visual, impulsadas por desplazamiento, utilizando las bibliotecas GSAP, ScrollTrigger y Lenis. Está diseñada para desarrolladores que buscan dar a sus sitios una sensación 'premium', implementando efectos como revelaciones de texto, paralaje, secciones fijadas (pinned), desplazamiento horizontal, dibujo de líneas, contadores animados y precargadores. La habilidad enfatiza un enfoque responsable del rendimiento y la accesibilidad, recomendando animar solo propiedades 'transform' y 'opacity', respetando la preferencia del usuario por movimiento reducido y limitando los efectos visuales destacados a uno por página. Se integra fácilmente en cualquier proyecto web mediante la inclusión de scripts CDN y proporciona fragmentos de código listos para copiar en un archivo de referencia ('references/snippets.md'), junto con reglas claras sobre duraciones, easing y configuración para dispositivos móviles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/scroll-motion

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Movimiento de desplazamiento (Scroll motion)

El movimiento debe explicar la estructura: qué es nuevo, qué va junto, a qué mirar a continuación. La animación que no hace nada de esto es decoración y cuesta rendimiento, por lo que cada efecto a continuación está vinculado a un propósito.

Configuración

<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>

defer evita que los scripts bloqueen el primer pintado y aún así los ejecuta en orden, de modo que main.js (el código a continuación) ve gsap. Para producción, fija versiones exactas ([email protected]) o aloja los archivos localmente.

gsap.registerPlugin(ScrollTrigger);

const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
  const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
  lenis.on("scroll", ScrollTrigger.update);
  gsap.ticker.add((t) => lenis.raf(t * 1000));
  gsap.ticker.lagSmoothing(0);
}

Envuelve cada animación en if (!reduce) o usa gsap.matchMedia(). Las personas con trastornos vestibulares establecen esa preferencia por una razón, y el contenido debe ser completamente visible sin movimiento.

Elección de un efecto

PropósitoEfectoSección de referencia
Anunciar una nueva secciónRevelación de titular con máscaraRevelaciones
Mostrar que los elementos van juntosAparición escalonada con desvanecimientoRevelaciones
Añadir profundidad a las imágenesParalaje, revelación con clip-pathImágenes
Contar una secuenciaPasos fijados, línea dibujadaFijación
Mostrar un rango de trabajoDesplazamiento horizontalFijación
Enfatizar un númeroContador ascendenteDetalles
Cubrir la carga inicialPrecargadorDetalles

El código listo para copiar de cada uno está en references/snippets.md. Léelo cuando estés a punto de implementar un efecto; no lo necesitas para planificar.

Reglas internas

  • Anima solo transform y opacity. Animar top, width, margin o box-shadow desencadena un nuevo layout o pintado en cada cuadro y causa tirones en teléfonos de gama media.
  • Duraciones: De 0.6 a 1.0s para revelaciones, de 0.2 a 0.3s para hovers. Las más largas se sienten lentas en la segunda visita.
  • Easing: power3.out para entradas, power2.inOut para transiciones, none para animaciones sincronizadas con desplazamiento (scrub aporta el easing).
  • Escalonado (stagger): De 0.06 a 0.12s. Limita el total: con 12 tarjetas, escalona las primeras 6 y agrupa el resto.
  • Reproducir una vez. Usa once: true o toggleActions: "play none none none". Re-animar en cada desplazamiento hacia atrás es agotador.
  • Una pieza central por página. Una sección fijada o de desplazamiento horizontal es memorable una vez y agotadora tres veces.
  • Establece el estado inicial en JS, no en CSS. Si el script falla al cargar, el contenido oculto por CSS permanece oculto para siempre.
  • Actualizar después de cambios de layout: llama a ScrollTrigger.refresh() después de que las fuentes y las imágenes se carguen, o las posiciones de los disparadores se desviarán.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());

Móvil

  • Desactiva la fijación y el desplazamiento horizontal por debajo de 768px con gsap.matchMedia(); apila el contenido normalmente.
  • El desplazamiento suave de Lenis en pantallas táctiles a menudo entra en conflicto con el impulso nativo. Deja el desplazamiento táctil nativo (el valor predeterminado) a menos que la persona insista.
  • Reduce a la mitad las distancias de paralaje en pantallas pequeñas.

Depuración

  • Añade markers: true a un ScrollTrigger para ver las líneas de inicio y fin.
  • Los saltos al inicio de una fijación generalmente significan que el elemento fijado tiene un padre con transform o una altura cambiante.
  • La animación se dispara demasiado pronto: las imágenes que están encima cargaron tarde. Establece width y height explícitos en las imágenes.
  • No se anima nada: verifica que el plugin esté registrado y que el selector coincida.

Sin GSAP

Para simples apariciones con desvanecimiento en un sitio pequeño, un IntersectionObserver que añade una clase más una transición CSS es suficiente y ahorra unos 70 KB. Consulta la última sección de references/snippets.md.

Individual skills in this repo

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

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Skills relacionados