Communitygithub.com

Amazinggear/EVO-Ride-Hailing

Implementiert hochwertiges, flüssiges Scrollen und komplexe scrollgesteuerte Animationen mit Lenis, GSAP oder Framer Motion. Verwenden Sie dies beim Erstellen einer Premium-Website, die dynamische Elemente benötigt, die beim Scrollen erscheinen oder sich verwandeln.

Was ist EVO-Ride-Hailing?

Diese Fähigkeit (Skill) befähigt KI-Agenten wie Claude Code, Cursor oder Codex, hochwertige, scrollgesteuerte Animationen zu erstellen, die für Premium-Websites der Stufen 'Premium 2D' oder höher charakteristisch sind. Sie bietet eine umfassende Anleitung zur Integration von Lenis für geschmeidiges Scrollen und Framer Motion für Komponentenanimationen, einschließlich bewährter Methoden wie Fade-Up-Reveals, Parallax-Effekten und gestaffelten Listen. Der Skill ist besonders nützlich, um geschichtenorientierte Landingpages mit nahtlosen Übergängen zu bauen, die an Apple-Produktvorstellungen erinnern. Er enthält zudem eine Workflow-Checkliste, die den Entwicklungsprozess von der Installation über die Einrichtung bis hin zur Fertigstellung vereinfacht.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Skill für fortgeschrittene Scroll-Animationen

Wann dieser Skill verwendet werden soll

  • Wenn der tier-basierte-architektur-Skill eine „Premium 2D“ oder höhere Website-Stufe erfordert.
  • Wenn der Benutzer wünscht, dass Elemente beim Herunterscrollen der Seite einblenden, nach oben gleiten, skalieren oder fixiert werden.
  • Beim Erstellen einer erzählorientierten Landingpage (z. B. Produktvorstellungen im Apple-Stil).

Ton- und Sprachrichtlinien (Wichtig)

  • Kommunizieren Sie immer mit dem Benutzer im lokalen jordanischen/palästinensischen Dialekt (اللهجة الأردنية والفلسطينية).
  • Seien Sie professionell, aber zugänglich: „يا هلا“، „رتبتلك السكرول“، „الأنيميشن صار جاهز“.
  • Erklären Sie technische Entscheidungen natürlich auf Arabisch mit englischen Web-Begriffen: „رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth“.

1. Einrichtung & Grundlagen

Wenn diese Bibliotheken fehlen, installieren Sie sie: @studio-freight/lenis (für geschmeidiges Scrollen) und framer-motion (für Animationen auf Komponentenebene).

Lenis Smooth Scroll Konfiguration

Jede Website, die diesen Skill verwendet, muss eine geschmeidige Scrollbasis haben, um ein hochwertiges Gefühl zu gewährleisten.

  • Richten Sie Lenis in einer Komponente der obersten Ebene ein (z. B. SmoothScrollProvider.tsx oder layout.tsx).
// Beispiel für Lenis Einrichtung
"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. Animationsmuster (Framer Motion)

Verwenden Sie beim Erstellen von Abschnitten die folgenden Muster, um ein hochwertiges Gefühl zu erzielen:

A. Der „Fade Up Reveal“ (Einblenden von unten)

Verwenden Sie dies für Überschriften und große Textblöcke, wenn sie in den Viewport eintreten.

  • Hook: useInView oder <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • Anfangszustand: opacity: 0, y: 40
  • Animationszustand: opacity: 1, y: 0
  • Übergang: duration: 0.8, ease: [0.16, 1, 0.3, 1] (benutzerdefinierte Beschleunigung ist entscheidend für ein hochwertiges Gefühl).

B. Das „Parallax-Bild“

Bilder sollten sich etwas langsamer oder schneller als die Scrollposition bewegen.

  • Hook: useScroll und useTransform.
  • Implementierung:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • Wickeln Sie das Bild in einen Container mit overflow-hidden und wenden Sie die y-Transformation auf das innere motion.img an.

C. Die „Gestaffelte Liste“

Für Feature-Raster, Teammitglieder oder Preiskarten.

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

3. Arbeitsablauf-Checkliste

  1. Kopieren Sie die Anweisungen.
  2. Bestätigen Sie, ob Lenis installiert/konfiguriert ist. Falls nicht, richten Sie es zuerst ein.
  3. Wenden Sie standardmäßige Fade-Up-Reveals auf Textinhalte an.
  4. Fügen Sie Parallax-Effekte zu großen Medien-Assets (Bilder/Video-Hintergründe) hinzu.
  5. Fügen Sie gestaffelte Enthüllungen zu Listen/Rastern hinzu.
  6. Bauen Sie das Projekt, um sicherzustellen, dass keine TypeScript- oder Framer Motion-Versionskonflikte auftreten.
  7. Teilen Sie dem Benutzer mit: „خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف.“

Individual skills in this repo

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

Verwandte Skills