Habilidad de Video de Demostración de Remotion
Esta habilidad ayuda a construir y mantener el video de demostración de Remotion ubicado en:
demos/wallrun-video
Proporciona estructura para:
- creación de escenas
- estructura de composición
- componentes de movimiento reutilizables
- ritmo de video
- explicaciones orientadas a desarrolladores
Esta habilidad debe usarse al trabajar en:
- composiciones de Remotion
- componentes de escena
- segmentos explicativos animados
- estructura o secuencia de video
- primitivas de movimiento utilizadas en la demostración
Contexto del proyecto
Este repositorio es un monorepo Nx.
El video de Remotion se encuentra en:
demos/wallrun-video
El proyecto renderiza un video explicativo orientado a desarrolladores para WallRun.
La audiencia son desarrolladores frontend, no especialistas en marketing.
Se asume que el espectador entiende:
- React
- TypeScript
- arquitectura de componentes
- sistemas de diseño
- herramientas para desarrolladores
Evitar explicar conceptos básicos de JavaScript.
Intención de diseño
El video debe sentirse como contenido para desarrolladores, no como un anuncio de producto.
Buen tono:
- editorial
- minimalista
- moderno
- confiado
- movimiento moderado
Mal tono:
- promoción genérica de SaaS
- efectos cinematográficos de tráiler
- animaciones pesadas de partículas
- texto denso de marketing
Priorizar:
- legibilidad
- jerarquía
- ritmo
- claridad
Estructura del proyecto
Todo el código debe residir dentro de:
demos/wallrun-video/src
Estructura:
- components/ — Primitivas de presentación reutilizables
- scenes/ — Secciones temporizadas del video
- data/ — Guión, texto, constantes de tiempo
- Root.tsx — Registra composiciones
- index.ts — Archivo de entrada para la CLI de Remotion
Reglas de diseño de escenas
Cada escena debe comunicar una sola idea.
Duración típica: 4–8 segundos
Las escenas deben:
- leerse rápidamente
- tener tipografía grande
- evitar el desorden
- mantener el movimiento sutil
Tipos de escena preferidos:
- tarjetas de título
- capturas de pantalla del repositorio en escena
- primeros planos de componentes
- superposiciones de llamadas
- diagramas de arquitectura
- paneles de estadísticas
Evitar:
- interfaces de usuario pequeñas
- párrafos largos
- transiciones demasiado complejas
Pautas de animación
Prefiere animaciones deterministas simples.
Ejemplos:
- aparición gradual
- deslizamiento hacia arriba
- revelación escalonada
- escala sutil
Evitar:
- efectos de rebote
- movimiento físico complejo
- curvas de aceleración pesadas
El objetivo es la claridad, no el espectáculo.
Convenciones de codificación
Usar:
- componentes funcionales de React
- TypeScript
- exportaciones nombradas
- tipos explícitos
- envoltorios de movimiento reutilizables
Evitar:
- código de animación duplicado
- números mágicos
- tiempos de escena codificados
Extraer constantes de tiempo cuando sea práctico.
Ejemplo:
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
Flujo de trabajo predeterminado para crear una nueva escena
- Definir el mensaje de la escena
- Definir la duración en fotogramas
- Diseñar el diseño
- Agregar movimiento primario
- Agregar movimiento secundario solo si mejora la claridad
- Verificar la legibilidad
- Asegurarse de que el código sea reutilizable
Objetivos Nx
- preview —
nx preview wallrun-videoabre Remotion Studio - render —
nx render wallrun-videorenderiza el video completo endist/demos/wallrun-video/ - type-check —
nx type-check wallrun-videoejecuta el compilador de TypeScript
Definición de completado
Una escena está completa cuando:
- el mensaje es inmediatamente claro
- la tipografía se lee a escala de video
- la animación es moderada
- los tiempos son fáciles de editar
- el código está estructurado de forma limpia