Communitygithub.com

FrontLaxWeb

Diseño de parallax, scroll interactivo, micro-interacciones y gestos premium para landings y webs, tanto en React (Motion + Lenis) como en HTML/CSS/JS puro (GSAP + Lenis).

¿Qué es FrontLaxWeb?

FrontLaxWeb es un skill para Claude Code, Cursor, Codex y otros asistentes de IA que convierte landing pages comunes en experiencias web premium dirigidas por scroll, puntero y gestos táctiles. Sigue una filosofía 'todo para todos' donde las animaciones nunca se desactivan, sino que reducen su amplitud mediante un dial CSS (`--motion-gain`). Soporta React (Motion + Lenis) y HTML/CSS/JS puro (GSAP + Lenis), e incluye un modo ligero automático para equipos sin aceleración gráfica (software rendering). El skill cubre siete efectos clave (smooth scroll, parallax, scroll-linked animation, scroll-reveal, sticky/pin, micro-interacciones de puntero y gestos con springs), y destila los principios de diseño de Apple (interrumpibilidad, traspaso de velocidad, rubber-banding) en recetas prácticas. La política de movimiento obligatoria (`?motion=off`, `?motion=full`, respeto a `prefers-reduced-motion: reduce`) garantiza accesibilidad real, y todo el código está optimizado para 60fps incluso sin GPU.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mun1to/FrontLaxWeb/tree/main

Preguntar en tu IA favorita

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

Documentación

FrontLaxWeb: parallax y scroll interactivo premium

Este archivo es el "cerebro": el método. Las recetas y los snippets viven en plantillas/ y se leen bajo demanda. Las rutas plantillas/, references/, Designs/ y Components/ son relativas a la carpeta de este archivo.

Qué logra este skill

Convertir una landing normal en una web-experiencia: el scroll y el puntero se vuelven el mando de una animación continua. Marca-agnóstico: recibe los colores/tokens de cada proyecto.

Los 7 efectos (el catálogo)

  1. Smooth scroll (cimiento): Lenis. Base de que todo se sienta premium.
  2. Parallax de capas: fondos lentos / frente rápido = profundidad.
  3. Scroll-linked animation: propiedades atadas al % de scroll.
  4. Scroll-reveal: entrar/animar al aparecer en viewport.
  5. Sticky / pin: algo se "pega" mientras cambia lo de alrededor (stacking cards).
  6. Micro-interacciones de puntero: tilt 3D, cursor custom, hover.
  7. Gestos con springs: arrastrar, soltar, tap: física de resorte interrumpible en vez de transiciones CSS de duración fija. Ver sección propia abajo.

Gestos y springs (fusionado del skill apple-design de Emil Kowalski, WWDC destilado)

Terreno DISTINTO al scroll/parallax de arriba: es la física de tocar y arrastrar algo (un menú, una tarjeta deslizable, un modal, un slider). Los principios más accionables para web (de los 17 originales; el resumen vive en references/recetas-y-matriz.md §4bis):

  • Interrumpibilidad, el más importante de los 17: cualquier animación debe poder agarrarse y redirigirse a media transición. Para todo lo que el usuario pueda TOCAR, usar springs (parámetros: damping/amortiguación + response/velocidad), nunca transition CSS de duración fija: un spring siempre sabe animar desde su posición ACTUAL, una transición fija no.
  • Traspaso de velocidad: al soltar un gesto, la animación sigue a la velocidad del dedo (no arranca de cero), y así evita la "costura" visual. En Motion: dragMomentum + velocity del PanInfo como velocidad inicial del spring.
  • Rubber-banding: en un límite, resistencia progresiva, nunca un tope seco.
  • Consistencia espacial: un panel que entra desde la derecha sale hacia la derecha; ancla el origen (transform-origin) al elemento que disparó la transición.
  • Materiales y profundidad: capas translúcidas flotantes (backdrop-filter: blur()) para jerarquía visual, nunca dos superficies translúcidas apiladas directamente. Sin tarjeta gráfica el modo ligero les quita el desenfoque: su fondo semitransparente tiene que leerse bien solo.
  • Confirmación cruzada (no receta nueva): su regla "Frame-Level Smoothness" es la MISMA que ya teníamos en Cimientos NO negociables (solo transform/opacity): dos fuentes independientes llegan a la misma regla, más confianza en ella.
  • Filosofía de fondo (los 8 fundamentos de Apple): Propósito, Agencia, Responsabilidad, Familiaridad, Flexibilidad, Simplicidad, Oficio, Deleite (consecuencia de acertar los 7 anteriores). Es ethos, no una técnica que se implemente: úsalo para justificar decisiones de diseño ("¿esto tiene propósito o es ruido?"), no como checklist técnico.

