These are instructions for making a new Remotion project and composition.
If this is not the next task, see Remotion Best Practices
Scaffold a project
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.
Open the preview before building the video
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.
Designing a video
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.
Is this a multi-scene video?
If this is a video with multiple subsequence videos, follow guidance at Multi-scene videos.
Interactivity Best Practices
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.
TailwindCSS
If Tailwind is requested, see tailwind.md for using TailwindCSS in Remotion.
Render the video
Only render if the user explicitly asks for it.
npx remotion render
For more options, see Rendering.
Follow-up
The video creation process has finished.
For follow-up prompts, use Remotion Best Practices