Rendering and delivery
Run pnpm mg check <client>/<project> first; render only when it reports no issues.
Render
pnpm mg render <client>/<project> all shots
pnpm mg render <client>/<project> lt-ceo one shot
pnpm mg render <client>/<project> --force re-render even if unchanged
Output: renders/<shot>_v<NNN>.<ext>. Each render that changes pixels gets the next version; older versions stay. renders/manifest.json records the hash of everything that affects pixels (props, resolved tokens, font/logo/asset contents, preset, toolkit version, client template code). Unchanged shots are skipped.
Presets
| Preset | File | Use |
|---|---|---|
overlay (default) | ProRes 4444 .mov with alpha | Lower thirds, titles over footage in Resolve/Premiere/FCP |
delivery | H.264 .mp4, transparent areas black | Review links, full-frame graphics |
webm-alpha | VP9 .webm with alpha | Web players; most editors ignore WebM alpha |
Set per shot ("preset"), per project (project.json), or per run (--preset).
Deliver
When the user hands a project over (or says the graphics are final):
pnpm mg deliver <client>/<project> [shot…]
It renders what changed, verifies every file (alpha for overlay/webm-alpha, frame size, fps), freezes the project, and copies the finals to deliver/<YYYY-MM-DD>/<shot>.<ext>. If verification fails, nothing is frozen or copied; fix the reported problem and run it again. Tell the user the deliver/ folder path.
Frozen means: later house, client or variant edits do not change this project's renders.
Apply brand changes
After the user changes client or variant tokens (new colors, fonts, logos):
- Preview:
pnpm mg rebrand <client>(or<client>/<project>for one project). It changes nothing and lists, per project, what the current brand would change. Projects with"extends": "none"are skipped. - Show the list to the user and ask which to update: all of them, some projects, or none (new work only).
- Apply what they chose:
pnpm mg rebrand <client> --applyorpnpm mg rebrand <client>/<project> --applyper project. Frozen projects are re-locked to the current brand; every listed project re-renders into a new version. Old versions stay inrenders/. - Run
motion-qaon the new renders. For projects the user hands over again, runpnpm mg deliverto refreshdeliver/.
Not running rebrand is also a valid answer: frozen projects keep their delivered look, and only unfrozen projects follow the brand on their next render.
Other brand commands:
pnpm mg diff <client>/<project>: one project's differences from its lock (frozen) or last render (unfrozen).- A render of an unfrozen project whose brand changed since its last render prints a warning with the changes.
- Project-only token edits on a frozen project: edit
tokens.json, thenpnpm mg rebrand <client>/<project> --apply.
Failures
- Errors that name a prop, token, font or text width come from validation; fix the JSON, not the template.
pnpm mg checklists them all at once. - Browser launch, missing libraries, codec or path errors:
pnpm mg doctor.