remotion-dev / remotion

Code

How remotion-dev/remotion is laid out, and where to start for common changes.

There is no import map for this report yet.

Where to start reading

Repository root
Repository root
Likely public API
Likely public API
Likely start-up file
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

AI

Add a New Visual Effect

Create effect module directory under packages/effects/src/your-effect-name/
Implement runtime shader logic following GPU abstraction pattern
Export effect component and register in barrel index

Add a New CLI Command

Create command file in packages/cli/src/ following naming convention
Integrate with render-flows for progress aggregation if needed
Register command in CLI main entry point with argument parsing

Add a New Studio UI Panel

Create React component in packages/browser-studio/src/
Use design system components from packages/design/src/
Integrate with composition state and rendering pipeline

Add External Service Integration

Create service module under packages/ (e.g., packages/elevenlabs/)
Implement async data fetching with Remotion timeline integration
Export public API in package index and add setup documentation

Change the public API

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.

Code quality and hotspots

Largest source files

Branch points56 per file on average
Code issues0 errors, 131 warnings
Largest file4,021 lines
Hotspot load5 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions6 workflows
Tests1,706 test filesJest/Vitest · 0.19 test files per source file (file count, not coverage)
Dependency updatesNo config detected

Test folders: packages/browser-studio/src/test · packages/bundler/src/test · packages/browser-studio/e2e

Hotspots

packages/transitions/src/TransitionSeries.tsx56 commits in 180 days · 94 branch points
packages/browser-studio/src/BrowserStudio.tsx40 commits in 180 days · 100 branch points
packages/media/src/audio-iterator-manager.ts19 commits in 180 days · 58 branch points
packages/cli/src/render-flows/render.ts11 commits in 180 days · 41 branch points
packages/sdk/src/calculate-timeline.ts11 commits in 180 days · 141 branch points
packages/timeline-utils/src/persistent-cache/persistent-cache.ts7 commits in 180 days · 96 branch points
packages/cli/src/benchmark.ts8 commits in 180 days · 23 branch points
packages/jonnys-videos/src/roller-skis/Composition.tsx15 commits in 180 days · 8 branch points

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.