Back to Remotion

Upgrade Remotion

packages/skills/skills/remotion-upgrade/SKILL.md

4.0.5001.5 KB
Original Source

Upgrade Remotion

  1. Inspect the project manifests and lockfile to identify the package manager and workspaces. Preserve unrelated changes.

  2. Determine whether @remotion/cli is locally available. If it is, run:

    bash
    npx remotion upgrade
    

    Skip the manual package upgrade below.

  3. If @remotion/cli is not available, upgrade manually:

    • Get the latest stable Remotion version with npm view remotion version.
    • Find every installed remotion and @remotion/* dependency across the project and upgrade them all to that exact version. Preserve their dependency sections and the project's workspace or catalog conventions.
    • Read the current Mediabunny compatibility page and determine the Mediabunny version compatible with the target Remotion version. Upgrade every installed mediabunny and @mediabunny/* package to the documented compatible version.
    • Run the project's package manager to update its lockfile.
  4. Update the installed Remotion skills:

    bash
    npx remotion skills update
    
  5. Review the manifest and lockfile diff. Ensure all Remotion packages use one version and all installed Mediabunny packages use the compatible version. If the CLI is available, run npx remotion versions as an additional check.

The Remotion releases contain the changelog and may be useful for summarizing relevant changes after the upgrade.