Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Implementa desplazamiento suave de alta gama y animaciones complejas activadas por scroll usando Lenis, GSAP o Framer Motion. Úsalo al construir un sitio de nivel Premium que necesite elementos dinámicos que se revelen o transformen al hacer scroll.

¿Qué es EVO-Ride-Hailing?

Esta habilidad proporciona un conjunto completo de herramientas y patrones para implementar animaciones avanzadas basadas en scroll en sitios web de alta gama. Está diseñada para proyectos que requieren un acabado premium, como landing pages con storytelling al estilo Apple. La habilidad se basa en dos bibliotecas principales: `@studio-freight/lenis` para un desplazamiento suave y `framer-motion` para las animaciones a nivel de componente. Incluye configuraciones listas para usar de Lenis, patrones de animación como Fade Up Reveal (para textos), Parallax Image (para imágenes de fondo) y Staggered List (para grids y listas), así como una lista de verificación de flujo de trabajo. El tono de comunicación es profesional pero cercano, usando el dialecto jordano/palestino para conectar con el usuario final. La habilidad se aplica cuando la arquitectura basada en niveles exige un tier 'Premium 2D' o superior, o cuando el usuario solicita elementos que se desvanezcan, deslicen, escalen o fijen al hacer scroll.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Amazinggear/EVO-Ride-Hailing/tree/HEAD/.agent/skills/advanced-scroll-animations

Preguntar en tu IA favorita

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

Documentación

Habilidad de Animaciones Avanzadas por Scroll

Cuándo usar esta habilidad

  • Cuando la habilidad de arquitectura-basada-en-niveles indique un sitio de nivel "Premium 2D" o superior.
  • Cuando el usuario pida que elementos aparezcan gradualmente, se deslicen hacia arriba, escalen o se fijen al hacer scroll hacia abajo.
  • Al construir una landing page centrada en storytelling (por ejemplo, revelaciones de producto al estilo Apple).

Directrices de Tono e Idioma (Crítico)

  • Siempre comunícate con el usuario en el dialecto local jordano/palestino (اللهجة الأردنية والفلسطينية).
  • Sé profesional pero accesible: "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
  • Explica las decisiones técnicas de forma natural en árabe mezclado con términos web en inglés: "رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth".

1. Configuración y Fundamentos

Si faltan estas bibliotecas, instálalas: @studio-freight/lenis (para la base de desplazamiento suave) y framer-motion (para animaciones a nivel de componente).

Configuración de Lenis para Desplazamiento Suave

Cada sitio que use esta habilidad debe tener una base de desplazamiento suave para que las animaciones se sientan premium.

  • Configura Lenis en un componente de alto nivel (por ejemplo, SmoothScrollProvider.tsx o layout.tsx).
// Ejemplo de configuración de Lenis
"use client";
import React, { useEffect } from 'react';
import Lenis from '@studio-freight/lenis';

export default function SmoothScroll({ children }: { children: React.ReactNode }) {
  useEffect(() => {
    const lenis = new Lenis({
      duration: 1.2,
      easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
      orientation: 'vertical',
      gestureOrientation: 'vertical',
      smoothWheel: true,
      wheelMultiplier: 1,
      touchMultiplier: 2,
    });

    function raf(time: number) {
      lenis.raf(time);
      requestAnimationFrame(raf);
    }
    requestAnimationFrame(raf);

    return () => {
      lenis.destroy();
    };
  }, []);

  return <>{children}</>;
}

2. Patrones de Animación (Framer Motion)

Al construir secciones, usa los siguientes patrones para un acabado de alta gama:

A. "Revelación con Desplazamiento Hacia Arriba"

Úsalo para encabezados y bloques de texto grandes al entrar al viewport.

  • Hook: useInView o <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • Estado inicial: opacity: 0, y: 40
  • Estado animado: opacity: 1, y: 0
  • Transición: duration: 0.8, ease: [0.16, 1, 0.3, 1] (la personalización del easing es crucial para un acabado premium).

B. "Imagen con Efecto Parallax"

Las imágenes deben moverse un poco más lento o más rápido que la posición del scroll.

  • Hook: useScroll y useTransform.
  • Implementación:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • Envuelve la imagen en un contenedor con overflow-hidden, y aplica la transformación y al motion.img interno.

C. "Lista Escalonada"

Para grids de características, miembros del equipo o tarjetas de precios.

  • Padre: <motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}>
  • Variants (Padre): { hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } }
  • Variants (Elemento hijo): { hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }

3. Lista de Verificación del Flujo de Trabajo

  1. Copia las instrucciones.
  2. Confirma si Lenis está instalado/configurado. Si no, configúralo primero.
  3. Aplica revelaciones estándar con desplazamiento hacia arriba al contenido de texto.
  4. Añade parallax a los activos multimedia grandes (imágenes/fondos de video).
  5. Añade revelaciones escalonadas a listas/grids.
  6. Construye el proyecto para verificar que no haya errores de TypeScript o de versiones incompatibles de Framer Motion.
  7. Dile al usuario: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."

Individual skills in this repo

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

Skills relacionados