✅ Tensión resuelta. El principio #14 de Apple (con prefers-reduced-motion: reduce, sustituir el movimiento por fundidos de opacidad) chocaba de frente con la política de la casa ("todo para todos", ignorar esa preferencia). Ganó una tercera vía: el movimiento no se apaga, se le baja la amplitud. El principio 14 no queda descartado ni copiado: queda incorporado como el caso extremo del mismo dial (--motion-gain: 0 produce justamente una web de solo fundidos), así que no hay dos versiones de cada efecto que mantener. La mecánica completa está en "Política de movimiento de la casa" (sección propia, abajo).

Cimientos NO negociables

  • Rendimiento: animar SOLO transform y opacity (GPU). Nunca top/left/width/height/margin. Usar will-change con criterio, requestAnimationFrame, y evitar layout thrashing.
  • Sin tarjeta gráfica, modo ligero: toda web nace con la detección del dibujo por software y su modo ligero (sin Lenis, sin desenfoques ni mezclas, 3D con su versión sin 3D). Sección propia abajo.
  • Política de movimiento de la casa: OBLIGATORIA en todo proyecto. Tiene sección propia justo aquí abajo, porque es la regla que más se incumple por descuido.

POLÍTICA DE MOVIMIENTO DE LA CASA (OBLIGATORIA)

Todo para todos, con la amplitud justa. Nadie ve una web muerta. Lo que cambia según el visitante no es SI hay movimiento, sino CUÁNTO recorrido tiene. Un solo dial gobierna la web entera: la variable CSS --motion-gain, puesta en <html> por un script del <head>.

Situación--motion-gainQué ve el visitante
Por defecto1La experiencia completa.
Sistema con prefers-reduced-motion: reduce0.25El mismo diseño con un cuarto de recorrido: el movimiento se lee como acento, no como cámara.
URL con ?motion=off0Se queda quieto todo lo que se movía solo, y se retira la clase motion. Lo que el visitante arrastra con el dedo sigue respondiendo: una tarjeta deslizable que no se desliza no es una interfaz sobria, es una foto rota. Es la válvula de quien no quiere movimiento, no un modo de diseño.
URL con ?motion=full1 forzadoIgnora la preferencia del sistema. Para revisar el trabajo desde un equipo con los efectos de animación de Windows desactivados.

0.25 es el valor de la casa, ajustable por proyecto si el efecto lo pide, pero nunca 1: si con reduce no cambia nada, no estás aplicando la política.

Las tres reglas del dial

  1. gain multiplica recorrido: píxeles, escala, rotación, skew. En efectos continuos (marquee, loops) multiplica la velocidad.
  2. gain nunca multiplica la opacidad. Un fundido no marea a nadie. Por eso, al bajar el dial, un efecto no se rompe: degrada. La matrioska con gain: 0.25 sigue contando lo mismo, pero en forma de fundido encadenado en vez de zoom de cámara. Y por eso esta política no obliga a escribir una segunda versión de cada efecto, que es justo lo que costaba el principio 14.
  3. gain no escala el movimiento dirigido por el usuario: arrastrar, hover, tilt con el puntero, cursor lerp, springs de gesto. El oído interno no protesta por lo que uno mismo provoca. Escala solo el movimiento no solicitado: parallax, zoom al scroll, matrioska, scrubbing de secuencia, horizontal, velocity skew, marquee.

