Plantillas
Una plantilla es un diseño reutilizable. Lee únicamente props de plano y tokens resueltos, y nada más. Lee motion-style antes de elegir tiempos o easing. Para detalles de la API de Remotion, usa las habilidades de Remotion si están instaladas (npx remotion skills add) o consulta https://www.remotion.dev/docs.
Dónde va
- Específico del cliente: empieza con
pnpm mg new-template <cliente> <nombre>. Crea un esqueleto funcional enclients/<cliente>/templates/<nombre>/index.tsx(id<cliente>/<nombre>) que sigue el contrato de abajo; reemplaza su diseño. - Casa (todos los clientes):
templates/<nombre>/index.tsxen el repositorio motion-toolkit, registrado entemplates/index.ts, lanzado con una nueva versión del toolkit. No escribas ennode_modules.
Antes de escribir código de animación, propón el esquema (las props que el usuario podrá modificar sin un agente) y confírmalo con el usuario.
Contrato
import { interpolate, useCurrentFrame } from "remotion";
import { z } from "zod";
import { color, defineTemplate, font, motion, px, safeArea } from "motion-toolkit/engine";
const schema = z.object({
headline: z.string().min(1).default("Headline"),
holdSeconds: z.number().positive().default(3),
accent: z.string().default("accent").describe("Nombre del token de color o #hex"),
});
export const template = defineTemplate({
title: "Tarjeta de título",
schema,
durationSeconds: ({ props, tokens }) => {
const m = motion(tokens, 1);
return m.seconds("enter") + props.holdSeconds + m.seconds("exit");
},
check: ({ props, tokens }) => {
color(tokens, props.accent); // lanza error si el token no existe; se ejecuta en `mg check`
},
component: ({ props, tokens, video }) => {
const frame = useCurrentFrame();
const m = motion(tokens, video.fps);
// ...
},
});
Requisitos:
- Exporta
template(plantillas del cliente) creado condefineTemplate. - Cada campo del esquema tiene un
.default()para que nuevos planos y el Studio comiencen con valores válidos. Añade.describe()para el formulario del Studio. - Colores mediante
color(tokens, nombreOHex), fuentes mediantefont(tokens, rol), duraciones y easing mediantemotion(tokens, fps), posiciones dentro desafeArea(tokens, video), tamaños mediantepx(tamañoEn1080, video). - Anima solo con
useCurrentFrame()yinterpolate/spring. Sin transiciones CSS,setTimeout,Date.now()oMath.random()(usarandom(semilla)de remotion). Los renders deben ser idénticos cada vez. - Deja el fondo transparente a menos que la plantilla sea a pantalla completa; los terceros inferiores y superposiciones renderizan con alfa. Todos los elementos deben desaparecer en el último fotograma.
- Falla de forma ruidosa: lanza un
Errorcon una pista de solución cuando el texto no quepa o falte un token. UsaassertFits/wrapLinesdel motor; miden con la fuente cargada y lanzan error en desbordamiento. - Las props que nombran tokens (colores, logos, fuentes, sonidos) se validan en
checkconcheckRefs, para quemg checkdetecte errores tipográficos antes de renderizar. durationSecondsycheckse ejecutan en Node (mg check) y antes de cargar fuentes: nunca midas texto allí.- Imágenes y logos:
<Img src={staticFile(tokens.logos[nombre])} />ostaticFile(props.algunAsset). Sonidos:<Html5Audio src={staticFile(archivo)} />dentro de un<Sequence from={fotograma}>, archivos detokens.sounds[nombre]. El CLI gestiona los archivos.
Looks
Las plantillas de casa, y las plantillas de cliente diseñadas para coincidir con ellas, reciben look: lookSchema y lo resuelven con resolveLook(props.look, tokens). Constrúyelas a partir de los helpers compartidos para que los tres looks se mantengan consistentes (consulta motion-style):
choreo(tokens, look, fps)proporcionabeat(frame, index, exitStart, steps)→{ inP, outP }para cada elemento en orden de entrada;choreoSeconds(...)da la duración correspondiente.reveal(look, beat, video)es el estilo de entrada del look para un elemento (enciérralo enoverflow: hiddenparacorporate).typo(tokens, look, "display" | "title" | "body" | "label", size)es el estilo tipográfico del look;onColor(hex)elige texto legible sobre un bloque de color;cornerPlacement(corner, inset)posiciona gráficos en las esquinas.
Lee una plantilla de casa como node_modules/motion-toolkit/templates/title-card/index.tsx como ejemplo práctico.
Verificar
pnpm mg new-shot <cliente>/<proyecto> <plano> --template <cliente>/<nombre>en un proyecto de prueba, más un segundo plano con el texto realista más largo.pnpm mg check <cliente>/<proyecto>.pnpm mg still <cliente>/<proyecto> <plano>y mira los fotogramas. Luegopnpm mg render.- Sigue
motion-qa.
Trabajar desde un clip de referencia
Cuando el usuario proporcione un video de referencia, extrae fotogramas antes de diseñar. Crea renders/reference/ primero; el ffmpeg incluido es una compilación mínima sin filtros, así que usa -r para la tasa de fotogramas:
pnpm mg ffmpeg -i referencia.mp4 -r 10 renders/reference/f_%03d.png
Describe a partir de los fotogramas qué se mueve, en qué orden, cuánto dura cada fase (cuenta fotogramas a 10 fps) y la sensación del easing. Confirma ese desglose con el usuario, luego mapealo a tokens: duraciones a motion.durations, curvas a motion.easings.