Workspace Motion
Este workspace renderiza motion graphics repetíveis com Remotion através da CLI mg (pnpm mg <comando>). Os designs são código em templates; cada valor específico de job vive em JSON. Uma alteração de texto, cor ou fonte é uma edição em JSON mais pnpm mg render, nunca uma alteração de código.
Layout
mg.json padrões de vídeo do workspace (fps, tamanho)
brand/house.tokens.json tokens da casa: cores base, fontes, easing, durações, áreas seguras
brand/fonts/ brand/logos/ arquivos referenciados pelos tokens da casa
clients/<cliente>/
client.json nome de exibição, sobrescrita de vídeo opcional
brand/tokens.json sobrescritas do cliente (deep-merge sobre a casa)
brand/fonts/ brand/logos/
brand/variants/<variante>/ look alternativo nomeado reutilizado por vários projetos: tokens.json, fonts/, logos/
templates/<nome>/index.tsx templates exclusivos do cliente, id "<cliente>/<nome>"
projects/<projeto>/
project.json { title?, extends?: "client"|"none", brand?: "<variante>", video?, preset? }
tokens.json sobrescritas apenas do projeto (opcional)
tokens.lock.json presente quando congelado: renders ignoram a cadeia ativa
fonts/ logos/ assets/ arquivos do projeto; props referenciam assets como "asset:<caminho>"
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ saída, ignorada pelo git; manifest.json rastreia versões
O código do toolkit (engine, templates da casa, estas skills) vive em node_modules/motion-toolkit, fixado por package.json. Nunca edite lá; alterações em templates da casa vão para o repositório do toolkit.
Templates da Casa
Cada template da casa tem uma prop look: minimal (limpo, pesos leves, blur-rise, sem painéis), bold (tipografia pesada em maiúsculas, blocos de cor sólida, spring pop), corporate (painéis, barras de destaque, revelações com máscara). O padrão "brand" usa o token look, então um cliente define seu estilo uma vez em brand/tokens.json ("look": "minimal").
| Id | Uso |
|---|---|
lower-third | Faixa de nome e título, logotipo opcional |
title-card | Título de capítulo ou seção, opcional kicker e subtítulo; sobreposição ou tela cheia |
callout | Linha de um ponto na filmagem (x, y como frações do quadro) até um rótulo |
end-card | Cartão de encerramento: logotipo, manchete, CTA, URL, 0–2 slots de tela final do YouTube |
kinetic-text | Citação ou afirmação revelada palavra por palavra; *palavra* enfatiza |
logo-sting | Breve animação de logotipo (abertura/encerramento) |
counter | Número contando para cima (value, prefix, suffix, decimals) com um rótulo |
social-handle | Ícone da plataforma mais @handle em um canto (YouTube, Instagram, TikTok, X, LinkedIn, …) |
typewriter | Texto digitado tecla por tecla com sons de máquina de escrever ou teclado no áudio do render |
corner-branding | Marca d'água persistente do logotipo em qualquer canto, tag opcional como AO VIVO |
pnpm mg new-shot … --template <id> escreve cada prop com seu padrão. O significado de cada prop está em seu texto .describe() em node_modules/motion-toolkit/templates/<id>/index.tsx.
Cadeia de Tokens
toolkit → casa → cliente → variante (se project.json "brand") → project tokens.json → shot props. A camada do toolkit fornece apenas padrões (o look, uma fonte mono, sounds de digitação). Objetos mesclam chave por chave, null deleta uma chave herdada, e a camada mais específica vence. "extends": "none" pula cliente e variante. Arquivos de fonte, logotipo e som são encontrados na pasta fonts/, logos/ ou sounds/ da camada mais específica que os possui.
Regras
- Todo valor visível vem de props de shot ou tokens. Sem cores, fontes, tamanhos em px sem uma prop, ou temporizações hard-coded em templates.
- Projetos contêm dados, não código. Um novo design é um template; um novo job é um projeto com arquivos de shot.
- Coloque um valor na camada mais baixa que o possui: um shot → props do shot; um projeto →
tokens.jsondo projeto; vários projetos de um cliente → uma variante; o cliente inteiro → tokens do cliente. - Nunca edite
tokens.lock.jsonmanualmente. Projetos entregues são congelados; eles mudam apenas através demg rebrand(vejamotion-render). - Após cada edição de JSON ou template, execute
pnpm mg checke corrija o que ele relatar antes de renderizar. - Finalize cada alteração visual com o procedimento
motion-qaantes de reportá-la como concluída. - Pergunte ao usuário antes de
mg rebrand --applye antes de editar tokens de cliente ou variante usados por projetos congelados. - Se um render ou verificação de doctor falhar, execute
pnpm mg doctorantes de alterar código.
Roteamento
| Tarefa | Leia |
|---|---|
| Novo cliente, variante, logotipo, fonte, paleta de cores | motion-brand |
| Novo projeto ou shots a partir de um briefing; alterar texto/cores em shots existentes | motion-project |
| Novo template ou uma alteração em como um template anima | motion-template, depois motion-style |
| Sensação de movimento: easing, timing, stagger, áreas seguras | motion-style |
| Renderização, presets, versões, entrega, aplicação de alterações de marca | motion-render |
| Verificação da saída antes de entregar | motion-qa |
Comandos
pnpm mg templates lista ids de templates
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <cliente>/<projeto> <shot> --template <id> arquivo de shot com todas as props nos padrões
pnpm mg new-template <cliente> <nome> template inicial
pnpm mg check [<cliente> | <cliente>/<projeto>] valida tudo sem renderizar
pnpm mg render <cliente>/<projeto> [shot…] pula shots não alterados; --force, --preset
pnpm mg still <cliente>/<projeto> [shot…] revisa PNGs em um tabuleiro de damas (todos os shots por padrão)
pnpm mg studio <cliente>/<projeto> pré-visualização ao vivo; "Save" do Studio escreve o arquivo de shot
pnpm mg deliver <cliente>/<projeto> renderiza, verifica, congela, copia finais para deliver/<data>/
pnpm mg rebrand <cliente | cliente/projeto> [--apply] alterações de marca para trabalho entregue
pnpm mg freeze|unfreeze|diff <cliente>/<projeto>
pnpm mg doctor ambiente, mg check, render de teste