Skip to content

Feat/animations library - #39

Draft
AntoniaStr wants to merge 36 commits into
developfrom
feat/animations-library
Draft

Feat/animations library#39
AntoniaStr wants to merge 36 commits into
developfrom
feat/animations-library

Conversation

@AntoniaStr

@AntoniaStr AntoniaStr commented Jun 15, 2026

Copy link
Copy Markdown

Introduces the TaylorUI Animation System — a layered approach combining Tailwind CSS animations and utility classes for simple transitions and Framer Motion for more complex and gesture driven animations. Adds a new Animations documentation section with interactive showcases and a getting-started guide.


What's Included

📚 New Documentation Pages (/animations)

Page Description
Getting Started Comprehensive guide covering CSS utilities, Framer Motion usage, shared variants/presets, hover underline, SlideUpOnGroupHover, ConfettiButton, ClickContentSwap, View Transitions, and a "what to copy" portability checklist
Buttons Interactive showcase — toggle between no animation, hover underline, and slide-up across all button variants (primary/secondary/tertiary/link, all sizes, with icon, disabled). Plus live Framer Motion demos for confetti particles and content-swap animations
Examples Live CSS animation and Framer Motion variant previews with hover-to-replay support

🧱 Core Animation Library (animations)

  • CSS utilities (animations.css) — Tailwind v4 @utility classes:

    • animate-taylor-fade-up/down/in/left/right, animate-taylor-zoom-in, animate-taylor-spin
    • delay-100 through delay-500
    • All driven by CSS custom properties for consistent timing/easing
  • CSS tokens (tokens.css) — shared --animation-duration-* and --animation-ease-* custom properties

  • Framer Motion variants (variants.ts) — fadeUp, fadeDown, fadeIn, fadeLeft, fadeRight, zoomIn, pageTransition, staggerContainer

  • Framer Motion presets (presets.ts) — springBounce, springGentle, tweenSmooth

  • React hooks & components:

    • useInViewAnimation — Intersection Observer hook that toggles data-state for scroll-triggered CSS animations
    • useViewTransition / ViewTransitionLink — View Transitions API wrappers for smooth page navigations
    • ClickContentSwap — animated button content swap with layout-shift prevention
    • ConfettiButton — particle burst on click
    • SlideUpOnGroupHover — slide-up text reveal on parent hover

⚙️ Infrastructure

  • next.config.ts — enabled experimental.viewTransition
  • package.json — added framer-motion dependency
  • globals.css — imports the new animation CSS
  • Navbar — added "Animations" section to desktop navigation

Design Decisions

  • CSS-first philosophy: Prefer Tailwind @utility classes for simple UI state animations (enter/exit, hover). Fall back to Framer Motion only when gestures, stagger timelines, or complex orchestration are needed.
  • data-state pattern: CSS animations are triggered via data-[state=open] variant selectors, toggled either manually or automatically via useInViewAnimation. This keeps animations declarative and framework-agnostic.
  • Reusable presets: All Framer Motion variants and spring/tween presets are centralized in @/animations so teams can import consistent motion behavior across projects.
  • No layout shift: ClickContentSwap uses a CSS grid with an invisible spacer to prevent button size changes during content transitions.

@AntoniaStr
AntoniaStr requested a review from danbahrami June 15, 2026 06:32
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
taylorui Ready Ready Preview, Comment Jul 23, 2026 10:07am

Request Review

klupsky and others added 2 commits June 26, 2026 09:37
Co-authored-by: Cursor <cursoragent@cursor.com>
klupsky and others added 2 commits July 15, 2026 08:53
…ns library

Co-authored-by: Cursor <cursoragent@cursor.com>
feat(animations): update getting started and add a doc page
klupsky and others added 2 commits July 15, 2026 09:09
klupsky and others added 3 commits July 23, 2026 11:31
Rebase animations library and scroll animation gallery onto the flat
project structure from develop, preserving all showcase and component work.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep product carousel, animated buttons, and scroll animation sections
on the animations showcase page.

Co-authored-by: Cursor <cursoragent@cursor.com>
klupsky and others added 2 commits July 23, 2026 12:01
Add team member carousel showcase, team card components, and MDX
external link handling on top of the animations library branch.

Co-authored-by: Cursor <cursoragent@cursor.com>
feat(team-carousel): basic implementation
klupsky and others added 2 commits July 23, 2026 12:05
Add project carousel component and showcase demo on top of the
animations library branch, preserving all existing showcase sections.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants