## Complete starter and edit recipes

This self-contained document needs no media or fonts and shows one rounded plate for two seconds. A background layer you add needs a larger `ind` than the plate: array position does not decide stacking.

```json
{"v":"5.12.2","nm":"Plate example","w":640,"h":360,"fr":30,"ip":0,"op":60,"ddd":0,"assets":[],"layers":[{"ty":4,"ind":1,"nm":"Plate","ddd":0,"sr":1,"ip":0,"op":60,"st":0,"bm":0,"ao":0,"ks":{"a":{"a":0,"k":[0,0,0]},"p":{"a":0,"k":[320,180,0]},"s":{"a":0,"k":[100,100,100]},"r":{"a":0,"k":0},"o":{"a":0,"k":100}},"shapes":[{"ty":"gr","nm":"Plate geometry","it":[{"ty":"rc","nm":"Rectangle","d":1,"p":{"a":0,"k":[0,0]},"s":{"a":0,"k":[280,100]},"r":{"a":0,"k":16}},{"ty":"fl","nm":"Blue","r":1,"c":{"a":0,"k":[0.1,0.3,0.8,1]},"o":{"a":0,"k":100}},{"ty":"tr","p":{"a":0,"k":[0,0]},"a":{"a":0,"k":[0,0]},"s":{"a":0,"k":[100,100]},"r":{"a":0,"k":0},"o":{"a":0,"k":100},"sk":{"a":0,"k":0},"sa":{"a":0,"k":0}}]}]}]}
```

To move the plate 40 pixels right and make it red, change `layers[0].ks.p.k` to `[360,180,0]` and the fill's `c.k` to `[0.8,0.2,0.1,1]`. Send the whole edited `data.json` in an edit, with the head you read as `expectedHeadVersionId`.

| Edit | How |
| --- | --- |
| Copy | Replace the first text document's `t`. Keep `nm`, font, transform, timing and animators. Check that the new glyphs fit the existing region. |
| Color | Replace a solid's `sc`, a text document's `fc` or `sc`, a paint's `c`, gradient RGB entries, or a supported effect's color parameter. Keep each in its own representation, and keep alpha and stop positions. |
| Animated movement | Add the same local-space distance to every authored position endpoint, keeping all times and easing. Handle separated dimensions and expressions explicitly. |
| Restack | Change the `ind` values (array order does not stack), then update `parent`, `tp` and index-based expressions in that composition. |
| Extend a scene | Adjust the root and layer `op` values, the relevant nested intervals and final holds, without changing time-remap data in seconds. Extending only the root `op` can leave a blank tail. |
| Resize | Update the canvas size, and deliberately recompose content, precomposition extents, masks, crop and text fitting. Changing only `w` and `h` is not a layout adaptation. Effect points on text and shape layers are composition pixels ([effect coordinates](#effect-coordinates)). Move or scale such a layer together with its effect points, or its colors shift. That covers Gradient Ramp, 4-Color Gradient, Corner Pin, Light Sweep, Radial Blur and Light Rays. |
| Add a shape | Add complete geometry, paint, transform, a unique identity and timing. A lone appended path does not render. |
| Replace an asset | Add the new file, then account for its real size and visible bounds, keeping the requested motion. |
