Espacio de trabajo Motion
Este espacio de trabajo renderiza gráficos animados repetibles con Remotion a través del CLI mg (pnpm mg <comando>). Los diseños son código en plantillas; cada valor específico de un trabajo vive en JSON. Un cambio de texto, color o fuente es una edición JSON más pnpm mg render, nunca un cambio de código.
Estructura
mg.json valores por defecto del video del espacio de trabajo (fps, tamaño)
brand/house.tokens.json tokens de casa: colores base, fuentes, easing, duraciones, áreas seguras
brand/fonts/ brand/logos/ archivos a los que hacen referencia los tokens de casa
clients/<cliente>/
client.json nombre visible, opcional anulación de video
brand/tokens.json anulaciones del cliente (fusión profunda sobre la casa)
brand/fonts/ brand/logos/
brand/variants/<variante>/ look alternativo con nombre reutilizado por varios proyectos: tokens.json, fonts/, logos/
templates/<nombre>/index.tsx plantillas solo del cliente, id "<cliente>/<nombre>"
projects/<proyecto>/
project.json { title?, extends?: "client"|"none", brand?: "<variante>", video?, preset? }
tokens.json anulaciones solo del proyecto (opcional)
tokens.lock.json presente cuando está congelado: los renders ignoran la cadena activa
fonts/ logos/ assets/ archivos del proyecto; las props referencian assets como "asset:<ruta>"
shots/<toma>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ salida, ignorado por git; manifest.json rastrea versiones
El código del toolkit (motor, plantillas de casa, estas skills) vive en node_modules/motion-toolkit, fijado por package.json. Nunca lo edites ahí; los cambios en plantillas de casa van al repositorio del toolkit.
Plantillas de casa
Cada plantilla de casa tiene una prop look: minimal (limpio, pesos ligeros, difuminado ascendente, sin paneles), bold (tipografía pesada en mayúsculas, bloques de color sólido, pop con resorte), corporate (paneles, barras de acento, revelaciones con máscara). El valor por defecto "brand" usa el token look, así que un cliente establece su estilo una vez en brand/tokens.json ("look": "minimal").
| Id | Uso |
|---|---|
lower-third | Nombre y título, logo opcional |
title-card | Título de capítulo o sección, opcional anticipo y subtítulo; superposición o pantalla completa |
callout | Línea desde un punto en el metraje (x, y como fracciones del fotograma) hasta una etiqueta |
end-card | Tarjeta de cierre: logo, titular, CTA, URL, 0–2 ranuras de pantalla final de YouTube |
kinetic-text | Cita o declaración revelada palabra por palabra; *palabra* enfatiza |
logo-sting | Animación corta de logo (intro/outro) |
counter | Número contando hacia arriba (value, prefix, suffix, decimals) con una etiqueta |
social-handle | Icono de plataforma más @handle en una esquina (YouTube, Instagram, TikTok, X, LinkedIn, …) |
typewriter | Texto escrito tecla por tecla con sonidos de máquina de escribir o teclado en el audio del render |
corner-branding | Una marca persistente en cualquier esquina, etiqueta opcional como EN VIVO |
pnpm mg new-shot … --template <id> escribe cada prop con su valor por defecto. El significado de cada prop está en su texto .describe() en node_modules/motion-toolkit/templates/<id>/index.tsx.
Cadena de tokens
toolkit → casa → cliente → variante (si project.json tiene "brand") → project tokens.json → props de toma. La capa del toolkit solo proporciona valores por defecto (el look, una fuente mono, sounds de escritura). Los objetos se fusionan clave por clave, null elimina una clave heredada, y la capa más específica gana. "extends": "none" omite cliente y variante. Los archivos de fuente, logo y sonido se buscan en la carpeta fonts/, logos/ o sounds/ de la capa más específica que los tenga.
Reglas
- Cada valor visible proviene de props de toma o tokens. Sin colores, fuentes, tamaños en px sin una prop, o tiempos fijos en las plantillas.
- Los proyectos contienen datos, no código. Un nuevo diseño es una plantilla; un nuevo trabajo es un proyecto con archivos de toma.
- Coloca un valor en la capa más baja que lo posea: una toma → props de toma; un proyecto →
tokens.jsondel proyecto; varios proyectos de un cliente → una variante; todo el cliente → tokens del cliente. - Nunca edites
tokens.lock.jsona mano. Los proyectos entregados están congelados; solo cambian mediantemg rebrand(vermotion-render). - Después de cada edición de JSON o plantilla, ejecuta
pnpm mg checky corrige lo que informe antes de renderizar. - Termina cada cambio visual con el procedimiento
motion-qaantes de reportarlo como completado. - Pregunta al usuario antes de
mg rebrand --applyy antes de editar tokens de cliente o variante usados por proyectos congelados. - Si falla un render o una verificación doctor, ejecuta
pnpm mg doctorantes de cambiar código.
Ruta
| Tarea | Leer |
|---|---|
| Nuevo cliente, variante, logo, fuente, paleta de colores | motion-brand |
| Nuevo proyecto o tomas desde un briefing; cambiar texto/colores en tomas existentes | motion-project |
| Nueva plantilla o cambio en cómo anima una plantilla | motion-template, luego motion-style |
| Sensación de movimiento: easing, timing, stagger, áreas seguras | motion-style |
| Renderizado, presets, versiones, entrega, aplicación de cambios de marca | motion-render |
| Verificación de la salida antes de entregarla | motion-qa |
Comandos
pnpm mg templates listar ids de plantillas
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <cliente>/<proyecto> <toma> --template <id> archivo de toma con todas las props en valores por defecto
pnpm mg new-template <cliente> <nombre> plantilla inicial
pnpm mg check [<cliente> | <cliente>/<proyecto>] validar todo sin renderizar
pnpm mg render <cliente>/<proyecto> [toma…] omite tomas sin cambios; --force, --preset
pnpm mg still <cliente>/<proyecto> [toma…] revisar PNGs sobre un tablero de ajedrez (todas las tomas por defecto)
pnpm mg studio <cliente>/<proyecto> vista previa en vivo; el botón "Guardar" del Studio escribe el archivo de toma
pnpm mg deliver <cliente>/<proyecto> renderizar, verificar, congelar, copiar finales a deliver/<fecha>/
pnpm mg rebrand <cliente | cliente/proyecto> [--apply] cambios de marca para trabajos entregados
pnpm mg freeze|unfreeze|diff <cliente>/<proyecto>
pnpm mg doctor entorno, mg check, render de prueba