Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Implémente un défilement fluide haut de gamme et des animations complexes déclenchées par le défilement à l'aide de Lenis, GSAP ou Framer Motion. À utiliser lors de la création d'un site de niveau Premium nécessitant des éléments dynamiques qui se révèlent ou se transforment au défilement.

Qu'est-ce que EVO-Ride-Hailing ?

Cette compétence est conçue pour les développeurs qui souhaitent créer des sites web de niveau Premium avec des animations de défilement fluides et dynamiques. Elle repose sur des bibliothèques modernes comme Lenis pour la base du défilement fluide et Framer Motion pour les animations au niveau des composants. La compétence propose des patrons d'animation éprouvés tels que le « Fade Up Reveal » pour les titres, l'effet parallaxe pour les images et les révélations en cascade pour les listes et les grilles. Destinée aux projets génériques, elle met l'accent sur une implémentation soignée et un rendu visuel impressionnant, avec un guide d'installation et des exemples de code prêts à l'emploi.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Animations de Défilement Avancées

Quand utiliser cette compétence

  • Lorsque la compétence tier-based-architecture demande un site de niveau « Premium 2D » ou supérieur.
  • Lorsque l'utilisateur souhaite que des éléments apparaissent en fondu, glissent vers le haut, changent d'échelle ou se fixent au fur et à mesure du défilement de la page.
  • Lors de la création d'une page d'atterrissage centrée sur la narration (par exemple, des révélations de produits à la Apple).

Consignes de Ton et de Langue (Critiques)

  • Toujours communiquer avec l'utilisateur dans le dialecte local jordanien/palestinien (اللهجة الأردنية والفلسطينية).
  • Être professionnel mais accessible : "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
  • Expliquer les choix techniques naturellement en arabe mélangé à des termes web anglais : "رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth".

1. Configuration & Fondations

Si ces bibliothèques sont manquantes, les installer : @studio-freight/lenis (pour la base de défilement fluide) et framer-motion (pour les animations au niveau des composants).

Configuration Lenis Smooth Scroll

Chaque site utilisant cette compétence doit avoir une base de défilement fluide pour garantir que les animations paraissent premium.

  • Configurer Lenis dans un composant de haut niveau (ex. SmoothScrollProvider.tsx ou layout.tsx).
// Exemple de configuration 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. Patrons d'Animation (Framer Motion)

Lors de la construction des sections, utiliser les patrons suivants pour un rendu haut de gamme :

A. Le « Fade Up Reveal »

Utiliser ceci pour les titres et les grands blocs de texte lorsqu'ils entrent dans le viewport.

  • Hook : useInView ou <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • État initial : opacity: 0, y: 40
  • État d'animation : opacity: 1, y: 0
  • Transition : duration: 0.8, ease: [0.16, 1, 0.3, 1] (un easing personnalisé est crucial pour une sensation premium).

B. L'image Parallaxe

Les images doivent se déplacer légèrement plus lentement ou plus rapidement que la position de défilement.

  • Hook : useScroll et useTransform.
  • Implémentation :
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • Envelopper l'image dans un conteneur avec overflow-hidden, et appliquer la transformation y à l'élément motion.img intérieur.

C. La Liste en Cascade

Pour les grilles de fonctionnalités, les membres de l'équipe ou les cartes de tarification.

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

3. Liste de Vérification des Étapes

  1. Copier les instructions.
  2. Confirmer si Lenis est installé/configuré. Sinon, le configurer d'abord.
  3. Appliquer les révélations Fade Up standard au contenu textuel.
  4. Ajouter l'effet parallaxe aux grands médias (images/fonds vidéo).
  5. Ajouter les révélations en cascade aux listes/grilles.
  6. Construire le projet pour vérifier l'absence d'erreurs de version TypeScript ou Framer Motion.
  7. Dire à l'utilisateur : "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."

Individual skills in this repo

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

Skills associés