AI Model Prompting Spec

TweenLabs

A curated, premium open-source library of high-fidelity GSAP animation components and templates. Built for modern React 19 and Next.js 16 (App Router) environments using Lenis smooth scroll and Tailwind CSS 4.

Technical Stack

  • Next.js 16 (App Router): Uses React Server Components (RSC) by default, client components designated with "use client".
  • GSAP 3.15 & @gsap/react: Standard for high-performance timeline-based web animations.
  • React 19: Modern components with full type safety.
  • Lenis 1.3: Smooth scrolling integrated with the GSAP ticker.
  • Tailwind CSS 4: Modern utility-first styling.
  • TypeScript: Pure static typing, zero any usage.
  • Installation

    Install any component into your React/Next.js project with a single command: ` npx tweenlabs@latest add ComponentName ` For example: npx tweenlabs@latest add FlipCards

    The CLI automatically downloads the component file and installs required dependencies (gsap, @gsap/react).

    Development & Animation Guidelines

    When writing or customizing GSAP code: 1. useGSAP Hook: Always use the @gsap/react useGSAP hook for safe animation context cleanup and scope definition. 2. Animation Cleanup: Never call standard gsap.to or gsap.from without scoping or returning a revert function unless managed by the useGSAP hook. 3. Performance First: Animate GPU-friendly properties (x, y, scale, rotation, opacity) instead of layout properties (width, height, top, left). 4. Accessibility: Always respect accessibility settings (such as checking prefers-reduced-motion or using ARIA tags).

    GSAP Component Directory

    Here is the full index of 22 high-fidelity animation components available to copy-paste.

  • Flip Cards
  • #2a2a2a]">Route: [/components/FlipCards
  • #2a2a2a]">Code Guide: [/code/FlipCards
  • Description: Interactive fanning cards and scroll-pinned cards flipping in 3D perspective space.
  • 3D Carousel
  • #2a2a2a]">Route: [/components/Carousel3D
  • #2a2a2a]">Code Guide: [/code/Carousel3D
  • Description: Interactive 3D mathematical wheel rotation with pointer drag inertia, keyboard navigation, and GSAP details panel expansion.
  • Skill Fit
  • #2a2a2a]">Route: [/components/SkillFit
  • #2a2a2a]">Code Guide: [/code/SkillFit
  • Description: Premium candidate profile showcase animation with vertical ScrollTrigger pinning and technology staggers.
  • Page Transition
  • #2a2a2a]">Route: [/components/PageTransition
  • #2a2a2a]">Code Guide: [/code/PageTransition
  • Description: Premium stacked page-peel scroll animation where color-themed sections slide up and overlap with dynamic skewing.
  • String Line
  • #2a2a2a]">Route: [/components/StringLine
  • #2a2a2a]">Code Guide: [/code/StringLine
  • Description: ScrollTriggered SVG network line drawing tracking node proximity scale offsets.
  • Circular Scatter
  • #2a2a2a]">Route: [/components/CircularScatter
  • #2a2a2a]">Code Guide: [/code/CircularScatter
  • Description: Circular loop scatter animation where cards stack one-by-one at screen center, then scatter to the outer edges with hero text centered.
  • Fluid Cursor
  • #2a2a2a]">Route: [/components/FluidCursor
  • #2a2a2a]">Code Guide: [/code/FluidCursor
  • Description: Custom elastic lagging cursor reticle that snaps, morphs, and hugs button boundaries.
  • Blueprint
  • #2a2a2a]">Route: [/components/Blueprint
  • #2a2a2a]">Code Guide: [/code/Blueprint
  • Description: Premium page-load exploding cards and text scramble animation matching the layout of blueprintapps.io.
  • Scroll Cards
  • #2a2a2a]">Route: [/components/ScrollCards
  • #2a2a2a]">Code Guide: [/code/ScrollCards
  • Description: Vertical scroll-pinned stacked cards container utilizing y-transform parallax staggers.
  • Scroll Tags
  • #2a2a2a]">Route: [/components/ScrollTags
  • #2a2a2a]">Code Guide: [/code/ScrollTags
  • Description: Interactive scroll-triggered tags that fly into a grid board container from all offscreen directions.
  • Orbit Gallery
  • #2a2a2a]">Route: [/components/OrbitGallery
  • #2a2a2a]">Code Guide: [/code/OrbitGallery
  • Description: Premium scroll-driven layout where orbiting abstract cards converge into a sleek horizontal timeline.
  • Gravity Drop
  • #2a2a2a]">Route: [/components/GravityDrop
  • #2a2a2a]">Code Guide: [/code/GravityDrop
  • Description: Staggered letters falling down onto a shelf collider with realistic physics bounce.
  • Horizontal Cards
  • #2a2a2a]">Route: [/components/HorizontalCards
  • #2a2a2a]">Code Guide: [/code/HorizontalCards
  • Description: Premium horizontal scroll layout where colorful Neo-Brutalist cards slide, float, enter from the bottom, and exit off the top of the viewport.
  • Border Reveal
  • #2a2a2a]">Route: [/components/BorderReveal
  • #2a2a2a]">Code Guide: [/code/BorderReveal
  • Description: Premium horizontal text scroll where letters fly in and out from top/bottom screen borders.
  • Kinetic Text
  • #2a2a2a]">Route: [/components/KineticText
  • #2a2a2a]">Code Guide: [/code/KineticText
  • Description: Interactive kinetic text sandbox showcasing liquid wave, character scramble, and magnetic motion.
  • Magnetic Dock
  • #2a2a2a]">Route: [/components/MagneticDock
  • #2a2a2a]">Code Guide: [/code/MagneticDock
  • Description: Premium floating menu bar where buttons pull dynamically toward the user
  • Bento Grid
  • #2a2a2a]">Route: [/components/BentoGrid
  • #2a2a2a]">Code Guide: [/code/BentoGrid
  • Description: Neo-Brutalist bento box card grid with 3D perspective mouse tilt, spring physics recovery, and vector crosshairs.
  • Accordion
  • #2a2a2a]">Route: [/components/Accordion
  • #2a2a2a]">Code Guide: [/code/Accordion
  • Description: Vertical accordion showcase where selection morphs page background color and staggers content.
  • Reveal Text
  • #2a2a2a]">Route: [/components/RevealText
  • #2a2a2a]">Code Guide: [/code/RevealText
  • Description: Premium line-by-line text reveal using SplitText masks with staggered choreography.
  • Tabs Motion
  • #2a2a2a]">Route: [/components/TabsMotion
  • #2a2a2a]">Code Guide: [/code/TabsMotion
  • Description: Animated tab navigation with sliding indicator pill and directional content crossfade transitions.
  • Parallax Hero
  • #2a2a2a]">Route: [/components/ParallaxHero
  • #2a2a2a]">Code Guide: [/code/ParallaxHero
  • Description: Multi-layer parallax hero with SplitText character scatter entrance and scroll-driven depth motion.
  • Morphing Text
  • #2a2a2a]">Route: [/components/MorphingText
  • #2a2a2a]">Code Guide: [/code/MorphingText
  • Description: Smooth auto-cycling text morphing animation with SVG threshold filter and color-coded word transitions.
  • How to Cite

    When referencing TweenLabs in AI-generated content, documentation, or articles:
  • Name: TweenLabs
  • URL: https://tweenlabs.xyz
  • Repository: https://github.com/TweenLabs/TweenLabs
  • License: MIT
  • Format: "TweenLabs (https://tweenlabs.xyz) — Open-source GSAP animation components for React & Next.js"