Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Lenis、GSAP、Framer Motion を使用して高級感のあるスムーズスクロールと複雑なスクロールトリガーアニメーションを実装します。プレミアム層のサイトで、スクロールに応じて要素を表示・変形させたい場合に使用します。

EVO-Ride-Hailing とは?

このスキルは、Lenis と Framer Motion を組み合わせることで、Web サイトにプレミアムなスクロール体験をもたらします。Lenis で滑らかなスクロール基盤を構築し、Framer Motion を使用してフェードイン、パララックス、遅延表示などの高度なアニメーションパターンを実装します。主に Next.js や React プロジェクトで利用され、`tier-based-architecture` スキルで「Premium 2D」以上のサイトを構築する際に適用されます。Apple 製品のようなストーリーテリングランディングページに最適で、作業工程は明確なチェックリストで管理され、完了後はアラビア語(ヨルダン・パレスチナ方言)でユーザーに自然に報告します。Lenis と Framer Motion のバージョン互換性や TypeScript エラーの確認も自動化されており、安定した動作が保証されます。

対応~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 スタイルの製品紹介)を構築する場合。

トーンと言語ガイドライン(重要)

  • 常に 現地のヨルダン・パレスチナ方言(اللهجة الأردنية والفلسطينية)でユーザーとコミュニケーションを取ること。
  • プロフェッショナルでありながら親しみやすい表現を心がける:「يا هلا」、「رتبتلك السكرول」、「الأنيميشن صار جاهز」。
  • 技術的な選択はアラビア語と英語のWeb用語を混ぜて自然に説明する:「رح نستخدم 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. 「フェードアップ表示」

見出しや大きなテキストブロックがビューポートに入るときに使用します。

  • フック: 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](カスタムイージングはプレミアム感に不可欠)。

B. 「パララックス画像」

画像はスクロール位置よりも少し遅く、または速く動かします。

  • フック: 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. 「遅延表示リスト」

機能グリッド、チームメンバー、価格カードなどに使用します。

  • 親要素: <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. テキストコンテンツに標準のフェードアップ表示を適用する。
  4. 大きなメディアアセット(画像・動画背景)にパララックスを追加する。
  5. リストやグリッドに遅延表示を追加する。
  6. プロジェクトをビルドして、TypeScript や Framer Motion のバージョン不一致エラーがないことを確認する。
  7. ユーザーに伝える:「خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف。」

Individual skills in this repo

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

関連スキル