REFERENCE
- Gallery page: https://magpui.com/en/i/avatar-arrival-opens-welcome-card-cf6500
- First frame (image): https://dnioievkvxejjbxgwvko.supabase.co/storage/v1/object/public/media/avatar-arrival-opens-welcome-card-cf6500/shot.jpg
- Clip (mp4): https://dnioievkvxejjbxgwvko.supabase.co/storage/v1/object/public/media/avatar-arrival-opens-welcome-card-cf6500/clip.mp4
- Original post: https://x.com/Nomandsign/status/2117336092651430266 by @Nomandsign
Before building, download the first frame and look at it. If ffmpeg is available, download the clip and extract frames (ffmpeg -i clip.mp4 -vf fps=2 frame-%02d.png), then study the motion frame by frame. Match what you see; the text below describes it, the frames are the truth.
BUILD: Build only a compact teammate-arrival micro-interaction: a fourth circular avatar joins an existing row, then opens an anchored welcome card below it. Keep the surrounding product interface quiet and secondary.
DESIGN SYSTEM: Use a white surface #FFFFFF on #F7F8F7, near-black #242424 text and muted #858B87 labels. Four roughly 28px avatars overlap slightly, each with a fine colored ring. The card is approximately 285px wide, with 16px padding, 18px corners, a faint border and soft shadow. Use a neutral sans-serif, 14px body, 12px labels and 16px medium name. Include a small green presence dot, short role line, two muted placeholder lines and two pill actions, one outlined and one dark.
MOTION: On a simulated teammate arrival, insert the avatar with opacity and scale over 240ms using cubic-bezier(0.22,1,0.36,1), making room in the stack. A restrained green-to-pale-violet wash briefly crosses the nearby background and fades over 650ms; do not obscure the interface. After a proposed 140ms delay, reveal the card from its top-right avatar anchor with opacity, scale 0.94 to 1 and translateY -8px to 0 over 300ms, cubic-bezier(0.22,1,0.36,1). Close reverses the anchored motion over 180ms. These timings are implementation targets, not measured source values.
SECTIONS: Idle avatar stack; arriving avatar; open card with arrival label, placeholder avatar, name, role, close button and Follow / Say hi actions; dismissed card with avatar stack retained. Use generated initials instead of requiring a photo.
IMPLEMENTATION: Use React and Motion for presence and shared layout; CSS for the temporary wash. Anchor the card to the row and flip placement near viewport edges. Close with Escape and an accessible button, retain logical focus and provide keyboard access to actions. Never steal focus for an automatic arrival. Under prefers-reduced-motion, omit the wash and scale, using an immediate reveal or short opacity fade. Keep animation to transforms and opacity.
ADAPT TO THE PROJECT: Reuse the existing tokens, components and fonts. Map these estimated colors to nearby project tokens. Do not copy source logos, brand names, photos or illustrations; use placeholders.
SUCCESS CHECK:
- The fourth avatar appears before its welcome card and remains after dismissal.
- The card stays inside the viewport and supports keyboard dismissal.
- Reduced motion avoids the colored sweep and spatial unfolding.