Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Implementa rolagem suave de alto nível e animações complexas acionadas pelo scroll usando Lenis, GSAP ou Framer Motion. Use ao construir um site de nível Premium que precisa de elementos dinâmicos que revelam ou transformam ao rolar.

O que é EVO-Ride-Hailing?

Este skill implementa animações avançadas acionadas pelo scroll em sites de alto padrão, utilizando bibliotecas como Lenis para rolagem suave, e Framer Motion para animações de componentes. Ele é ideal para sites classificados como 'Premium 2D' ou superiores na arquitetura baseada em níveis, e para landing pages focadas em storytelling, como revelações de produtos no estilo Apple. O skill fornece padrões de animação prontos, como fade-up para textos, parallax para imagens e listas escalonadas, garantindo uma experiência visual premium. Ele suporta plataformas modernas de desenvolvimento web (React, Next.js) e é usado quando o usuário solicita elementos que aparecem, deslizam, escalam ou fixam conforme a rolagem da página. A configuração do Lenis é feita em um componente de nível superior, e os padrões do Framer Motion são aplicados seção por seção, seguindo um checklist de fluxo de trabalho para garantir consistência e qualidade.

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

Perguntar na sua IA favorita

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

Documentação

Skill de Animações Avançadas de Rolagem

Quando usar este skill

  • Quando o skill tier-based-architecture solicitar um site de nível "Premium 2D" ou superior.
  • Quando o usuário pedir que elementos apareçam gradualmente, deslizem para cima, escalem ou fixem conforme a rolagem da página.
  • Ao construir uma landing page focada em storytelling (ex.: revelações de produtos no estilo Apple).

Diretrizes de Tom e Linguagem (Crítico)

  • Sempre se comunique com o usuário no dialeto local jordaniano/palestino (اللهجة الأردنية والفلسطينية).
  • Seja profissional, mas acessível: "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
  • Explique as escolhas técnicas naturalmente em árabe misturado com termos web em inglês: "رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth".

1. Configuração e Fundamentos

Se essas bibliotecas estiverem faltando, instale-as: @studio-freight/lenis (para base de rolagem suave) e framer-motion (para animações em nível de componente).

Configuração de Rolagem Suave com Lenis

Todo site que usa este skill deve ter uma base de rolagem suave para garantir que as animações pareçam premium.

  • Configure o Lenis em um componente de alto nível (ex.: SmoothScrollProvider.tsx ou layout.tsx).
// Exemplo de Configuração 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. Padrões de Animação (Framer Motion)

Ao construir seções, use os seguintes padrões para um acabamento de alto nível:

A. O "Fade Up Reveal"

Use isso para títulos e blocos de texto grandes ao entrarem na viewport.

  • Hook: useInView ou <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • Estado Inicial: opacity: 0, y: 40
  • Estado Animado: opacity: 1, y: 0
  • Transição: duration: 0.8, ease: [0.16, 1, 0.3, 1] (easing personalizado é crucial para um toque premium).

B. A "Imagem Parallax"

Imagens devem se mover ligeiramente mais devagar ou mais rápido que a posição de rolagem.

  • Hook: useScroll e useTransform.
  • Implementação:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • Envolva a imagem em um contêiner com overflow-hidden e aplique a transformação y ao motion.img interno.

C. A "Lista Escalonada"

Para grades de recursos, membros da equipe ou cartões de preço.

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

3. Checklist do Fluxo de Trabalho

  1. Copie as instruções.
  2. Confirme se o Lenis está instalado/configurado. Caso contrário, configure-o primeiro.
  3. Aplique revelações Fade Up padrão ao conteúdo de texto.
  4. Adicione parallax a grandes ativos de mídia (imagens/vídeos de fundo).
  5. Adicione revelações escalonadas a listas/grades.
  6. Compile o projeto para verificar se não há erros de incompatibilidade de versão do TypeScript ou Framer Motion.
  7. Diga ao usuário: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."

Individual skills in this repo

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

Habilidades Relacionadas