Remotion Candlestick Animation Workflow
This skill documents the complete process of creating an S&P 500 candlestick chart within vibe-motion-app, a Remotion project.
Prerequisites
- Remotion 4.0.438 project, configured with React 19 + TailwindCSS v4
- Plugin architecture:
motion/defines scenes,remotion/handles the Remotion composition pipeline - pnpm as the package manager
Step 1: Fetch Financial Data
Yahoo Finance provides free historical OHLC data (no API Key required).
Create scripts/fetch-sp500-data.mjs:
// Core: Call Yahoo Finance Chart API
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];
// Extract { t: timestamp, o: open, h: high, l: low, c: close }
Save to public/data/sp500-weekly.json, to be loaded by Remotion via staticFile().
Parameter Notes:
%5EGSPC= Yahoo symbol for S&P 500 (^GSPCURL-encoded)interval=1wk= weekly; alternatives:1d,1moperiod1/period2= Unix timestamps, covering ~40 years (1984-2026)
Step 2: Create Plugin File Structure
Each Remotion plugin requires 4 core files + a render preset:
motion/plugin-name/
config.js → Default parameters
timeline.js → Scene context + per-frame animation calculation
Scene.jsx → React component (Canvas drawing)
plugin.js → Plugin registration object
render-presets/
default.json → Render preset
2a. config.js — Default Parameters
export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
videoWidth: 1920, // 16:9 landscape
videoHeight: 1080,
});
export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
durationSeconds: 28, // Total animation duration
title: "S&P 500",
subtitle: "Past 40 Years · Weekly Candlestick",
});
export const DEFAULT_MOTION_PROPS = Object.freeze({
...DEFAULT_LAYOUT_PARAMS,
...DEFAULT_ANIMATION_PARAMS,
});
2b. timeline.js — Animation Logic
Must implement three core functions:
// 1. Scene context: Validate + coerce all parameters
const resolveXxxSceneContext = (pluginParams) => { ... }
// 2. Duration calculation: durationSeconds * fps
const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }
// 3. Per-frame props: Compute progress and other animation values from frame/fps
const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }
Key design principle: All animation state depends solely on the frame parameter, fulfilling Remotion's parallel rendering requirement.
2c. Scene.jsx — Canvas Drawing Component
Use <canvas> instead of extensive DOM elements for better performance.
Data Loading Pattern:
const [dataHandle] = useState(() => delayRender("Loading data"));
useEffect(() => {
fetch(staticFile("data/xxx.json"))
.then(r => r.json())
.then(data => { setData(data); continueRender(dataHandle); })
.catch(err => cancelRender(err));
}, [dataHandle]);
Core Canvas Drawing Logic:
const draw = useCallback(() => {
const ctx = canvas.getContext("2d");
const dpr = window.devicePixelRatio || 1;
// High-DPI adaptation
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
// 1. Background fill
// 2. Grid lines + Y-axis price ticks
// 3. Candlestick drawing (wick + body)
// 4. X-axis year labels
// 5. Title / subtitle / statistics
// 6. Progress bar
}, [data, progress, ...]);
useEffect(() => { draw(); }, [draw]);
Key Candlestick Drawing Parameters:
const CANDLE_GAP_RATIO = 0.28; // Gap ratio between candlesticks
const CANDLE_FADE_FRAMES = 22; // Entry animation frames
const MAX_CANDLE_W = 8; // Maximum candlestick width (after scaling)
const MIN_CANDLE_W = 0.6; // Minimum candlestick width
// Candlestick width adjusts adaptively with visible count
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));
Entry Animation (fade-in + grow from bottom):
const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));
// Grow animation
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
displayBodyBottom = lerp(lowY, bodyBottom, growT);
}
ctx.globalAlpha = fadeAlpha;
// ... draw wick + body ...
ctx.globalAlpha = 1;
Dark Theme Colors:
const COLORS = {
bg: "#1a1a19",
grid: "#2c2c2a",
upBorder: "#e66767", // Bullish border (red)
upFill: "rgba(230,103,103,0.15)", // Bullish fill (translucent)
downFill: "#199e70", // Bearish fill (green)
textPrimary: "#ffffff",
textSecondary: "#c3c2b7",
textMuted: "#898781",
accent: "#3987e5",
};
2d. plugin.js — Plugin Registration
export const xxxPlugin = Object.freeze({
id: "pluginID",
defaultProps: DEFAULT_MOTION_PROPS,
SceneComponent: XxxScene,
waitForSceneLayoutReady: true, // Wait for data loading
resolveSceneContext: (params) => ...,
getDurationInFrames: ({ fps, sceneContext }) => ...,
buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
getLayout: ({ sceneContext }) => sceneContext.layout,
});
waitForSceneLayoutReady: true ensures the Scene component calls onAutoLayoutReady() before frame rendering starts.
2e. render-presets/default.json
{
"title": "S&P 500",
"subtitle": "Past 40 Years · Weekly Candlestick",
"videoWidth": 1920,
"videoHeight": 1080,
"durationSeconds": 28
}
Step 3: Register Composition
Modify motion/project.js to switch ACTIVE_COMPOSITION to the new plugin:
import { xxxPlugin } from "./xxx/plugin.js";
export const ACTIVE_COMPOSITION = Object.freeze({
id: "SP500Kline",
fps: 30,
plugin: xxxPlugin,
});
Step 4: Validate and Render
# Validate composition registration
pnpm run remotion:compositions
# Launch Studio preview (supports timeline scrubbing, parameter adjustment)
pnpm run dev
# Render a single frame screenshot
npx remotion still SP500Kline out/frame.png --frame=420
# Render full video
npx remotion render SP500Kline out/output.mp4
# Render using a preset
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render
Common Issues
Yahoo Finance API CORS Issue
CORS is not an issue in the Remotion rendering environment (Node.js headless browser).
If browser preview encounters CORS, use staticFile() to load pre-fetched local JSON.
Canvas Blurry on High-DPI Displays
Always multiply by devicePixelRatio:
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
Too Many Candles Making Width Too Small
Set a minimum width of 0.6px; when slotW < 1, reduce the gap ratio or aggregate the data.
Animation Progress Control
Use segmented easing functions:
- First 3%: quickly establish baseline
- Middle 90%: linear reveal
- End: slight deceleration for dramatic effect