Remotion Video
Creates production-grade videos using Remotion — a React framework where video is code.
Every frame is a React component. Animations use spring physics and frame-based interpolation.
Reference Files
| File |
Purpose |
references/rules/fundamentals.md |
useCurrentFrame, useVideoConfig, interpolate, spring, core hooks |
references/rules/animations.md |
Easing, spring config, interpolateColors, timing patterns |
references/rules/compositions.md |
Composition, registerRoot, Folder, calculateMetadata |
references/rules/media.md |
Img, Video, OffthreadVideo, Audio, staticFile, async loading |
references/rules/text-and-fonts.md |
Google Fonts, local fonts, text measurement, typography |
references/rules/tailwind.md |
TailwindCSS integration, utility-first styling in Remotion |
references/rules/audio.md |
Audio component, volume curves, trimming, frame-synced audio |
references/rules/subtitles.md |
Caption system, SRT/VTT parsing, word-level timing |
references/rules/three-d.md |
@remotion/three, ThreeCanvas, React Three Fiber integration |
references/rules/charts.md |
Bar, pie, line chart animation patterns |
references/rules/rendering.md |
CLI render, renderMedia API, quality presets |
references/rules/data-driven.md |
Dataset rendering, batch generation, parametric compositions |
references/templates/explainer.tsx |
Parametric tech explainer template |
references/templates/product-demo.tsx |
Product showcase template |
references/templates/data-viz.tsx |
Animated chart composition template |
scripts/scaffold_project.sh |
Bootstrap a new Remotion project with TailwindCSS |
scripts/render.sh |
Render wrapper with quality presets and format options |
Why Remotion
Remotion treats video as a React application. Each frame is a pure function of time — given frame N and total frames F, your component renders deterministically. This means:
- Component composition: Nest scenes, reuse components, apply CSS.
- Spring physics:
spring() gives natural motion without hand-tweaking cubic beziers.
- Asset pipeline: Import images, audio, video — the same way you import in React.
- Iterative workflow: Edit code → hot-reload preview → render final. The
.tsx file IS the editable intermediate.
- Data-driven at scale: Render thousands of personalized videos by passing different props to the same composition.
Workflow
Scaffold → Compose → Preview → Iterate → Render
- Scaffold the project (once per video project)
- Interpret the user's concept — choose the right template and rule files
- Compose React components for each scene
- Preview in Remotion Studio (
npm run dev)
- Iterate based on user feedback
- Render final video via
scripts/render.sh
Step 0: Ensure Dependencies
Node.js 18+ is required. Check before scaffolding:
node --version # Must be >= 18.0.0
npm --version
If Node.js is not available, inform the user — Remotion cannot run without it.
Step 1: Scaffold the Project
Run scripts/scaffold_project.sh to create a new Remotion project. The script is idempotent — it detects an existing project and skips re-initialization.
bash scripts/scaffold_project.sh my-video-project
cd my-video-project
npm run dev # Opens Remotion Studio at localhost:3000
Step 2: Interpret the Concept
Determine the best approach. Read the relevant rule file for detailed patterns.
| Content type |
Rule file |
Template |
| Explainer / educational |
fundamentals.md |
explainer.tsx |
| Product demo / marketing |
animations.md |
product-demo.tsx |
| Data visualization / animated chart |
charts.md |
data-viz.tsx |
| Video with voiceover / narration |
audio.md + subtitles.md |
explainer.tsx |
| Social media clip (short, looping) |
animations.md |
product-demo.tsx |
| 3D scene / abstract motion graphics |
three-d.md |
(custom) |
| Personalized / batch generation |
data-driven.md |
any |
| Video with embedded media |
media.md |
any |
Step 3: Compose the Components
Core rules for writing Remotion components:
- One composition per video:
registerRoot points to one root composition.
- Sequences for timing: Use
<Sequence from={30} durationInFrames={60}> to place scenes at specific frames.
- AbsoluteFill for layering: Use
<AbsoluteFill> as the base for any full-screen element.
- Frame-based math only: Derive all animation state from
useCurrentFrame(). Never use Date.now() or setTimeout.
- Spring over easing: Prefer
spring({ frame, fps }) for natural motion.
- Props for everything variable: Hardcoded values → props. This enables data-driven rendering.
Component structure pattern
import {
useCurrentFrame,
useVideoConfig,
interpolate,
spring,
AbsoluteFill,
Sequence,
} from "remotion";
type MySceneProps = {
title: string;
accentColor: string;
};
export const MyScene: React.FC<MySceneProps> = ({ title, accentColor }) => {
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
const scale = spring({ frame, fps, config: { damping: 12, stiffness: 100 } });
return (
<AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>
<div
style={{ opacity, transform: `scale(${scale})`, color: accentColor }}
>
{title}
</div>
</AbsoluteFill>
);
};
Step 4: Preview
Remotion Studio provides hot-reload preview. Start it with:
npm run dev
Studio opens at http://localhost:3000. The timeline scrubber lets you inspect any frame.
Use <Still> component for frame-accurate screenshots during iteration.
Step 5: Iterate
| Request |
Action |
| "Slower/faster" |
Adjust durationInFrames on <Sequence> or change FPS |
| "Different color" |
Update props passed to composition |
| "Add a section" |
Add new <Sequence> block with incremented from offset |
| "Change font" |
Load via @remotion/google-fonts, apply as CSS fontFamily |
| "Add background music" |
Add <Audio src={staticFile('audio.mp3')} /> to root composition |
| "Make it loop" |
Set durationInFrames and design matching first/last frame state |
| "Add captions" |
See subtitles.md for SRT parsing and word-level timing |
Step 6: Render
Use scripts/render.sh to render the final video:
bash scripts/render.sh --composition MyComposition --quality final --format mp4
Quality presets
| Preset |
Resolution |
FPS |
Use case |
preview |
480p |
15 |
Fast layout check |
draft |
720p |
30 |
Client draft review |
final |
1080p |
30 |
Standard delivery |
4k |
2160p |
60 |
Presentation / cinema |
Format options
| Format |
Use case |
mp4 |
Standard delivery (H.264) |
webm |
Web-optimized |
gif |
Embeddable in docs, social media |
Error Handling
| Error |
Cause |
Resolution |
node: command not found |
Node.js not installed |
Install Node.js 18+ from nodejs.org |
Cannot find module 'remotion' |
Dependencies not installed |
Run npm install in the project directory |
Composition not found |
Wrong composition ID |
Check registerRoot and <Composition id= match |
delayRender timed out |
Async asset load > 30s |
Increase timeout via delayRender('reason', { timeoutInMilliseconds: 60000 }) |
OffthreadVideo failed |
Video codec not supported |
Convert to H.264 MP4 with ffmpeg first |
ENOMEM during render |
Out of memory on large compositions |
Reduce --concurrency flag, or lower resolution |
Port 3000 already in use |
Another dev server running |
Kill existing process or set --port 3001 |
| Spring animation goes past 1.0 |
Missing { extrapolateRight: 'clamp' } |
Add extrapolation clamp to interpolate calls |
| Fonts not loading in render |
Font not loaded before render starts |
Use @remotion/google-fonts or delayRender for font face load |
Limitations
- Node.js required — Remotion is a Node.js framework. Cannot run in Python-only or headless container environments.
- Chromium dependency — Remotion renders via Chromium. The
npx remotion render command downloads it automatically, but it requires ~300MB disk space.
- No server-side Lambda in v1 — Cloud rendering via
@remotion/lambda is deferred to a future skill version. Local rendering only.
- Large renders are slow — A 60-second 1080p video at 30fps = 1800 frames rendered through Chromium. Plan for 10-30 minutes on a typical laptop.
- GIF size — GIFs at full resolution are large. Limit to 480p and <10 seconds for embeddable GIFs.
- Audio in preview — Remotion Studio supports audio playback in preview. Rendered audio requires ffmpeg.
Design Principles
- Frame-based thinking: Every visual state is a function of the current frame number. No timers, no intervals.
- Composition-first: Split video into logical
<Sequence> blocks. Each scene is its own component.
- Spring over easing:
spring() gives physically accurate motion. Only use interpolate with easing when spring doesn't fit.
- Props for content: Never hardcode strings, colors, or data inside components. Pass via props to enable reuse.
- Type everything: All composition props have TypeScript types enforced via
z.infer<typeof schema> (Zod) or explicit interfaces.
Cross-Reference
For mathematical animations or algorithm visualizations with no explicit React/Remotion request, use animate (Manim/Python). Manim uses its own Python, Cairo/Pango and FFmpeg setup rather than Node.js. Missing Node.js does not authorize switching an explicit React request to another engine; report the missing prerequisite.
For videos the user explicitly wants authored as plain HTML and CSS or rendered with Hyperframes, use html-video instead; that is not a React project. An explicit engine request outranks generic branded or marketing preferences. Keep Remotion when the user asks for React or Remotion, including HTML or CSS content embedded inside a React composition. An ordinary web page with no video output is neither skill's task.
1---2name: remotion-video3description: 'Create motion graphics and videos using Remotion (React) with audio sync, web fonts, and TailwindCSS. Triggers on: "create a Remotion video", "React video", "motion graphics", "branded video", "product demo video", "video with voiceover". For math animations with no requested engine, use animate; explicit React/Remotion requests stay here. NOT for explicit Hyperframes or plain HTML/CSS video, use html-video (HTML inside a React/Remotion composition stays here). NOT for a launch video of the current project with no requested engine, use launch-video.'4metadata:5 source: https://skillmd.com/skills/mathews-tom/remotion-video6 version: 1.2.27 category: business8 tags: [video, react, remotion, motion-graphics]9 difficulty: advanced10---1112# Remotion Video1314Creates production-grade videos using Remotion — a React framework where video is code.15Every frame is a React component. Animations use spring physics and frame-based interpolation.1617## Reference Files1819| File | Purpose |20| --------------------------------------- | ---------------------------------------------------------------- |21| `references/rules/fundamentals.md` | useCurrentFrame, useVideoConfig, interpolate, spring, core hooks |22| `references/rules/animations.md` | Easing, spring config, interpolateColors, timing patterns |23| `references/rules/compositions.md` | Composition, registerRoot, Folder, calculateMetadata |24| `references/rules/media.md` | Img, Video, OffthreadVideo, Audio, staticFile, async loading |25| `references/rules/text-and-fonts.md` | Google Fonts, local fonts, text measurement, typography |26| `references/rules/tailwind.md` | TailwindCSS integration, utility-first styling in Remotion |27| `references/rules/audio.md` | Audio component, volume curves, trimming, frame-synced audio |28| `references/rules/subtitles.md` | Caption system, SRT/VTT parsing, word-level timing |29| `references/rules/three-d.md` | @remotion/three, ThreeCanvas, React Three Fiber integration |30| `references/rules/charts.md` | Bar, pie, line chart animation patterns |31| `references/rules/rendering.md` | CLI render, renderMedia API, quality presets |32| `references/rules/data-driven.md` | Dataset rendering, batch generation, parametric compositions |33| `references/templates/explainer.tsx` | Parametric tech explainer template |34| `references/templates/product-demo.tsx` | Product showcase template |35| `references/templates/data-viz.tsx` | Animated chart composition template |36| `scripts/scaffold_project.sh` | Bootstrap a new Remotion project with TailwindCSS |37| `scripts/render.sh` | Render wrapper with quality presets and format options |3839## Why Remotion4041Remotion treats video as a React application. Each frame is a pure function of time — given frame N and total frames F, your component renders deterministically. This means:4243- **Component composition**: Nest scenes, reuse components, apply CSS.44- **Spring physics**: `spring()` gives natural motion without hand-tweaking cubic beziers.45- **Asset pipeline**: Import images, audio, video — the same way you import in React.46- **Iterative workflow**: Edit code → hot-reload preview → render final. The `.tsx` file IS the editable intermediate.47- **Data-driven at scale**: Render thousands of personalized videos by passing different props to the same composition.4849## Workflow5051```text52Scaffold → Compose → Preview → Iterate → Render53```54551. **Scaffold** the project (once per video project)562. **Interpret** the user's concept — choose the right template and rule files573. **Compose** React components for each scene584. **Preview** in Remotion Studio (`npm run dev`)595. **Iterate** based on user feedback606. **Render** final video via `scripts/render.sh`6162## Step 0: Ensure Dependencies6364Node.js 18+ is required. Check before scaffolding:6566```bash67node --version # Must be >= 18.0.068npm --version69```7071If Node.js is not available, inform the user — Remotion cannot run without it.7273## Step 1: Scaffold the Project7475Run `scripts/scaffold_project.sh` to create a new Remotion project. The script is idempotent — it detects an existing project and skips re-initialization.7677```bash78bash scripts/scaffold_project.sh my-video-project79cd my-video-project80npm run dev # Opens Remotion Studio at localhost:300081```8283## Step 2: Interpret the Concept8485Determine the best approach. Read the relevant rule file for detailed patterns.8687| Content type | Rule file | Template |88| ----------------------------------- | ----------------------- | ---------------- |89| Explainer / educational | fundamentals.md | explainer.tsx |90| Product demo / marketing | animations.md | product-demo.tsx |91| Data visualization / animated chart | charts.md | data-viz.tsx |92| Video with voiceover / narration | audio.md + subtitles.md | explainer.tsx |93| Social media clip (short, looping) | animations.md | product-demo.tsx |94| 3D scene / abstract motion graphics | three-d.md | (custom) |95| Personalized / batch generation | data-driven.md | any |96| Video with embedded media | media.md | any |9798## Step 3: Compose the Components99100Core rules for writing Remotion components:101102- **One composition per video**: `registerRoot` points to one root composition.103- **Sequences for timing**: Use `<Sequence from={30} durationInFrames={60}>` to place scenes at specific frames.104- **AbsoluteFill for layering**: Use `<AbsoluteFill>` as the base for any full-screen element.105- **Frame-based math only**: Derive all animation state from `useCurrentFrame()`. Never use `Date.now()` or `setTimeout`.106- **Spring over easing**: Prefer `spring({ frame, fps })` for natural motion.107- **Props for everything variable**: Hardcoded values → props. This enables data-driven rendering.108109### Component structure pattern110111```tsx112import {113 useCurrentFrame,114 useVideoConfig,115 interpolate,116 spring,117 AbsoluteFill,118 Sequence,119} from "remotion";120121type MySceneProps = {122 title: string;123 accentColor: string;124};125126export const MyScene: React.FC<MySceneProps> = ({ title, accentColor }) => {127 const frame = useCurrentFrame();128 const { fps, durationInFrames } = useVideoConfig();129130 const opacity = interpolate(frame, [0, 30], [0, 1], {131 extrapolateRight: "clamp",132 });133 const scale = spring({ frame, fps, config: { damping: 12, stiffness: 100 } });134135 return (136 <AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>137 <div138 style={{ opacity, transform: `scale(${scale})`, color: accentColor }}139 >140 {title}141 </div>142 </AbsoluteFill>143 );144};145```146147## Step 4: Preview148149Remotion Studio provides hot-reload preview. Start it with:150151```bash152npm run dev153```154155Studio opens at `http://localhost:3000`. The timeline scrubber lets you inspect any frame.156157Use `<Still>` component for frame-accurate screenshots during iteration.158159## Step 5: Iterate160161| Request | Action |162| ---------------------- | ----------------------------------------------------------------- |163| "Slower/faster" | Adjust `durationInFrames` on `<Sequence>` or change FPS |164| "Different color" | Update props passed to composition |165| "Add a section" | Add new `<Sequence>` block with incremented `from` offset |166| "Change font" | Load via `@remotion/google-fonts`, apply as CSS `fontFamily` |167| "Add background music" | Add `<Audio src={staticFile('audio.mp3')} />` to root composition |168| "Make it loop" | Set `durationInFrames` and design matching first/last frame state |169| "Add captions" | See subtitles.md for SRT parsing and word-level timing |170171## Step 6: Render172173Use `scripts/render.sh` to render the final video:174175```bash176bash scripts/render.sh --composition MyComposition --quality final --format mp4177```178179### Quality presets180181| Preset | Resolution | FPS | Use case |182| --------- | ---------- | --- | --------------------- |183| `preview` | 480p | 15 | Fast layout check |184| `draft` | 720p | 30 | Client draft review |185| `final` | 1080p | 30 | Standard delivery |186| `4k` | 2160p | 60 | Presentation / cinema |187188### Format options189190| Format | Use case |191| ------ | -------------------------------- |192| `mp4` | Standard delivery (H.264) |193| `webm` | Web-optimized |194| `gif` | Embeddable in docs, social media |195196## Error Handling197198| Error | Cause | Resolution |199| ------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------ |200| `node: command not found` | Node.js not installed | Install Node.js 18+ from nodejs.org |201| `Cannot find module 'remotion'` | Dependencies not installed | Run `npm install` in the project directory |202| `Composition not found` | Wrong composition ID | Check `registerRoot` and `<Composition id=` match |203| `delayRender timed out` | Async asset load > 30s | Increase timeout via `delayRender('reason', { timeoutInMilliseconds: 60000 })` |204| `OffthreadVideo failed` | Video codec not supported | Convert to H.264 MP4 with ffmpeg first |205| `ENOMEM` during render | Out of memory on large compositions | Reduce `--concurrency` flag, or lower resolution |206| `Port 3000 already in use` | Another dev server running | Kill existing process or set `--port 3001` |207| Spring animation goes past 1.0 | Missing `{ extrapolateRight: 'clamp' }` | Add extrapolation clamp to `interpolate` calls |208| Fonts not loading in render | Font not loaded before render starts | Use `@remotion/google-fonts` or `delayRender` for font face load |209210## Limitations211212- **Node.js required** — Remotion is a Node.js framework. Cannot run in Python-only or headless container environments.213- **Chromium dependency** — Remotion renders via Chromium. The `npx remotion render` command downloads it automatically, but it requires ~300MB disk space.214- **No server-side Lambda in v1** — Cloud rendering via `@remotion/lambda` is deferred to a future skill version. Local rendering only.215- **Large renders are slow** — A 60-second 1080p video at 30fps = 1800 frames rendered through Chromium. Plan for 10-30 minutes on a typical laptop.216- **GIF size** — GIFs at full resolution are large. Limit to 480p and <10 seconds for embeddable GIFs.217- **Audio in preview** — Remotion Studio supports audio playback in preview. Rendered audio requires ffmpeg.218219## Design Principles220221- **Frame-based thinking**: Every visual state is a function of the current frame number. No timers, no intervals.222- **Composition-first**: Split video into logical `<Sequence>` blocks. Each scene is its own component.223- **Spring over easing**: `spring()` gives physically accurate motion. Only use `interpolate` with easing when spring doesn't fit.224- **Props for content**: Never hardcode strings, colors, or data inside components. Pass via props to enable reuse.225- **Type everything**: All composition props have TypeScript types enforced via `z.infer<typeof schema>` (Zod) or explicit interfaces.226227## Cross-Reference228229For **mathematical animations** or **algorithm visualizations** with no explicit React/Remotion request, use `animate` (Manim/Python). Manim uses its own Python, Cairo/Pango and FFmpeg setup rather than Node.js. Missing Node.js does not authorize switching an explicit React request to another engine; report the missing prerequisite.230231For videos the user explicitly wants authored as plain HTML and CSS or rendered with Hyperframes, use `html-video` instead; that is not a React project. An explicit engine request outranks generic branded or marketing preferences. Keep Remotion when the user asks for React or Remotion, including HTML or CSS content embedded inside a React composition. An ordinary web page with no video output is neither skill's task.