Create a Remotion video project and build its visuals with React while viewing a live browser preview. The workflow also covers multiple scenes and code structure that lets users edit the video in Remotion Studio.
Create a new Remotion video
Review the instructions the agent will receive before you install.
These are instructions for making a new Remotion project and composition.
If this is not the next task, see Remotion Best Practices
If a project already exists, skip this. Ensure Node.js and Git is installed, and the current folder is appropriate for starting a new project.
Scaffold one using:
npx create-video@latest --yes --blank --no-tailwind my-video
cd my-video
npm i
Replace my-video with a suitable project name.
As soon as the project can run, start Studio and open its preview in the browser before writing or changing the composition. For a new project, do this immediately after scaffolding and installing dependencies. For an existing project, do it before editing the video. Keep Studio running while you work so the user can see changes and steer.
In Cursor, run Studio without --no-open so it opens the browser automatically:
npx remotion studio
In other agent clients, you can use the same command, or use --no-open if you will open the URL in an in-app browser:
npx remotion studio --no-open
This will start a long-running process and print the server URL for the preview.
If the server is already started, it will print the URL.
If you use --no-open, open the exact printed URL in the in-app browser and verify that Studio loads. Once a composition exists, verify that its video preview loads. If you cannot open it there, run Studio without --no-open.
You can visit a specific composition by navigating to /[composition-id], for example http://localhost:3000/MapAnimation.
Keep the scaffold and add React Markup. Follow Remotion React Markup Best Practices and Video Layout Rules for video-first layout and text sizing guidance.
If this is a video with multiple subsequence videos, follow guidance at Multi-scene videos.
By structuring the React Markup following Remotion Interactivity Best Practices, you allow the user to make edits in the Studio which write back to code.
If Tailwind is requested, see tailwind.md for using TailwindCSS in Remotion.
Only render if the user explicitly asks for it.
npx remotion render
For more options, see Rendering.
The video creation process has finished. For follow-up prompts, use Remotion Best Practices
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Add a reported Remotion bug to the bugs API with its affected versions, a short title, and upgrade guidance. Follow the existing entry format and place the new record first so recent bugs appear at the top.
Add a Remotion command-line or configuration option, or convert a hardcoded flag into a shared option definition. Connect parsing, configuration setters, help entries, and generated documentation so the option is consistently available and documented.
Add a new effect to @remotion/effects, including its implementation, package entry points, documentation, interactive demo, and preview images. Follow the package conventions and verify the changes with tests, formatting checks, and builds.
Add a person to the Remotion experts page by placing their portrait, entering their profile and contact links, and generating an expert card image. The instructions specify file locations, profile fields, and how to verify card generation.
Create a new @remotion package within the Remotion monorepo, a repository containing multiple packages. Set up its files, register it across the project, and prepare documentation, usage examples, and build configuration.
Add a new sound effect to @remotion/sfx, from registering the audio file to exporting its URL and documenting its use. The workflow covers playback examples, attribution, navigation entries, waveform generation, and the package build.