remotion-best-practices by zeinalii/skills

When to use

Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge.

Setup

Install all packages

npm run install:all

Or manually:

npm install @remotion/media @remotion/three @remotion/google-fonts @remotion/fonts @remotion/gif @remotion/layout-utils @remotion/zod-types @remotion/transitions @remotion/captions @remotion/maps @remotion/charts @remotion/diagrams @remotion/lottie @remotion/motion-graphics @remotion/broll @remotion/llm @remotion/ai-images @remotion/ai-analysis @remotion/tts zod@3.22.3 mediabunny

Configure API keys

Create ~/.env.local (in your home directory) with your API keys:

# Maps (Mapbox) - https://console.mapbox.com/account/access-tokens/
MAPBOX_ACCESS_TOKEN=pk.your-token

# LLM Providers (choose one or more)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=...
GROK_API_KEY=xai-...
PERPLEXITY_API_KEY=pplx-...
DEFAULT_LLM=gemini

# AI Images
GEMINI_API_KEY=...
# or VERTEX_SERVICE_ACCOUNT_TOKEN=...

# Text-to-Speech - https://elevenlabs.io
ELEVENLABS_API_KEY=...

Validate configuration

npm run validate

This checks all API keys and confirms they're working.

How to use

Read individual rule files for detailed explanations and code examples:

Core Fundamentals

rules/3d.md - 3D content in Remotion using Three.js and React Three Fiber
rules/animations.md - Fundamental animation skills for Remotion
rules/assets.md - Importing images, videos, audio, and fonts into Remotion
rules/audio.md - Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
rules/calculate-metadata.md - Dynamically set composition duration, dimensions, and props
rules/compositions.md - Defining compositions, stills, folders, default props and dynamic metadata
rules/fonts.md - Loading Google Fonts and local fonts in Remotion
rules/gifs.md - Displaying GIFs synchronized with Remotion's timeline
rules/images.md - Embedding images in Remotion using the Img component
rules/measuring-dom-nodes.md - Measuring DOM element dimensions in Remotion
rules/measuring-text.md - Measuring text dimensions, fitting text to containers, and checking overflow
rules/parameters.md - Make a video parametrizable by adding a Zod schema
rules/sequencing.md - Sequencing patterns for Remotion - delay, trim, limit duration of items
rules/tailwind.md - Using TailwindCSS in Remotion
rules/text-animations.md - Typography and text animation patterns for Remotion
rules/timing.md - Interpolation curves in Remotion - linear, easing, spring animations
rules/transitions.md - Scene transition patterns for Remotion
rules/trimming.md - Trimming patterns for Remotion - cut the beginning or end of animations
rules/videos.md - Embedding videos in Remotion - trimming, volume, speed, looping, pitch

Media Processing

rules/can-decode.md - Check if a video can be decoded by the browser using Mediabunny
rules/extract-frames.md - Extract frames from videos at specific timestamps using Mediabunny
rules/get-audio-duration.md - Getting the duration of an audio file in seconds with Mediabunny
rules/get-video-dimensions.md - Getting the width and height of a video file with Mediabunny
rules/get-video-duration.md - Getting the duration of a video file in seconds with Mediabunny

Captions

rules/display-captions.md - Displaying captions in Remotion with TikTok-style pages and word highlighting
rules/import-srt-captions.md - Importing .srt subtitle files into Remotion using @remotion/captions

Maps and Geospatial

rules/maps.md - Add a map using Mapbox and animate it (low-level)
rules/smart-maps.md - Smart maps with address-based geocoding using @remotion/maps

Data Visualization

rules/charts.md - Chart and data visualization patterns for Remotion (manual D3)
rules/charts-advanced.md - Advanced charting with themes and data processing using @remotion/charts
rules/diagrams.md - Mermaid diagram rendering using @remotion/diagrams

AI and LLM Tools

rules/ai-images.md - AI-powered image generation using @remotion/ai-images
rules/llm.md - Multi-provider LLM services using @remotion/llm
rules/ai-content-analysis.md - AI-powered content analysis using @remotion/ai-analysis
rules/tts.md - Text-to-speech with ElevenLabs using @remotion/tts

Motion Graphics

rules/lottie.md - Embedding Lottie animations in Remotion
rules/motion-graphics.md - Lower thirds, title cards, and callouts using @remotion/motion-graphics
rules/broll.md - B-roll effects and Ken Burns using @remotion/broll