- Docs
- Components
- Interface
- Cards & Widgets
- Animated List
A live notification feed with cards that morph into place
| Name | Type | Default | Description |
|---|---|---|---|
items | AnimatedListItem[] | 8 sample notifications | The pool the feed cycles through. Each item takes an id plus title, description, time, icon (any node) or image (a URL). Pass content to render your own markup inside the card. |
layout | "list" | "stack" | "list" | A flowing list, or a stack of cards that fans out into the list on hover. |
position | "top" | "center" | "bottom" | "top" | Where the newest item sits. Top and center flow down, bottom flows up like toasts. |
entrance | "morph" | "slide" | "blur" | "morph" | How new items arrive. Morph grows the card out of its icon, slide drops it in, blur brings it into focus. |
interval | number | 2600 | Milliseconds between new items. 0 stops the feed. |
duration | number | 0.85 | Length of the entrance in seconds. |
initialCount | number | 4 | Items shown before the feed starts. |
maxItems | number | 8 | Older items leave once the list holds this many. |
height | number | string | 520 | Height of the list area. |
gap | number | 10 | Space between cards in pixels. |
radius | number | 20 | Card corner radius. Icons use the concentric inner radius. |
padding | number | 12 | Card padding in pixels. |
iconSize | number | 40 | Size of the icon or image in pixels. |
fade | number | 120 | Length of the edge fade where older items leave the frame. |
dim | number | 0.35 | How far older items recede. Hovering the list brings them back. |
peek | number | 12 | Stack layout: how far each card behind shows. |
stackDepth | number | 3 | Stack layout: cards visible behind the front one. |
expandOnHover | boolean | true | Stack layout: fan the stack out on hover or focus. On touch, a tap opens it. |
pauseOnHover | boolean | true | Hold new items while the pointer or focus is on the list. |
swipeToDismiss | boolean | true | Drag a card sideways, or press Delete, to dismiss it. |
liveTime | boolean | true | Show a ticking relative time on items without their own time. |
unreadDot | boolean | true | Mark newly arrived items with an accent dot that fades after a few seconds. |
theme | "auto" | "light" | "dark" | "auto" | Auto reads the page background and derives the card colours from it. |
accentColor | string | "#5227FF" | Tints icons and the unread dot. |
cardColor | string | derived | Card surface. By default one step off the page background. |
intro | boolean | true | Cascade the first items in the first time the list scrolls into view. |
paused | boolean | false | Stops the feed. |
renderItem | (item) => ReactNode | — | Renders the inside of every card yourself. |
onItemClick | (item) => void | — | Makes cards clickable and keyboard focusable. |
onDismiss | (item) => void | — | Called when a card is swiped or dismissed. |
ref | { push, dismiss, clear, replay } | — | Push your own items in real time, dismiss one by id, clear the list or replay the intro. |
className | string | — | Classes for the list area. |
style | CSSProperties | — | Inline styles for the list area. |
itemsAnimatedListItem[]The pool the feed cycles through. Each item takes an id plus title, description, time, icon (any node) or image (a URL). Pass content to render your own markup inside the card.
8 sample notificationslayout"list" | "stack"A flowing list, or a stack of cards that fans out into the list on hover.
"list"position"top" | "center" | "bottom"Where the newest item sits. Top and center flow down, bottom flows up like toasts.
"top"entrance"morph" | "slide" | "blur"How new items arrive. Morph grows the card out of its icon, slide drops it in, blur brings it into focus.
"morph"intervalnumberMilliseconds between new items. 0 stops the feed.
2600durationnumberLength of the entrance in seconds.
0.85initialCountnumberItems shown before the feed starts.
4maxItemsnumberOlder items leave once the list holds this many.
8heightnumber | stringHeight of the list area.
520gapnumberSpace between cards in pixels.
10radiusnumberCard corner radius. Icons use the concentric inner radius.
20paddingnumberCard padding in pixels.
12iconSizenumberSize of the icon or image in pixels.
40fadenumberLength of the edge fade where older items leave the frame.
120dimnumberHow far older items recede. Hovering the list brings them back.
0.35peeknumberStack layout: how far each card behind shows.
12stackDepthnumberStack layout: cards visible behind the front one.
3expandOnHoverbooleanStack layout: fan the stack out on hover or focus. On touch, a tap opens it.
truepauseOnHoverbooleanHold new items while the pointer or focus is on the list.
trueswipeToDismissbooleanDrag a card sideways, or press Delete, to dismiss it.
trueliveTimebooleanShow a ticking relative time on items without their own time.
trueunreadDotbooleanMark newly arrived items with an accent dot that fades after a few seconds.
truetheme"auto" | "light" | "dark"Auto reads the page background and derives the card colours from it.
"auto"accentColorstringTints icons and the unread dot.
"#5227FF"cardColorstringCard surface. By default one step off the page background.
derivedintrobooleanCascade the first items in the first time the list scrolls into view.
truepausedbooleanStops the feed.
falserenderItem(item) => ReactNodeRenders the inside of every card yourself.
—onItemClick(item) => voidMakes cards clickable and keyboard focusable.
—onDismiss(item) => voidCalled when a card is swiped or dismissed.
—ref{ push, dismiss, clear, replay }Push your own items in real time, dismiss one by id, clear the list or replay the intro.
—classNamestringClasses for the list area.
—styleCSSPropertiesInline styles for the list area.
—