moda-video-motion

moda-core

moda doctor --json

moda brand list

stale_revision

moda ask "<question>"

Sizes and defaults

--category

animation

--format mp4 --page N

animation

animation

animation

• Keyframes and clip sequencing apply ONLY on

  --category animation

  ; on any other canvas every motion call is dropped with a warning. Animated shader fills move anywhere.
• Static exports (png/jpeg/pdf/pptx) of animation and video-filled nodes render BLANK or frozen — deliver mp4/gif, and say so if a still is requested.
• mp4/gif REQUIRE

  --page N

  : one animated page per file. A page with no animation rejects typed

  no_animation

  — the honest answer is a still + the link.
• Everything in this recipe is unmetered: iteration costs nothing.

Recipe — motion on a canvas

1. moda canvas create --name "[Piece]" --intent "[one-line brief]" --size [WxH] --pages 1 --category animation --brand [KIT]

   — send the link immediately.
2. Author the still frame FIRST — real type, brand geometry, layout:

   moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID]

   (references/markup.md). Motion on a bad frame is a bad piece that moves.

3. moda canvas screenshot [CANVAS_REF]

   — fix the frame before animating.
4. Add motion:

   moda canvas edit [CANVAS_REF] --file motion.js

   — a

   motion.page(...)

   program with tweens, effects, staggers and recipes. Shapes and named recipes (logo sting, animated stat, kinetic type, shader background) are in references/motion-recipes.md — author from it, don't probe.
5. Draft-judge the movement:

   moda export [CANVAS_REF] --format gif --page [N] -o draft.gif

   and look at it. A screenshot shows one frozen frame — it cannot tell you whether the motion works.
6. Deliver: live link FIRST, then

   moda export [CANVAS_REF] --format mp4 --page [N] -o [piece].mp4

   . Read

   warnings[]

   .

Recipe — footage under real type (timeline compositing)

1. Get the clip into team files:

   moda file upload [clip.mp4]

   , or reuse the durable

   file_…

   a generated render returned (moda-video-clip owns generation).
2. Animation canvas at the delivery size, then place the clip with

   <video src="file_…" width="1920" height="1080" fit="cover"/>

   via

   moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID]

   — the clip is a fill; layer type and brand marks above it.
3. Sequence and trim in

   moda canvas edit [CANVAS_REF] --file cut.js

   (

   t.video(node, { startMs })

   ; trim/rate/loop via

   update()

   — references/edit-code.md).

4. moda export [CANVAS_REF] --format mp4 --page [N] -o [piece].mp4

   , then read

   warnings[]

   : server mp4 muxes audible clip audio, and

   audio_source_dropped

   names anything that did not survive. Relay it — never a silent loss.

Examples

• "an animated banner ad, 300×250" → motion recipe at the ad's exact size → gif.
• "a stinger from our logo" → motion recipe,

  recipe-rise

  + a shader backdrop.
• "make this post move" → import/rebuild the frame on an animation canvas, then animate.
• "cut these two clips together with our headline over them" → compositing recipe.
• "a video from these 5 photos" → compositing recipe: place, sequence, export mp4.

Errors

no_animation

Make it recurring

References