Update to Picsart
Snapshot Nov 7, 2026 · 00:09 UTC · version 2.4.0
Collection source: downloaded plugin package.
Instructions updated for app-ui-animation
Skill instructions — Now says: ported-from: ui-motion 1.11 at 55.75.0
Observed in instructions or declared skills. Runtime behavior has not been tested.
Up to 3 plugins free · no card required.
All fields and original values.
Skill instructions
Nov 3, 2026 · 18:14 UTC
No removed lines (ordering may have changed)
Nov 7, 2026 · 00:09 UTC
ported-from: ui-motion 1.11 at 55.75.0
Supporting files
Nov 3, 2026 · 18:14 UTC
[{"relative_path":"references/cursor-actions.md","size_in_bytes":7113},{"relative_path":"references/cursor-drag-drop.md","size_in_bytes":3934},{"relative_path":"references/drag-and-sync.md","size_in_bytes":5763},{"relative_path":"referen...
Nov 7, 2026 · 00:09 UTC
[{"relative_path":"references/cursor-actions.md","size_in_bytes":7113},{"relative_path":"references/cursor-drag-drop.md","size_in_bytes":3934},{"relative_path":"references/drag-and-sync.md","size_in_bytes":5763},{"relative_path":"referen...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -4,6 +4,7 @@ metadata: category: authoring version: '1.11' + ported-from: ui-motion 1.11 at 55.75.0 --- # UI motion — making a mockup behave like a device
Full technical diff · 2 changed fields
changed /included_files
[
{
"relative_path": "references/cursor-actions.md",
"size_in_bytes": 7113
},
{
"relative_path": "references/cursor-drag-drop.md",
"size_in_bytes": 3934
},
{
"relative_path": "references/drag-and-sync.md",
"size_in_bytes": 5763
},
{
"relative_path": "references/frosted-glass.md",
"size_in_bytes": 4727
},
{
"relative_path": "references/loading-reveal.md",
"size_in_bytes": 3757
}
][
{
"relative_path": "references/cursor-actions.md",
"size_in_bytes": 7113
},
{
"relative_path": "references/cursor-drag-drop.md",
"size_in_bytes": 3934
},
{
"relative_path": "references/drag-and-sync.md",
"size_in_bytes": 5763
},
{
"relative_path": "references/frosted-glass.md",
"size_in_bytes": 4807
},
{
"relative_path": "references/loading-reveal.md",
"size_in_bytes": 3757
}
]changed /skill_md_contents
"---\nname: app-ui-animation\ndescription: Build a phone or web UI in a scene with scrolling, carousels, button feedback, cursor paths and clicks, context menus, drag-and-drop, synchronized controls, bottom sheets and frosted-glass panels. Use when animating an app mockup, UI walkthrough, slider or onboarding flow, frosted glass or glassmorphism cards, or when a mock renders correctly but reads as a picture rather than an app somebody is using.\nmetadata:\n category: authoring\n version: '1.11'\n---\n\n# UI motion — making a mockup behave like a device\n\nA UI mock that renders correctly and still reads as a screenshot is almost always missing\nthree things: the content does not carry momentum, nothing answers a touch, and panels\nappear instead of arriving. Each has a home in the catalog. **Read this before authoring a\nnew preset for a UI beat — most UI beats are arrangements of what already exists.**\n\n## Where a UI beat belongs\n\nBefore choosing a preset, settle the semantic units and who owns their motion with\nlinked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`); it also\ncovers the ownership/binding/phase decision, growing panels and sibling reflow. Derive backing\ndimensions and child placement from shared parameters so a size edit preserves the layout by\nconstruction; grouping does not make a container automatically fit its animated children. Validate\nthose relationships throughout the event window.\n\n| Home | When |\n|---|---|\n| **Motion preset** or **Look** | Choose between them with motion-pattern-library (fetch with `picsart_scene_recipe`, name `motion-pattern-library`). Only a look adds structure the layer does not have — a viewport, a mask, extra layers (`scroll`, `rounded_corners`) |\n| **Scene template** | The motion depends on a layer's index or count (a list stagger, a grid) |\n| **This recipe** | No new capability — a known-good arrangement of the above |\n\nAnd before adding any of them: **prefer a param on an existing preset over a new preset.**\nPaged scrolling is `snap` on `scroll`, not a `carousel` look. A catalog that grows one entry\nper arrangement stops being scannable, and then finding costs more than building.\n\n## Build the chrome from shapes\n\nUI chrome is rectangles with rounded corners and text on top. Author it as `kind: \"shape\"` —\nit is built in. Do **not** reach for an SVG data-URI; it\ncosts you a rasterised asset, a URI-encoding trap, and animatable geometry.\n\nA button, as a scene asset so the whole thing can be referenced and pressed as one unit:\n\n```json\n{ \"type\": \"scene\", \"scene\": {\n \"version\": \"1.0\",\n \"composition\": { \"width\": { \"$eval\": \"width\" }, \"height\": { \"$eval\": \"height\" }, \"duration\": 6, \"fps\": 30, \"background\": \"#00000000\" },\n \"parameters\": {\n \"width\": { \"type\": \"number\", \"default\": 560, \"min\": 300, \"max\": 1000 },\n \"height\": { \"type\": \"number\", \"default\": 104, \"min\": 80, \"max\": 200 }\n },\n \"layers\": [\n { \"id\": \"bg\", \"content\": { \"kind\": \"shape\", \"items\": [\n { \"type\": \"group\", \"contents\": [\n { \"type\": \"rect\", \"size\": [{ \"$eval\": \"width\" }, { \"$eval\": \"height\" }], \"position\": [0, 0], \"roundness\": { \"$eval\": \"height / 2\" } },\n { \"type\": \"fill\", \"color\": \"#111111ff\" } ] } ] },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } },\n { \"id\": \"lb\", \"content\": { \"kind\": \"text\", \"text\": \"Continue\",\n \"font\": { \"family\": \"helvetica-bold\", \"size\": 40 }, \"color\": \"#ffffffff\", \"alignment\": \"center\" },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } } ] } }\n```\n\nStore this as a scene asset and place a `scene_ref` with `fit:\"none\"`, binding `width`/`height`\non that reference. Animate the reference once for shared motion and opacity. The formulas resolve\nwhen the instance is assembled; after expanding/baking the reference, its geometry is concrete and\nlater parameter edits do not remain live. Re-resolve the source for a new size, or edit the expanded\ngeometry coherently. Shared centers prevent independent drift, not text overflow or optical imbalance.\n\n`roundness` is ONE number for all four corners — a `rect` has no per-corner radius,\nand neither does the `rounded_corners` look. Design around it rather than hunting for it.\n\nText is vertically centered on `transform.position.y`; it is not a baseline coordinate.\nUse the intended control center, without adding a guessed font-size/baseline correction.\nFor a centered label, check both its fit and its center against the control's intended layout.\nFor icon-plus-label layouts, establish the intended content region or group center rather than\nforcing every child to the button's horizontal center. An intentional optical offset should be\nexplicit and previewed with the actual font, not inferred from an already displaced label.\nRead the UI alignment reference linked from linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`)\nfor executable checks before calling the control validated. Through MCP, fetch `picsart_scene_recipe` for\n`linked-element-motion`, then its listed UI alignment reference. Cover alternate labels/states and\nrerun after copy, font, size or nesting changes; shared motion does not prove initial alignment.\n\n## The three beats\n\n### Scrolling content\n\nApply the `scroll` look to the layer holding the screen — a tall image, or a `scene_ref` to a\ncomposition of rows. The look makes the layer's own box the viewport and moves the content\nunder it; travel is the content's overflow, computed for you.\n\n```json\n\"looks\": [ { \"look\": \"scroll\",\n \"params\": { \"flicks\": 2, \"period\": 1.1, \"hold\": 0.35, \"decel\": 0.45, \"bounce\": 40, \"start\": 0.3 } } ]\n```\n\n`decel` is the momentum time constant: `0.5` is UIScrollView's normal deceleration rate,\n`0.1` its fast rate, `~0.25` approximates Android's spline fling. `hold` is the pause between\nflicks — without it the content is still creeping when the next flick fires and the cadence\nreads as a loop rather than a hand. `bounce` is the rubber band in px; set it to `0` for the\nAndroid feel, which has no rubber band.\n\nFor a **carousel**, add `snap` — the page length in px. Each flick then advances exactly one\npage, which is what a paged scroller does, and `flicks` counts pages. The rubber band is\nsuppressed automatically when the pages stop short of the travel.\n\nA nested composition keeps running its own animations while it scrolls, so a live screen\ninside a scrolling viewport works.\n\n### Press feedback\n\nApply the `tap_pulse` motion preset to the button layer (the `scene_ref`, so the whole widget\npresses rather than just its label).\n\n```\npicsart_scene_apply_preset { \"scene\": <scene>, \"layerId\": \"cta\", \"preset\": \"motionPreset:tap_pulse\", \"params\": { \"at\": 1.6 } }\n```\n\n`at` is seconds **into the layer's own window**, not into the composition — a tap lands\nmid-shot, so the preset does not assume the layer's first frame. Historical observations on a 560px\nbutton (not a portable benchmark: fixture/version/command were not retained beside this table):\n\n| t | width | scale |\n|---|---|---|\n| 1.60 | 560 | 1.000 |\n| 1.64 | 534 | 0.954 |\n| 1.72 | 566 | 1.011 |\n| 1.76 | 582 | 1.039 |\n| 1.84 | 560 | 1.000 |\n\nDown to `1 - amount` in the first 28% of `duration`, up through rest to a `1 + settle`\novershoot, then back. `settle: 0` snaps back flat — a mechanical switch rather than a finger.\nThe pop is a factor on the layer's own scale about its centre; move `transform.anchor` to\npress from somewhere else.\n\n### Cursor-led action\n\nFor reusable cursor styling, curved paths, direction and click feedback, or a variable-row context menu, read\n[Cursor actions and menus](references/cursor-actions.md). Through MCP, fetch `picsart_scene_recipe`\nwith `name: \"app-ui-animation\"` and `reference: \"references/cursor-actions.md\"`.\nIt separates appearance from choreography, defines the hotspot and click-tail clocks, and routes\narrival, pause, menu ownership, copy-fit and rendered checks. Do not rebuild a cursor per style.\nFor direction-following, prefer the position-direction expression in that reference, not an\nauto-orientation flag or independently duplicated rotation keyframes. One edited path should\nremain the source of both travel and heading; keep the glyph's forward-axis offset in its transform.\n\nFor a card transfer with source-list reflow, use [Drag, drop and list reflow](references/cursor-drag-drop.md).\nIt keeps the cursor attached by expression during carry and maps each phase to validation tools.\n\nWhen a walkthrough must show *why* the UI changed, author one causal chain around a shared event\ntime: **pointer arrives → control answers → result begins**. A visible pointer is an ordinary shape\nlayer; scene does not require or provide a special cursor primitive. Keep the pointer above the\nUI in layer order, move it to the action target, and hold it there long enough for the press and\nresult to read.\n\nUse the event time as a coordination point:\n\n- end the pointer's travel at the event;\n- begin the target's scale or color feedback at the event;\n- begin a restrained press ring at the event when the click would otherwise be ambiguous;\n- begin the result at the event, or shortly afterwards when intentional system latency is part of\n the story.\n\nThe exact travel time, pulse size, and latency are project trials, not scene rules. In the tested\nportrait construction, a pointer arrived at `1.0s`, the target compressed and a ring expanded at\n`1.0s`, and the result entered from `1.0–1.5s`. Those values prove one viable arrangement only.\n\nProtect the attention order. Before the event, the pointer should be the moving leader. At the\nevent, feedback belongs close to the target. After the event, settle the pointer and let the result\nbecome the leader. Avoid a looping cursor, a pulse that starts before arrival, or a result that is\nalready moving while the pointer is still travelling; each weakens causality.\n\nVerify at four moments: during approach, at arrival, immediately after the event, and after the\nresult settles. Use layout queries to confirm the pointer reaches the target, then preview or export\nthe continuous interval because correct timestamps do not prove readable causality. If the result\ncontinues into another scene or track seam, route the relationship and representation choice through\n`motion-scene-continuity`; this skill owns the device-like beat inside a scene.\n\n### Dragging and synchronized controls\n\nFor **grab → carry → release → pointer departure**, or a slider/readout driving another element,\nread [Drag and synchronized controls](references/drag-and-sync.md) before building the beat.\nThrough MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/drag-and-sync.md\"`. It covers phase-bounded attachment, off-center grip,\nshared progress, delayed clocks and negative-control checks. A click's shared event time alone does\nnot keep two moving subjects synchronized throughout a gesture.\n\n### Loading into readable content\n\nUse `scene://skeleton-reveal` for a variable-row loading card; use an ordinary opacity track\nwhen no placeholder structure or coordinated handoff is needed. Read\n[Loading reveal](references/loading-reveal.md) for customization, phase clocks and executable\nvalidation intent. Through MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/loading-reveal.md\"`. Shared layout prevents row drift, but does not\nprove text fits or that loading and reading phases are visibly distinct.\n\n### Frosted glass\n\nA frosted pane (glassmorphism) behind a card is one line: `looks: [{ look: \"frosted_glass\" }]`\non the card. The pane is the card's box, and moves, scales and fades with it; give a\n`scene_ref` widget `bounds` and a surface opacity below 1 so the frost shows through it. For a\npane that is not a rounded rect, write the two layers yourself: an `adjustmentLayer` shape\ncarrying `gaussian_blur`, and a translucent tint above it. They frost only content beneath them\non the same canvas, so they live as siblings or in an unsized `blending: \"pass_through\"`\ncomposition, never inside a `scene_ref` widget. Read\n[Frosted glass](references/frosted-glass.md) for the JSON, where it frosts nothing, and how\nto animate it; through MCP, `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/frosted-glass.md\"`.\n\n### A bottom sheet\n\nFour parts, none of which is a preset of its own:\n\n1. A **dim** — a `color` layer over the screen (`#000000a0`) with the `fade` look,\n `role: \"in\"`, `length` the rise.\n2. The **sheet** — a `scene_ref` to a composition of the sheet's own content, positioned so\n its bottom edge is flush with the frame bottom.\n3. The **rise** — the `slide` look with `role: \"in\"`, `direction: \"up\"` and `distance: 1`\n (one sheet height: `distance` is in multiples of the layer's own size).\n4. **`rounded_corners`** on the sheet. This rounds all four corners; placing its bottom exactly\n at the frame bottom does not hide the lower corner arcs. If only the top corners should show,\n extend the backing below the frame far enough to hide its lower arcs and inspect the crop.\n Update the expected bottom-edge contract to that extended backing's intended position.\n\nA look cannot supply the dim. A look's fragment is isolated to its own subject, so it can\npaint over the layer it is applied to but never over what sits below it — which is why a\nsheet is an arrangement and not a look.\n\n## Validate each UI beat\n\nFetch `picsart_scene_recipe motion-pattern-library` and its **Validation by pattern** reference.\nIts **UI beats** rows specify scroll/carousel,\npress, pointer, drag, synchronized controls, and sheet checks. Name the event and intended result before authoring, convert all\nchecks to root time, and test the whole widget owner plus its contents. A moving label inside a\nstationary backing is not a successful button press. A stationary viewport box does not prove its\ncontent scrolled. Layout contracts cannot prove dimming, clipping, or readable causality: inspect\nthose pixels and continuous playback, and report them separately from contract verdicts.\n\n## Frictions\n\n- **A layer with `start` and no `duration` gets the composition's FULL length, not the\n remainder.** `start: 1` in a 4s composition gives the layer `duration: 4` — a window that\n runs to 5s, of which the last second is outside the composition and never plays. The layer\n is live at 3.5s where a `duration: 2` twin has already ended, so a beat you meant to close\n before the end does not. The presets themselves are fine: `slide_in`, `fade_in` and\n `tap_pulse` bake identical keyframe times with and without a declared `duration`. Declare\n `duration` alongside `start`.\n- **Order the preset applies after the scene is final.** A motion preset bakes keyframes at\n apply time, so editing a layer's `start`/`duration` afterwards leaves stale times behind.\n Re-apply. A look reads the layer's window at render time and needs no re-apply.\n- **A `tap_pulse` on a text layer scales the label only.** Wrap the widget in a scene asset\n and pulse the `scene_ref` if you want the whole control to answer.\n""---\nname: app-ui-animation\ndescription: Build a phone or web UI in a scene with scrolling, carousels, button feedback, cursor paths and clicks, context menus, drag-and-drop, synchronized controls, bottom sheets and frosted-glass panels. Use when animating an app mockup, UI walkthrough, slider or onboarding flow, frosted glass or glassmorphism cards, or when a mock renders correctly but reads as a picture rather than an app somebody is using.\nmetadata:\n category: authoring\n version: '1.11'\n ported-from: ui-motion 1.11 at 55.75.0\n---\n\n# UI motion — making a mockup behave like a device\n\nA UI mock that renders correctly and still reads as a screenshot is almost always missing\nthree things: the content does not carry momentum, nothing answers a touch, and panels\nappear instead of arriving. Each has a home in the catalog. **Read this before authoring a\nnew preset for a UI beat — most UI beats are arrangements of what already exists.**\n\n## Where a UI beat belongs\n\nBefore choosing a preset, settle the semantic units and who owns their motion with\nlinked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`); it also\ncovers the ownership/binding/phase decision, growing panels and sibling reflow. Derive backing\ndimensions and child placement from shared parameters so a size edit preserves the layout by\nconstruction; grouping does not make a container automatically fit its animated children. Validate\nthose relationships throughout the event window.\n\n| Home | When |\n|---|---|\n| **Motion preset** or **Look** | Choose between them with motion-pattern-library (fetch with `picsart_scene_recipe`, name `motion-pattern-library`). Only a look adds structure the layer does not have — a viewport, a mask, extra layers (`scroll`, `rounded_corners`) |\n| **Scene template** | The motion depends on a layer's index or count (a list stagger, a grid) |\n| **This recipe** | No new capability — a known-good arrangement of the above |\n\nAnd before adding any of them: **prefer a param on an existing preset over a new preset.**\nPaged scrolling is `snap` on `scroll`, not a `carousel` look. A catalog that grows one entry\nper arrangement stops being scannable, and then finding costs more than building.\n\n## Build the chrome from shapes\n\nUI chrome is rectangles with rounded corners and text on top. Author it as `kind: \"shape\"` —\nit is built in. Do **not** reach for an SVG data-URI; it\ncosts you a rasterised asset, a URI-encoding trap, and animatable geometry.\n\nA button, as a scene asset so the whole thing can be referenced and pressed as one unit:\n\n```json\n{ \"type\": \"scene\", \"scene\": {\n \"version\": \"1.0\",\n \"composition\": { \"width\": { \"$eval\": \"width\" }, \"height\": { \"$eval\": \"height\" }, \"duration\": 6, \"fps\": 30, \"background\": \"#00000000\" },\n \"parameters\": {\n \"width\": { \"type\": \"number\", \"default\": 560, \"min\": 300, \"max\": 1000 },\n \"height\": { \"type\": \"number\", \"default\": 104, \"min\": 80, \"max\": 200 }\n },\n \"layers\": [\n { \"id\": \"bg\", \"content\": { \"kind\": \"shape\", \"items\": [\n { \"type\": \"group\", \"contents\": [\n { \"type\": \"rect\", \"size\": [{ \"$eval\": \"width\" }, { \"$eval\": \"height\" }], \"position\": [0, 0], \"roundness\": { \"$eval\": \"height / 2\" } },\n { \"type\": \"fill\", \"color\": \"#111111ff\" } ] } ] },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } },\n { \"id\": \"lb\", \"content\": { \"kind\": \"text\", \"text\": \"Continue\",\n \"font\": { \"family\": \"helvetica-bold\", \"size\": 40 }, \"color\": \"#ffffffff\", \"alignment\": \"center\" },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } } ] } }\n```\n\nStore this as a scene asset and place a `scene_ref` with `fit:\"none\"`, binding `width`/`height`\non that reference. Animate the reference once for shared motion and opacity. The formulas resolve\nwhen the instance is assembled; after expanding/baking the reference, its geometry is concrete and\nlater parameter edits do not remain live. Re-resolve the source for a new size, or edit the expanded\ngeometry coherently. Shared centers prevent independent drift, not text overflow or optical imbalance.\n\n`roundness` is ONE number for all four corners — a `rect` has no per-corner radius,\nand neither does the `rounded_corners` look. Design around it rather than hunting for it.\n\nText is vertically centered on `transform.position.y`; it is not a baseline coordinate.\nUse the intended control center, without adding a guessed font-size/baseline correction.\nFor a centered label, check both its fit and its center against the control's intended layout.\nFor icon-plus-label layouts, establish the intended content region or group center rather than\nforcing every child to the button's horizontal center. An intentional optical offset should be\nexplicit and previewed with the actual font, not inferred from an already displaced label.\nRead the UI alignment reference linked from linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`)\nfor executable checks before calling the control validated. Through MCP, fetch `picsart_scene_recipe` for\n`linked-element-motion`, then its listed UI alignment reference. Cover alternate labels/states and\nrerun after copy, font, size or nesting changes; shared motion does not prove initial alignment.\n\n## The three beats\n\n### Scrolling content\n\nApply the `scroll` look to the layer holding the screen — a tall image, or a `scene_ref` to a\ncomposition of rows. The look makes the layer's own box the viewport and moves the content\nunder it; travel is the content's overflow, computed for you.\n\n```json\n\"looks\": [ { \"look\": \"scroll\",\n \"params\": { \"flicks\": 2, \"period\": 1.1, \"hold\": 0.35, \"decel\": 0.45, \"bounce\": 40, \"start\": 0.3 } } ]\n```\n\n`decel` is the momentum time constant: `0.5` is UIScrollView's normal deceleration rate,\n`0.1` its fast rate, `~0.25` approximates Android's spline fling. `hold` is the pause between\nflicks — without it the content is still creeping when the next flick fires and the cadence\nreads as a loop rather than a hand. `bounce` is the rubber band in px; set it to `0` for the\nAndroid feel, which has no rubber band.\n\nFor a **carousel**, add `snap` — the page length in px. Each flick then advances exactly one\npage, which is what a paged scroller does, and `flicks` counts pages. The rubber band is\nsuppressed automatically when the pages stop short of the travel.\n\nA nested composition keeps running its own animations while it scrolls, so a live screen\ninside a scrolling viewport works.\n\n### Press feedback\n\nApply the `tap_pulse` motion preset to the button layer (the `scene_ref`, so the whole widget\npresses rather than just its label).\n\n```\npicsart_scene_apply_preset { \"scene\": <scene>, \"layerId\": \"cta\", \"preset\": \"motionPreset:tap_pulse\", \"params\": { \"at\": 1.6 } }\n```\n\n`at` is seconds **into the layer's own window**, not into the composition — a tap lands\nmid-shot, so the preset does not assume the layer's first frame. Historical observations on a 560px\nbutton (not a portable benchmark: fixture/version/command were not retained beside this table):\n\n| t | width | scale |\n|---|---|---|\n| 1.60 | 560 | 1.000 |\n| 1.64 | 534 | 0.954 |\n| 1.72 | 566 | 1.011 |\n| 1.76 | 582 | 1.039 |\n| 1.84 | 560 | 1.000 |\n\nDown to `1 - amount` in the first 28% of `duration`, up through rest to a `1 + settle`\novershoot, then back. `settle: 0` snaps back flat — a mechanical switch rather than a finger.\nThe pop is a factor on the layer's own scale about its centre; move `transform.anchor` to\npress from somewhere else.\n\n### Cursor-led action\n\nFor reusable cursor styling, curved paths, direction and click feedback, or a variable-row context menu, read\n[Cursor actions and menus](references/cursor-actions.md). Through MCP, fetch `picsart_scene_recipe`\nwith `name: \"app-ui-animation\"` and `reference: \"references/cursor-actions.md\"`.\nIt separates appearance from choreography, defines the hotspot and click-tail clocks, and routes\narrival, pause, menu ownership, copy-fit and rendered checks. Do not rebuild a cursor per style.\nFor direction-following, prefer the position-direction expression in that reference, not an\nauto-orientation flag or independently duplicated rotation keyframes. One edited path should\nremain the source of both travel and heading; keep the glyph's forward-axis offset in its transform.\n\nFor a card transfer with source-list reflow, use [Drag, drop and list reflow](references/cursor-drag-drop.md).\nIt keeps the cursor attached by expression during carry and maps each phase to validation tools.\n\nWhen a walkthrough must show *why* the UI changed, author one causal chain around a shared event\ntime: **pointer arrives → control answers → result begins**. A visible pointer is an ordinary shape\nlayer; scene does not require or provide a special cursor primitive. Keep the pointer above the\nUI in layer order, move it to the action target, and hold it there long enough for the press and\nresult to read.\n\nUse the event time as a coordination point:\n\n- end the pointer's travel at the event;\n- begin the target's scale or color feedback at the event;\n- begin a restrained press ring at the event when the click would otherwise be ambiguous;\n- begin the result at the event, or shortly afterwards when intentional system latency is part of\n the story.\n\nThe exact travel time, pulse size, and latency are project trials, not scene rules. In the tested\nportrait construction, a pointer arrived at `1.0s`, the target compressed and a ring expanded at\n`1.0s`, and the result entered from `1.0–1.5s`. Those values prove one viable arrangement only.\n\nProtect the attention order. Before the event, the pointer should be the moving leader. At the\nevent, feedback belongs close to the target. After the event, settle the pointer and let the result\nbecome the leader. Avoid a looping cursor, a pulse that starts before arrival, or a result that is\nalready moving while the pointer is still travelling; each weakens causality.\n\nVerify at four moments: during approach, at arrival, immediately after the event, and after the\nresult settles. Use layout queries to confirm the pointer reaches the target, then preview or export\nthe continuous interval because correct timestamps do not prove readable causality. If the result\ncontinues into another scene or track seam, route the relationship and representation choice through\n`motion-scene-continuity`; this skill owns the device-like beat inside a scene.\n\n### Dragging and synchronized controls\n\nFor **grab → carry → release → pointer departure**, or a slider/readout driving another element,\nread [Drag and synchronized controls](references/drag-and-sync.md) before building the beat.\nThrough MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/drag-and-sync.md\"`. It covers phase-bounded attachment, off-center grip,\nshared progress, delayed clocks and negative-control checks. A click's shared event time alone does\nnot keep two moving subjects synchronized throughout a gesture.\n\n### Loading into readable content\n\nUse `scene://skeleton-reveal` for a variable-row loading card; use an ordinary opacity track\nwhen no placeholder structure or coordinated handoff is needed. Read\n[Loading reveal](references/loading-reveal.md) for customization, phase clocks and executable\nvalidation intent. Through MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/loading-reveal.md\"`. Shared layout prevents row drift, but does not\nprove text fits or that loading and reading phases are visibly distinct.\n\n### Frosted glass\n\nA frosted pane (glassmorphism) behind a card is one line: `looks: [{ look: \"frosted_glass\" }]`\non the card. The pane is the card's box, and moves, scales and fades with it; give a\n`scene_ref` widget `bounds` and a surface opacity below 1 so the frost shows through it. For a\npane that is not a rounded rect, write the two layers yourself: an `adjustmentLayer` shape\ncarrying `gaussian_blur`, and a translucent tint above it. They frost only content beneath them\non the same canvas, so they live as siblings or in an unsized `blending: \"pass_through\"`\ncomposition, never inside a `scene_ref` widget. Read\n[Frosted glass](references/frosted-glass.md) for the JSON, where it frosts nothing, and how\nto animate it; through MCP, `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/frosted-glass.md\"`.\n\n### A bottom sheet\n\nFour parts, none of which is a preset of its own:\n\n1. A **dim** — a `color` layer over the screen (`#000000a0`) with the `fade` look,\n `role: \"in\"`, `length` the rise.\n2. The **sheet** — a `scene_ref` to a composition of the sheet's own content, positioned so\n its bottom edge is flush with the frame bottom.\n3. The **rise** — the `slide` look with `role: \"in\"`, `direction: \"up\"` and `distance: 1`\n (one sheet height: `distance` is in multiples of the layer's own size).\n4. **`rounded_corners`** on the sheet. This rounds all four corners; placing its bottom exactly\n at the frame bottom does not hide the lower corner arcs. If only the top corners should show,\n extend the backing below the frame far enough to hide its lower arcs and inspect the crop.\n Update the expected bottom-edge contract to that extended backing's intended position.\n\nA look cannot supply the dim. A look's fragment is isolated to its own subject, so it can\npaint over the layer it is applied to but never over what sits below it — which is why a\nsheet is an arrangement and not a look.\n\n## Validate each UI beat\n\nFetch `picsart_scene_recipe motion-pattern-library` and its **Validation by pattern** reference.\nIts **UI beats** rows specify scroll/carousel,\npress, pointer, drag, synchronized controls, and sheet checks. Name the event and intended result before authoring, convert all\nchecks to root time, and test the whole widget owner plus its contents. A moving label inside a\nstationary backing is not a successful button press. A stationary viewport box does not prove its\ncontent scrolled. Layout contracts cannot prove dimming, clipping, or readable causality: inspect\nthose pixels and continuous playback, and report them separately from contract verdicts.\n\n## Frictions\n\n- **A layer with `start` and no `duration` gets the composition's FULL length, not the\n remainder.** `start: 1` in a 4s composition gives the layer `duration: 4` — a window that\n runs to 5s, of which the last second is outside the composition and never plays. The layer\n is live at 3.5s where a `duration: 2` twin has already ended, so a beat you meant to close\n before the end does not. The presets themselves are fine: `slide_in`, `fade_in` and\n `tap_pulse` bake identical keyframe times with and without a declared `duration`. Declare\n `duration` alongside `start`.\n- **Order the preset applies after the scene is final.** A motion preset bakes keyframes at\n apply time, so editing a layer's `start`/`duration` afterwards leaves stale times behind.\n Re-apply. A look reads the layer's window at render time and needs no re-apply.\n- **A `tap_pulse` on a text layer scales the label only.** Wrap the widget in a scene asset\n and pulse the `scene_ref` if you want the whole control to answer.\n"Full snapshot data
{
"description": "Build a phone or web UI in a scene with scrolling, carousels, button feedback, cursor paths and clicks, context menus, drag-and-drop, synchronized controls, bottom sheets and frosted-glass panels. Use when animating an app mockup, UI walkthrough, slider or onboarding flow, frosted glass or glassmorphism cards, or when a mock renders correctly but reads as a picture rather than an app somebody is using.",
"included_files": [
{
"relative_path": "references/cursor-actions.md",
"size_in_bytes": 7113
},
{
"relative_path": "references/cursor-drag-drop.md",
"size_in_bytes": 3934
},
{
"relative_path": "references/drag-and-sync.md",
"size_in_bytes": 5763
},
{
"relative_path": "references/frosted-glass.md",
"size_in_bytes": 4807
},
{
"relative_path": "references/loading-reveal.md",
"size_in_bytes": 3757
}
],
"name": "app-ui-animation",
"skill_md_contents": "---\nname: app-ui-animation\ndescription: Build a phone or web UI in a scene with scrolling, carousels, button feedback, cursor paths and clicks, context menus, drag-and-drop, synchronized controls, bottom sheets and frosted-glass panels. Use when animating an app mockup, UI walkthrough, slider or onboarding flow, frosted glass or glassmorphism cards, or when a mock renders correctly but reads as a picture rather than an app somebody is using.\nmetadata:\n category: authoring\n version: '1.11'\n ported-from: ui-motion 1.11 at 55.75.0\n---\n\n# UI motion — making a mockup behave like a device\n\nA UI mock that renders correctly and still reads as a screenshot is almost always missing\nthree things: the content does not carry momentum, nothing answers a touch, and panels\nappear instead of arriving. Each has a home in the catalog. **Read this before authoring a\nnew preset for a UI beat — most UI beats are arrangements of what already exists.**\n\n## Where a UI beat belongs\n\nBefore choosing a preset, settle the semantic units and who owns their motion with\nlinked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`); it also\ncovers the ownership/binding/phase decision, growing panels and sibling reflow. Derive backing\ndimensions and child placement from shared parameters so a size edit preserves the layout by\nconstruction; grouping does not make a container automatically fit its animated children. Validate\nthose relationships throughout the event window.\n\n| Home | When |\n|---|---|\n| **Motion preset** or **Look** | Choose between them with motion-pattern-library (fetch with `picsart_scene_recipe`, name `motion-pattern-library`). Only a look adds structure the layer does not have — a viewport, a mask, extra layers (`scroll`, `rounded_corners`) |\n| **Scene template** | The motion depends on a layer's index or count (a list stagger, a grid) |\n| **This recipe** | No new capability — a known-good arrangement of the above |\n\nAnd before adding any of them: **prefer a param on an existing preset over a new preset.**\nPaged scrolling is `snap` on `scroll`, not a `carousel` look. A catalog that grows one entry\nper arrangement stops being scannable, and then finding costs more than building.\n\n## Build the chrome from shapes\n\nUI chrome is rectangles with rounded corners and text on top. Author it as `kind: \"shape\"` —\nit is built in. Do **not** reach for an SVG data-URI; it\ncosts you a rasterised asset, a URI-encoding trap, and animatable geometry.\n\nA button, as a scene asset so the whole thing can be referenced and pressed as one unit:\n\n```json\n{ \"type\": \"scene\", \"scene\": {\n \"version\": \"1.0\",\n \"composition\": { \"width\": { \"$eval\": \"width\" }, \"height\": { \"$eval\": \"height\" }, \"duration\": 6, \"fps\": 30, \"background\": \"#00000000\" },\n \"parameters\": {\n \"width\": { \"type\": \"number\", \"default\": 560, \"min\": 300, \"max\": 1000 },\n \"height\": { \"type\": \"number\", \"default\": 104, \"min\": 80, \"max\": 200 }\n },\n \"layers\": [\n { \"id\": \"bg\", \"content\": { \"kind\": \"shape\", \"items\": [\n { \"type\": \"group\", \"contents\": [\n { \"type\": \"rect\", \"size\": [{ \"$eval\": \"width\" }, { \"$eval\": \"height\" }], \"position\": [0, 0], \"roundness\": { \"$eval\": \"height / 2\" } },\n { \"type\": \"fill\", \"color\": \"#111111ff\" } ] } ] },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } },\n { \"id\": \"lb\", \"content\": { \"kind\": \"text\", \"text\": \"Continue\",\n \"font\": { \"family\": \"helvetica-bold\", \"size\": 40 }, \"color\": \"#ffffffff\", \"alignment\": \"center\" },\n \"transform\": { \"position\": [{ \"$eval\": \"width / 2\" }, { \"$eval\": \"height / 2\" }] } } ] } }\n```\n\nStore this as a scene asset and place a `scene_ref` with `fit:\"none\"`, binding `width`/`height`\non that reference. Animate the reference once for shared motion and opacity. The formulas resolve\nwhen the instance is assembled; after expanding/baking the reference, its geometry is concrete and\nlater parameter edits do not remain live. Re-resolve the source for a new size, or edit the expanded\ngeometry coherently. Shared centers prevent independent drift, not text overflow or optical imbalance.\n\n`roundness` is ONE number for all four corners — a `rect` has no per-corner radius,\nand neither does the `rounded_corners` look. Design around it rather than hunting for it.\n\nText is vertically centered on `transform.position.y`; it is not a baseline coordinate.\nUse the intended control center, without adding a guessed font-size/baseline correction.\nFor a centered label, check both its fit and its center against the control's intended layout.\nFor icon-plus-label layouts, establish the intended content region or group center rather than\nforcing every child to the button's horizontal center. An intentional optical offset should be\nexplicit and previewed with the actual font, not inferred from an already displaced label.\nRead the UI alignment reference linked from linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`)\nfor executable checks before calling the control validated. Through MCP, fetch `picsart_scene_recipe` for\n`linked-element-motion`, then its listed UI alignment reference. Cover alternate labels/states and\nrerun after copy, font, size or nesting changes; shared motion does not prove initial alignment.\n\n## The three beats\n\n### Scrolling content\n\nApply the `scroll` look to the layer holding the screen — a tall image, or a `scene_ref` to a\ncomposition of rows. The look makes the layer's own box the viewport and moves the content\nunder it; travel is the content's overflow, computed for you.\n\n```json\n\"looks\": [ { \"look\": \"scroll\",\n \"params\": { \"flicks\": 2, \"period\": 1.1, \"hold\": 0.35, \"decel\": 0.45, \"bounce\": 40, \"start\": 0.3 } } ]\n```\n\n`decel` is the momentum time constant: `0.5` is UIScrollView's normal deceleration rate,\n`0.1` its fast rate, `~0.25` approximates Android's spline fling. `hold` is the pause between\nflicks — without it the content is still creeping when the next flick fires and the cadence\nreads as a loop rather than a hand. `bounce` is the rubber band in px; set it to `0` for the\nAndroid feel, which has no rubber band.\n\nFor a **carousel**, add `snap` — the page length in px. Each flick then advances exactly one\npage, which is what a paged scroller does, and `flicks` counts pages. The rubber band is\nsuppressed automatically when the pages stop short of the travel.\n\nA nested composition keeps running its own animations while it scrolls, so a live screen\ninside a scrolling viewport works.\n\n### Press feedback\n\nApply the `tap_pulse` motion preset to the button layer (the `scene_ref`, so the whole widget\npresses rather than just its label).\n\n```\npicsart_scene_apply_preset { \"scene\": <scene>, \"layerId\": \"cta\", \"preset\": \"motionPreset:tap_pulse\", \"params\": { \"at\": 1.6 } }\n```\n\n`at` is seconds **into the layer's own window**, not into the composition — a tap lands\nmid-shot, so the preset does not assume the layer's first frame. Historical observations on a 560px\nbutton (not a portable benchmark: fixture/version/command were not retained beside this table):\n\n| t | width | scale |\n|---|---|---|\n| 1.60 | 560 | 1.000 |\n| 1.64 | 534 | 0.954 |\n| 1.72 | 566 | 1.011 |\n| 1.76 | 582 | 1.039 |\n| 1.84 | 560 | 1.000 |\n\nDown to `1 - amount` in the first 28% of `duration`, up through rest to a `1 + settle`\novershoot, then back. `settle: 0` snaps back flat — a mechanical switch rather than a finger.\nThe pop is a factor on the layer's own scale about its centre; move `transform.anchor` to\npress from somewhere else.\n\n### Cursor-led action\n\nFor reusable cursor styling, curved paths, direction and click feedback, or a variable-row context menu, read\n[Cursor actions and menus](references/cursor-actions.md). Through MCP, fetch `picsart_scene_recipe`\nwith `name: \"app-ui-animation\"` and `reference: \"references/cursor-actions.md\"`.\nIt separates appearance from choreography, defines the hotspot and click-tail clocks, and routes\narrival, pause, menu ownership, copy-fit and rendered checks. Do not rebuild a cursor per style.\nFor direction-following, prefer the position-direction expression in that reference, not an\nauto-orientation flag or independently duplicated rotation keyframes. One edited path should\nremain the source of both travel and heading; keep the glyph's forward-axis offset in its transform.\n\nFor a card transfer with source-list reflow, use [Drag, drop and list reflow](references/cursor-drag-drop.md).\nIt keeps the cursor attached by expression during carry and maps each phase to validation tools.\n\nWhen a walkthrough must show *why* the UI changed, author one causal chain around a shared event\ntime: **pointer arrives → control answers → result begins**. A visible pointer is an ordinary shape\nlayer; scene does not require or provide a special cursor primitive. Keep the pointer above the\nUI in layer order, move it to the action target, and hold it there long enough for the press and\nresult to read.\n\nUse the event time as a coordination point:\n\n- end the pointer's travel at the event;\n- begin the target's scale or color feedback at the event;\n- begin a restrained press ring at the event when the click would otherwise be ambiguous;\n- begin the result at the event, or shortly afterwards when intentional system latency is part of\n the story.\n\nThe exact travel time, pulse size, and latency are project trials, not scene rules. In the tested\nportrait construction, a pointer arrived at `1.0s`, the target compressed and a ring expanded at\n`1.0s`, and the result entered from `1.0–1.5s`. Those values prove one viable arrangement only.\n\nProtect the attention order. Before the event, the pointer should be the moving leader. At the\nevent, feedback belongs close to the target. After the event, settle the pointer and let the result\nbecome the leader. Avoid a looping cursor, a pulse that starts before arrival, or a result that is\nalready moving while the pointer is still travelling; each weakens causality.\n\nVerify at four moments: during approach, at arrival, immediately after the event, and after the\nresult settles. Use layout queries to confirm the pointer reaches the target, then preview or export\nthe continuous interval because correct timestamps do not prove readable causality. If the result\ncontinues into another scene or track seam, route the relationship and representation choice through\n`motion-scene-continuity`; this skill owns the device-like beat inside a scene.\n\n### Dragging and synchronized controls\n\nFor **grab → carry → release → pointer departure**, or a slider/readout driving another element,\nread [Drag and synchronized controls](references/drag-and-sync.md) before building the beat.\nThrough MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/drag-and-sync.md\"`. It covers phase-bounded attachment, off-center grip,\nshared progress, delayed clocks and negative-control checks. A click's shared event time alone does\nnot keep two moving subjects synchronized throughout a gesture.\n\n### Loading into readable content\n\nUse `scene://skeleton-reveal` for a variable-row loading card; use an ordinary opacity track\nwhen no placeholder structure or coordinated handoff is needed. Read\n[Loading reveal](references/loading-reveal.md) for customization, phase clocks and executable\nvalidation intent. Through MCP, fetch `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/loading-reveal.md\"`. Shared layout prevents row drift, but does not\nprove text fits or that loading and reading phases are visibly distinct.\n\n### Frosted glass\n\nA frosted pane (glassmorphism) behind a card is one line: `looks: [{ look: \"frosted_glass\" }]`\non the card. The pane is the card's box, and moves, scales and fades with it; give a\n`scene_ref` widget `bounds` and a surface opacity below 1 so the frost shows through it. For a\npane that is not a rounded rect, write the two layers yourself: an `adjustmentLayer` shape\ncarrying `gaussian_blur`, and a translucent tint above it. They frost only content beneath them\non the same canvas, so they live as siblings or in an unsized `blending: \"pass_through\"`\ncomposition, never inside a `scene_ref` widget. Read\n[Frosted glass](references/frosted-glass.md) for the JSON, where it frosts nothing, and how\nto animate it; through MCP, `picsart_scene_recipe` with `name: \"app-ui-animation\"` and\n`reference: \"references/frosted-glass.md\"`.\n\n### A bottom sheet\n\nFour parts, none of which is a preset of its own:\n\n1. A **dim** — a `color` layer over the screen (`#000000a0`) with the `fade` look,\n `role: \"in\"`, `length` the rise.\n2. The **sheet** — a `scene_ref` to a composition of the sheet's own content, positioned so\n its bottom edge is flush with the frame bottom.\n3. The **rise** — the `slide` look with `role: \"in\"`, `direction: \"up\"` and `distance: 1`\n (one sheet height: `distance` is in multiples of the layer's own size).\n4. **`rounded_corners`** on the sheet. This rounds all four corners; placing its bottom exactly\n at the frame bottom does not hide the lower corner arcs. If only the top corners should show,\n extend the backing below the frame far enough to hide its lower arcs and inspect the crop.\n Update the expected bottom-edge contract to that extended backing's intended position.\n\nA look cannot supply the dim. A look's fragment is isolated to its own subject, so it can\npaint over the layer it is applied to but never over what sits below it — which is why a\nsheet is an arrangement and not a look.\n\n## Validate each UI beat\n\nFetch `picsart_scene_recipe motion-pattern-library` and its **Validation by pattern** reference.\nIts **UI beats** rows specify scroll/carousel,\npress, pointer, drag, synchronized controls, and sheet checks. Name the event and intended result before authoring, convert all\nchecks to root time, and test the whole widget owner plus its contents. A moving label inside a\nstationary backing is not a successful button press. A stationary viewport box does not prove its\ncontent scrolled. Layout contracts cannot prove dimming, clipping, or readable causality: inspect\nthose pixels and continuous playback, and report them separately from contract verdicts.\n\n## Frictions\n\n- **A layer with `start` and no `duration` gets the composition's FULL length, not the\n remainder.** `start: 1` in a 4s composition gives the layer `duration: 4` — a window that\n runs to 5s, of which the last second is outside the composition and never plays. The layer\n is live at 3.5s where a `duration: 2` twin has already ended, so a beat you meant to close\n before the end does not. The presets themselves are fine: `slide_in`, `fade_in` and\n `tap_pulse` bake identical keyframe times with and without a declared `duration`. Declare\n `duration` alongside `start`.\n- **Order the preset applies after the scene is final.** A motion preset bakes keyframes at\n apply time, so editing a layer's `start`/`duration` afterwards leaves stale times behind.\n Re-apply. A look reads the layer's window at render time and needs no re-apply.\n- **A `tap_pulse` on a text layer scales the label only.** Wrap the widget in a scene asset\n and pulse the `scene_ref` if you want the whole control to answer.\n"
}SHA-256 of public snapshot: 1b06e901aa0a3010453ea35ff17567eb2920f6e996ff741d03eabd27c460751b