build69
build69  /  Components  /  Motion — Transitions & Decorative  /  AnimatedList

AnimatedList

v1.0.1Updated 21 Jul 2026

Staggered-entrance wrapper that runs a motion/react variant on each child. Four animations: fade-up, fade, slide-right, scale — respects prefers-reduced-motion.

Preview

Live · 11 stories
Fade UpOpen ↗
Why this is recommendedanimationliststaggermotion+2

AnimatedList — fade up.

Recommended for+14
  • Activity feed initial paint
  • Notification list reveal
  • Search-result entrance
  • Table-row first paint
Tags+6
animationliststaggermotionentrancefade
Features+4
  • Animations: fade-up / fade / slide-right / scale
  • Configurable stagger + duration + initialDelay
  • motion/react variants under the hood
  • Renders as div / ol / ul
  • Respects prefers-reduced-motion
  • AnimatedListItem named export for composing custom lists
Not recommended for−2
  • Large lists (virtualise + skip animation)
  • Frequently-mounted lists (animation gets distracting)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "AnimatedList" })

Usage

import { AnimatedList } from '@/components/motion/animated-list';

<AnimatedList animation="fade-up" stagger={60} as="ul">
  {items.map(i => <li key={i.id}>{i.label}</li>)}
</AnimatedList>

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
animation

Keyframe variant

'fade-up' | 'fade' | 'slide-right' | 'scale'
stagger

Delay between children in ms

number
duration

Per-child animation duration in ms

number
initialDelay

Starting offset in ms

number
as

Root element

'div' | 'ol' | 'ul'

Related