Premium Animated List
AnimatedList container, the engine forces a perspective boundary and applies a high-end 3D flip-in sequence (back.out easing) to every direct child. Furthermore, the AnimatedListItem wrapper brings the component to life after entry by tracking the user's cursor to render a subtle spotlight gradient glow.Animated list
Wrap the feed in AnimatedList and each row in AnimatedListItem — the stagger, perspective and hover spotlight come with it.
- Set
staggerDelay{0.15} - to the gap in seconds between one child starting and the next.
Installation
New project? Follow the installation guide to set up Tailwind CSS, shadcn, the cn helper and lucide-react, register the @algorize-ui registry once, then copy your styles from the Themes page.
Install Animated List
components/ is written into your project. Copy any snippet from a Usage tab above and it runs.
Install dependencies
Nothing beyond the shared setup — Animated List needs only the cn helper and lucide-react, which the installation guide already put in place.
Examples
Flip
- Use
variant"flip" - to rotate each row in on the X axis against the container's 3D perspective — the signature entrance.
Slide up
- Use
variant"slide-up" - to translate the rows in from an edge instead of rotating.
slide-leftandslide-rightdo the same from the sides.
Pop
- Use
variant"pop" - to scale each row in from small.
ease"elastic.out(1, 0.5)"- adds the overshoot that makes the pop bounce.
Timing
staggerDelay{0.35}- is the gap between children.
duration{1.1}- is how long each one takes.
animationDelay{0.3}- is how long the whole sequence waits before starting.
ease"power4.out"- takes any GSAP-style ease name — no GSAP needed.
Features
Fluid Animations
Hardware-accelerated transitions that ensure smooth 60fps performance across devices.
Highly Customizable
Exposes intuitive props for tailoring colors, sizes, and animation speeds to fit your brand.
Responsive Design
Automatically adapts to mobile, tablet, and desktop viewports without horizontal scrolling issues.
Accessible
Built with semantic HTML and ARIA labels where necessary to support screen readers and keyboard navigation.
Best Practices & Guidelines
Animation Performance
Avoid placing too many heavy animated components on a single screen to prevent layout thrashing and maintain 60fps performance. Use intersection observers to pause off-screen animations.
State Management
When triggering animations via state changes, ensure you wrap state updates in startTransition or use lightweight stores to prevent React rendering bottlenecks during the animation tick.
Props Reference
| Component | Prop | Type | Default | Description |
|---|---|---|---|---|
AnimatedList | staggerDelay | number | 0.12 | The amount of time (in seconds) to wait before animating the next
consecutive child element in the list. |
AnimatedList | animationDelay | number | 0 | The total delay (in seconds) before the entire staggered 3D flip-in
sequence begins. |
AnimatedList | duration | number | 0.8 | The total duration (in seconds) of the entry animation for a
single list item. |
AnimatedList | ease | string | "back.out(1.5)" | The easing applied to the entrance animation, named the GSAP way
( "power4.out", "elastic.out(1, 0.5)") and
evaluated without the library; CSS keywords and
cubic-bezier() work too. |
AnimatedListItem | ...props | HTMLAttributes<HTMLDivElement> | undefined | Accepts all native HTML div attributes. This component automatically
handles its own onMouseMove and onMouseLeave
events to drive the glassmorphic spotlight gradient under the hood. |