Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Lenis, GSAP 또는 Framer Motion을 사용하여 고급 부드러운 스크롤과 복잡한 스크롤 트리거 애니메이션을 구현합니다. 프리미엄 등급 사이트를 구축할 때 스크롤에 따라 동적 요소가 드러나거나 변형되는 경우 사용합니다.

EVO-Ride-Hailing란 무엇인가요?

이 스킬은 프리미엄 웹사이트에 고급스러운 스크롤 경험과 스크롤 기반 애니메이션을 추가하기 위한 전문 도구입니다. 주로 `Lenis` 라이브러리를 통해 부드러운 스크롤 베이스를 제공하고, `Framer Motion`을 활용하여 컴포넌트 레벨의 페이드 인, 패럴랙스, 지연 리스트 등 다양한 애니메이션 패턴을 구현합니다. 제품 소개 페이지나 스토리텔링 랜딩 페이지(예: Apple 스타일)에서 특히 효과적이며, `tier-based-architecture` 스킬의 'Premium 2D' 이상 등급과 함께 사용됩니다. 이 스킬의 큰 특징은 사용자와의 모든 소통을 요르단/팔레스타인 현지 방언(اللهجة الأردنية والفلسطينية)으로 진행하며, 전문적이면서도 친근한 어조를 유지한다는 점입니다. 기술적 설명은 아랍어와 영어 웹 용어를 혼합하여 자연스럽게 전달합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

고급 스크롤 애니메이션 스킬

이 스킬을 사용해야 하는 경우

  • tier-based-architecture 스킬이 "Premium 2D" 이상 등급의 웹사이트를 요구할 때
  • 사용자가 페이지 스크롤에 따라 요소가 페이드 인, 슬라이드 업, 크기 조절 또는 고정되기를 원할 때
  • 스토리텔링 중심의 랜딩 페이지(예: Apple 스타일의 제품 소개)를 구축할 때

어조 및 언어 지침 (필수)

  • 항상 사용자와 요르단/팔레스타인 현지 방언(اللهجة الأردنية والفلسطينية)으로 소통하세요.
  • 전문적이면서도 친근하게: "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز"
  • 기술적 선택을 아랍어와 영어 웹 용어를 혼합하여 자연스럽게 설명하세요: "رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth"

1. 설정 및 기반

이 라이브러리들이 없으면 설치하세요: @studio-freight/lenis (부드러운 스크롤 베이스) 와 framer-motion (컴포넌트 레벨 애니메이션).

Lenis 부드러운 스크롤 구성

이 스킬을 사용하는 모든 사이트는 반드시 부드러운 스크롤 베이스를 가져야 애니메이션이 프리미엄하게 느껴집니다.

  • 최상위 컴포넌트(예: SmoothScrollProvider.tsx 또는 layout.tsx)에 Lenis를 설정합니다.
// 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. 애니메이션 패턴 (Framer Motion)

섹션을 구축할 때 고급스러운 느낌을 위해 다음 패턴을 사용하세요:

A. "Fade Up Reveal"

헤드라인과 큰 텍스트 블록이 뷰포트에 들어올 때 사용합니다.

  • 훅: useInView 또는 <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • 초기 상태: opacity: 0, y: 40
  • 애니메이트 상태: opacity: 1, y: 0
  • 전환: duration: 0.8, ease: [0.16, 1, 0.3, 1] (프리미엄 느낌을 위해 사용자 정의 easing이 중요)

B. "Parallax Image"

이미지가 스크롤 위치보다 약간 느리거나 빠르게 움직여야 합니다.

  • 훅: useScroll 및 useTransform
  • 구현:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • 이미지를 overflow-hidden인 컨테이너로 감싸고 내부 motion.img에 y 변환을 적용합니다.

C. "Staggered List"

기능 그리드, 팀 멤버, 가격 카드 등에 사용합니다.

  • 부모: <motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}>
  • 변형 (부모): { hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } }
  • 변형 (자식 항목): { hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }

3. 워크플로 체크리스트

  1. 지침을 복사합니다.
  2. Lenis가 설치/구성되었는지 확인합니다. 그렇지 않으면 먼저 설정합니다.
  3. 텍스트 콘텐츠에 표준 Fade Up reveal을 적용합니다.
  4. 대형 미디어 자산(이미지/비디오 배경)에 패럴랙스를 추가합니다.
  5. 목록/그리드에 지연 reveal을 추가합니다.
  6. 프로젝트를 빌드하여 TypeScript 또는 Framer Motion 버전 불일치 오류가 없는지 확인합니다.
  7. 사용자에게 알립니다: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."

Individual skills in this repo

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

관련 스킬