Premium & Brand

Animated List

Staggers list items in with a short rise and fade.

Import

tsx

import { AnimatedList } from "@cronus-ui/ui";

bash

npx cronus-ui add animated-list

Examples

Staggered list

Children enter with a short rise and fade. Pass the item body, not an li — the component wraps each child.

Deploy finished
Invite accepted
Invoice paid

tsx

<AnimatedList className="w-full max-w-sm">
  <div className="rounded-xl border border-border bg-surface-raised px-4 py-3 text-sm text-fg">
    Deploy finished
  </div>
  <div className="rounded-xl border border-border bg-surface-raised px-4 py-3 text-sm text-fg">
    Invite accepted
  </div>
  <div className="rounded-xl border border-border bg-surface-raised px-4 py-3 text-sm text-fg">
    Invoice paid
  </div>
</AnimatedList>

API Reference

Generated from the component's exported types.

AnimatedListProps

Extends HTMLAttributes<HTMLUListElement>

Prop	Type	Default	Description
`ref`	`Ref<HTMLUListElement>`	—	—
`stagger`	`number`	`0.08`	Seconds between consecutive item reveals.
`reducedMotion`	`"user" \| "always" \| "never"`	`"user"`	How `prefers-reduced-motion` is honoured. Defaults to `"user"` (items appear without the stagger). `"never"` always animates.