RemotionUI

AI Usage

How coding agents should use RemotionUI with Remotion.

RemotionUI is the component layer for Remotion: production-ready source you install with the CLI. Use Remotion for framework fundamentals, rendering, Studio, Player, and APIs. Use RemotionUI when you need ready-made components for captions, charts, scenes, transitions, and composition templates.

Agent workflow

  1. Create or open a Remotion project.
  2. Install RemotionUI components with the CLI.
  3. Import components from local source paths after installation.
  4. Customize the copied files directly.
  5. Use Remotion frame APIs for motion.
Search
$ npx remotion-ui@latest search -q caption
Install
$ npx remotion-ui@latest add caption-highlight lower-third
Code
import { CaptionHighlight } from "@/remotion/primitives/caption-highlight"; import { LowerThird } from "@/remotion/scenes/lower-third";

Do not import RemotionUI components from the npm package. The npm package is the CLI only. Components are installed as source files into the user's project.

Hard rules for agents

  • Run npx remotion-ui@latest add <component> before importing a component.
  • Import from local project paths such as @/remotion/primitives/..., @/remotion/scenes/..., or @/compositions/....
  • Use useCurrentFrame(), interpolate(), spring(), and <Sequence /> for render-time motion.
  • Do not use CSS transitions or Tailwind animation classes for video motion.
  • Prefer recipes before raw component search when the user asks for a complete video.
  • Preserve source ownership: edit copied component files when customization is needed.

AI-readable files

Start with recipes

Browse Recipes for task-first install commands and composition templates.

On this page