Y siempre, además 4. Válvula visible. Aparte de ?motion=off, un control alcanzable en la interfaz (basta en el pie). Una válvula que solo existe en la URL no la encuentra quien la necesita. 5. Foco de teclado y anchors intactos, y contenido legible sin JS (progressive enhancement).

Accesibilidad, con rigor (verificado contra WCAG, MDN y web.dev, 2026-08-19):

  • Lo que hace CONFORME esta política no es el dial, es la válvula. WCAG 2.3.3 (nivel AAA) exige poder DESACTIVAR el movimiento, no solo reducirlo; ?motion=off es ese mecanismo, y por eso es obligatoria y descubrible. Un dial que solo encoge, sin apagado real, no cumpliría la letra de 2.3.3.
  • 0.25 bajo reduce es un PUNTO DE PARTIDA, no un absoluto. Lo que marea es el movimiento de gran amplitud (parallax, zoom, translación de gran superficie), no la opacidad ni el desplazamiento pequeño. Regla fina: bajo reduce, ese movimiento grande hay que llevarlo a ~cero o sustituirlo por un fundido, no dejarlo "más pequeño pero presente". Para un reveal de 16 px, 0.25 sobra; para un parallax de 300 px, 0.25 todavía marea y hay que ir más abajo o directo a opacidad. Es justo lo que respaldan MDN y web.dev: "remove, reduce OR replace".
  • WCAG 2.2.2 "Pause, Stop, Hide" (nivel A, OBLIGATORIO, no AAA): toda animación automática en bucle de más de 5 s (marquee, vídeo de fondo, gradiente en movimiento) DEBE tener un control de pausa o stop, y esto el dial NO lo sustituye. Si metes un marquee infinito, lleva su botón de pausa aparte.

Interruptor central (copiar tal cual en el <head>, antes de cualquier CSS de animación):

<script>
(function () {
  var h = document.documentElement;
  var q = new URLSearchParams(location.search).get('motion');
  var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
  var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
  h.style.setProperty('--motion-gain', String(gain));
  h.classList.toggle('motion', gain > 0);   // compatibilidad: los estados animados cuelgan de html.motion
})();
</script>

En CSS se usa dentro de calc(); en JS se lee una vez y se multiplica:

const GAIN = parseFloat(getComputedStyle(document.documentElement)
  .getPropertyValue('--motion-gain')) || 0;

SIN TARJETA GRÁFICA: EL MODO LIGERO (de serie en toda web nueva)

El caso. En un ordenador con la aceleración por hardware apagada (pasa igual en muchos ordenadores viejos o de empresa), tres webs con scroll animado iban a tirones y cloudflare.com fluida. Medido con la CPU 6x y sin gráfica, a 1920x1080, contando lo que llega a la pantalla:

WebAntesCon el modo ligerocloudflare.com, igual
SaaS (Lenis, cristal, 3D)1,7 fotogramas/s, parón de 2,4 s27,5 y 0,13 s42,6 y 47 ms
Portfolio (Lenis, orbes con blur, 3D)4,6 y 372 ms24,8 y 84 ms45,3 y 49 ms
Producto (sin Lenis; nubes con blur, grano en overlay, demo de cristal)30,1 y 260 ms42,6 y 74 ms46,5 y 46 ms

Con gráfica, el modo ligero no se enciende y nada cambia (comprobado píxel a píxel en las tres).

Por qué. Sin gráfica, el procesador hace lo que hacía la tarjeta: los desenfoques, las mezclas, el 3D y componer cada fotograma. Y con Lenis el scroll lo mueve NUESTRO código en cada fotograma: si el hilo principal va a 5 fotogramas por segundo, la página se mueve a 5. El scroll del navegador lo mueve otro hilo y sigue fluido aunque el principal esté ocupado (por eso cloudflare.com va bien: su código va a 2 fotogramas y su pantalla a 86).

1. Detectar (plantillas/react/dibujoPorSoftware.ts, o plantillas/vanilla/modo-ligero.js): se pide un contexto con getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }); null es dibujo por software. Si da contexto, se suelta en el acto (WEBGL_lose_context). Una vez por visita y después del primer pintado, nunca antes del LCP. ?ligero=1 lo fuerza y ?ligero=0 lo quita; dentro de un <iframe> del mismo origen se mira también la dirección de fuera. En jsdom y en el prerender, se da por hecho que hay gráfica.

2. Solo en ese caso:

  • (a) No arrancar Lenis: scroll del navegador, y en su sitio una pieza nativa con la misma cara (scrollTo con smooth, stop/start con overflow: hidden en <html> para los menús, on("scroll"), animatedScroll). Lo hace solo plantillas/react/useLenis.ts (y arrancarScroll() en vanilla). Los anclajes y los menús no llevan un if cada uno. No se cuelga de window.lenis: Lenis 1.3 ya guarda ahí sus datos.
  • (b) <html data-ligero> y el CSS de plantillas/vanilla/modo-ligero.css: backdrop-filter: none; un halo de filter: blur() pasa a un radial-gradient que ya nace difuminado (a doble tamaño con la propiedad scale, que no pisa el transform del parallax); un mix-blend-mode (el grano en overlay) pasa a mezcla normal con menos opacidad. Se ve casi igual y se sigue moviendo igual.
  • (c) 3D: CADA getContext WebGL de la web se pide con failIfMajorPerformanceCaveat: true, y así cae solo en su versión sin 3D, que tiene que existir (una imagen, el logo plano o, si era adorno de fondo, nada).
  • (d) Las animaciones, NO. La política de la casa no cambia: animaciones para todos, se ajusta la amplitud, no se apagan. Y está medido: en el SaaS de la tabla, quitar el fondo animado o pausar las de CSS no cambiaba nada (de 28 a 29-30 fotogramas); en el producto, las motas y la luz del haz, tampoco. Lo que pesa es (a), (b) y (c).

3. Medir, no suponer (plantillas/medir-scroll-visible.mjs, se lanza desde una carpeta con playwright-core): cuenta los fotogramas que llegan a la pantalla con el scroll movido (emisión de pantalla de Chrome), no los requestAnimationFrame, que con el scroll nativo mienten. Dos medidas, siempre con cloudflare.com al lado en la misma tanda: SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6 (un ordenador sin gráfica) y sin SIN_GRAFICA con CPU 4 (un portátil normal). Chrome sin pantalla (el de Lighthouse) dibuja CON gráfica: no vale para esto. Para encontrar al culpable, quitar cosas una a una con CSS inyectado (display: none, filter: none, mix-blend-mode: normal) y volver a medir: así salieron las nubes del producto de la tabla (de 0,8 s a 0,35 s hasta el primer fotograma), su grano y su demo, y así se vio que su cristal de la portada y sus motas no pintaban nada.

Rendimiento con gráfica: cinco reglas para cualquier web con scroll animado

Medidas en dos webs reales (en una, de 580 a 355 ms de trabajo en fotogramas lentos a CPU 4x). Ninguna quita ni frena una animación: quitan trabajo que no se veía.

  1. Nada de getAnimations() en un animationend: obliga a recalcular los estilos de toda la página (~50 ms a 4x, a menudo en mitad del scroll). Contar los animationstart y animationend del elemento.
  2. No pausar al hacer scroll las animaciones que solo mueven transform/opacity: van en el compositor y no ahorra nada, y pausar y reanudar son dos recálculos grandes por cada scroll.
  3. Nada de montar secciones «en un rato libre» mientras se hace scroll: Lenis deja huecos libres entre fotogramas y requestIdleCallback cae justo ahí. Esperar a que el scroll pare.
  4. Nada de escribir estilos en cada fotograma del scroll si no cambian (--bn: 0 en cada tar)

Skills relacionados