Motion

Ready-made parts that animate list items entering, leaving and moving, content swaps and changing numbers.

UI SkillbookSiteplane docsSiteplane UI 1.8.1
Works withClaude CodeCodexCursorOpenCodeUniversal
Install

Run npx uiskillbook get siteplane-motion and follow the Siteplane Motion skill it prints for this task.

Paste this into your agent.

Motion animates data changes: rows added or removed, chips reflowing, a panel swapping steps, or a total rolling to a new figure. You write no animation code, and changes turn instant under reduced motion.

Install

bashnpx shadcn@4.18.0 add @siteplane/motion

Import it from @/siteplane/components/motion. The project needs Siteplane UI's one-time setup first: installation.

When to pick it

  • vs Collapsible: Skip Motion for components that already animate themselves, such as Collapsible, Dialog or Toast.
  • vs Skeleton: Pick Skeleton instead to fill space while data loads; Motion animates the change once it arrives.

Rules

  • Give every MotionItem a stable key from the data, never the array index.
  • Set the space between items with gap on MotionList, not a CSS gap.
  • Move focus to a neighbouring item before removing one, because a leaving item is inert.
  • Use MotionReveal with open for one block, MotionSwap with a changing swapKey for replaced content, and MotionNumber for figures.
  • Virtualize lists with hundreds of rows instead of wrapping each in a Motion element.

Reference

  • Motion docs, with every prop, part and example (Markdown)
  • Siteplane UI 1.8.1, Layout & utilities. Read the installed source under src/siteplane before relying on an API.

Add to your agent

Print this skill from the terminal, or connect the whole catalog over MCP. Setup guides

CLI

npx uiskillbook get siteplane-motion

MCP server

https://www.uiskillbook.com/mcp

Questions