Communitygithub.com

vibe-motion/skills

Crea gráficos de velas (candlestick) financieros animados en proyectos Remotion. Incluye obtención de datos (Yahoo Finance), arquitectura de plugins (config/timeline/Scene/plugin), renderizado por fotograma en Canvas, estilo de terminal de trading oscuro, y vista previa y exportación con Remotion Studio.

¿Qué es skills?

Esta skill permite a desarrolladores crear animaciones de gráficos de velas financieras (candlestick) utilizando Remotion, el framework de vídeo programático basado en React. Está diseñada para el proyecto `vibe-motion-app` y sigue una arquitectura modular de plugins que separa la configuración, la línea de tiempo, el componente de escena y el registro del plugin. La skill cubre desde la obtención de datos históricos OHLC de Yahoo Finance (sin necesidad de API Key) hasta el renderizado final en vídeo MP4, pasando por el dibujo eficiente en Canvas con soporte para alta resolución (DPR). Incluye animaciones de aparición progresiva de velas, colores de mercado (rojo para velas alcistas, verde para bajistas) y un estilo visual de terminal de trading oscuro. Es compatible con las plataformas de Remotion Studio (previsualización interactiva) y renderizado por línea de comandos. El flujo de trabajo se apoya en `pnpm` como gestor de paquetes y utiliza hooks como `delayRender` para la carga asíncrona de datos. Es ideal para creadores de contenido financiero, traders o cualquier desarrollador que quiera generar vídeos animados de mercados bursátiles con alta calidad visual y rendimiento.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vibe-motion/skills/tree/HEAD/remotion-candlestick

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Proceso de creación de animación de velas (Candlestick) en Remotion

Esta skill documenta el proceso completo de creación de un gráfico de velas del S&P 500 en el proyecto Remotion vibe-motion-app.

Requisitos previos

  • Proyecto Remotion 4.0.438 con React 19 + TailwindCSS v4
  • Arquitectura de plugins: motion/ define escenas, remotion/ maneja la tubería de composición de Remotion
  • pnpm como gestor de paquetes

Paso 1: Obtener datos financieros

Yahoo Finance proporciona datos OHLC históricos gratuitos (sin necesidad de clave API).

Crear scripts/fetch-sp500-data.mjs:

// Núcleo: llamar a la API de Yahoo Finance Chart
const url = `https://query1.finance.yahoo.com/v8/finance/chart/%5EGSPC?period1=${PERIOD1}&period2=${PERIOD2}&interval=1wk`;
const resp = await fetch(url);
const json = await resp.json();
const result = json.chart?.result?.[0];
const ts = result.timestamp;
const quote = result.indicators.quote[0];
// Extraer { t: timestamp, o: open, h: high, l: low, c: close }

Guardar en public/data/sp500-weekly.json, para que Remotion lo cargue mediante staticFile().

Parámetros:

  • %5EGSPC = Símbolo de Yahoo para el S&P 500 (^GSPC codificado como URL)
  • interval=1wk = Semanal; opciones: 1d, 1mo
  • period1 / period2 = Marcas de tiempo Unix, cubriendo aproximadamente 40 años (1984-2026)

Paso 2: Crear la estructura de archivos del plugin

Cada plugin de Remotion necesita 4 archivos principales + una preconfiguración de renderizado:

motion/nombre-del-plugin/
  config.js                 → Parámetros por defecto
  timeline.js               → Contexto de escena + cálculo de animación fotograma a fotograma
  Scene.jsx                 → Componente React (dibujo en Canvas)
  plugin.js                 → Objeto de registro del plugin
  render-presets/
    default.json            → Preconfiguración de renderizado

2a. config.js — Parámetros por defecto

export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
  videoWidth: 1920,    // 16:9 horizontal
  videoHeight: 1080,
});

export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
  durationSeconds: 28,  // Duración total de la animación
  title: "S&P 500",
  subtitle: "Últimos 40 años · Velas semanales",
});

export const DEFAULT_MOTION_PROPS = Object.freeze({
  ...DEFAULT_LAYOUT_PARAMS,
  ...DEFAULT_ANIMATION_PARAMS,
});

2b. timeline.js — Lógica de animación

Debe implementar tres funciones principales:

// 1. Contexto de escena: validar + forzar conversión de tipos de todos los parámetros
export const resolveXxxSceneContext = (pluginParams) => { ... }

// 2. Cálculo de duración: durationSeconds * fps
export const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }

// 3. Props fotograma a fotograma: calcular progress y otros valores de animación a partir de frame/fps
export const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }

Principio de diseño clave: todo el estado de la animación depende únicamente del parámetro frame, cumpliendo con el requisito de renderizado paralelo de Remotion.

2c. Scene.jsx — Componente de dibujo en Canvas

Usar <canvas> en lugar de muchos elementos DOM para un mejor rendimiento.

Modo de carga de datos:

const [dataHandle] = useState(() => delayRender("Cargando datos"));

useEffect(() => {
  fetch(staticFile("data/xxx.json"))
    .then(r => r.json())
    .then(data => { setData(data); continueRender(dataHandle); })
    .catch(err => cancelRender(err));
}, [dataHandle]);

Lógica principal de dibujo en Canvas:

const draw = useCallback(() => {
  const ctx = canvas.getContext("2d");
  const dpr = window.devicePixelRatio || 1;

  // Adaptación a pantallas de alta resolución
  canvas.width = W * dpr;
  canvas.height = H * dpr;
  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);

  // 1. Relleno de fondo
  // 2. Líneas de cuadrícula + escala de precios en el eje Y
  // 3. Dibujo de velas (mecha + cuerpo)
  // 4. Etiquetas de año en el eje X
  // 5. Título/subtítulo/información estadística
  // 6. Barra de progreso
}, [data, progress, ...]);

useEffect(() => { draw(); }, [draw]);

Parámetros clave para el dibujo de velas:

const CANDLE_GAP_RATIO = 0.28;  // Proporción de espacio entre velas
const CANDLE_FADE_FRAMES = 22;  // Fotogramas de animación de entrada
const MAX_CANDLE_W = 8;         // Ancho máximo de vela (después de escalar)
const MIN_CANDLE_W = 0.6;       // Ancho mínimo de vela

// El ancho de la vela se adapta según el número visible
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));

Animación de entrada (fade-in + crecimiento desde abajo):

const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));

// Animación de crecimiento
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
  const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
  displayBodyBottom = lerp(lowY, bodyBottom, growT);
}

ctx.globalAlpha = fadeAlpha;
// ... dibujar mecha + cuerpo ...
ctx.globalAlpha = 1;

Colores del tema oscuro:

const COLORS = {
  bg: "#1a1a19",
  grid: "#2c2c2a",
  upBorder: "#e66767",       // Borde de vela alcista (rojo)
  upFill: "rgba(230,103,103,0.15)",  // Relleno de vela alcista (semitransparente)
  downFill: "#199e70",        // Relleno de vela bajista (verde)
  textPrimary: "#ffffff",
  textSecondary: "#c3c2b7",
  textMuted: "#898781",
  accent: "#3987e5",
};

2d. plugin.js — Registro del plugin

export const xxxPlugin = Object.freeze({
  id: "ID-del-plugin",
  defaultProps: DEFAULT_MOTION_PROPS,
  SceneComponent: XxxScene,
  waitForSceneLayoutReady: true,  // Esperar a que los datos se carguen

  resolveSceneContext: (params) => ...,
  getDurationInFrames: ({ fps, sceneContext }) => ...,
  buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
  getLayout: ({ sceneContext }) => sceneContext.layout,
});

waitForSceneLayoutReady: true asegura que el componente Scene llame a onAutoLayoutReady() antes de comenzar a renderizar fotogramas.

2e. render-presets/default.json

{
  "title": "S&P 500",
  "subtitle": "Últimos 40 años · Velas semanales",
  "videoWidth": 1920,
  "videoHeight": 1080,
  "durationSeconds": 28
}

Paso 3: Registrar la composición

Modificar motion/project.js para cambiar ACTIVE_COMPOSITION al nuevo plugin:

import { xxxPlugin } from "./xxx/plugin.js";

export const ACTIVE_COMPOSITION = Object.freeze({
  id: "SP500Kline",
  fps: 30,
  plugin: xxxPlugin,
});

Paso 4: Verificar y renderizar

# Verificar el registro de la composición
pnpm run remotion:compositions

# Iniciar vista previa en Studio (compatible con arrastre en la línea de tiempo, ajuste de parámetros)
pnpm run dev

# Renderizar una captura de un solo fotograma
npx remotion still SP500Kline out/frame.png --frame=420

# Renderizar el vídeo completo
npx remotion render SP500Kline out/output.mp4

# Renderizar usando preconfiguración
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render

Preguntas frecuentes

Problema de CORS con la API de Yahoo Finance

En el entorno de renderizado de Remotion (navegador sin cabeza Node.js) no existe problema de CORS. Si la vista previa en el navegador encuentra CORS, usa staticFile() para cargar el JSON local preobtenido.

Canvas borroso en pantallas de alta DPI

Multiplica siempre por devicePixelRatio:

canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);

Demasiadas velas provocan un ancho muy pequeño

Establece un ancho mínimo de 0.6px; si slotW < 1, reduce la proporción de espacio o agrega los datos.

Control del progreso de la animación

Usa funciones de easing segmentadas:

  • Primer 3%: establece rápidamente la línea base
  • 90% intermedio: revelación constante
  • Final: puede desacelerar ligeramente para aumentar el dramatismo

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados