remotion-markup
Content, animation and effects best practices
- License 许可
- MIT
- 最近更新
- 2026-08-19
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- description
- Content, animation and effects best practices
02 资源文件 62
- 参考文档3d.md2.2 KB
- 参考文档agents/openai.yaml310 B
- 资产文件assets/remotion-icon.png1.3 KB
- 参考文档audio-visualization.md4.8 KB
- 参考文档audio.md3.5 KB
- 参考文档calculate-metadata.md3.4 KB
- 参考文档compositions.md3.1 KB
- 参考文档cropping.md1.1 KB
- 参考文档effects.md8.7 KB
- 参考文档embedding-videos.md3.4 KB
- 参考文档ffmpeg.md1.1 KB
- 参考文档gifs.md3.7 KB
- 参考文档google-fonts.md1.7 KB
- 参考文档html-in-canvas.md3.6 KB
- 参考文档images.md1.4 KB
- 参考文档light-leaks.md3.1 KB
- 参考文档local-fonts.md1.5 KB
- 参考文档lottie.md1.8 KB
- 参考文档measuring-dom-nodes.md995 B
- 参考文档measuring-text.md2.7 KB
- 参考文档multi-scene-video.md2.0 KB
- 参考文档parameters.md2.3 KB
- 参考文档remotion-maps/agents/openai.yaml293 B
- 资产文件remotion-maps/assets/remotion-icon.png1.3 KB
- 参考文档remotion-maps/REFERENCE.md1.0 KB
- 参考文档remotion-maps/techniques/cesium/assets/cesium-path.json12.0 KB
- 其他remotion-maps/techniques/cesium/assets/CesiumFlythrough.tsx8.7 KB
- 参考文档remotion-maps/techniques/cesium/assets/city-path.json223 B
- 其他remotion-maps/techniques/cesium/assets/example-Root.tsx923 B
- 脚本remotion-maps/techniques/cesium/assets/flight-path.ts1.2 KB
- 其他remotion-maps/techniques/cesium/assets/sample-river.geojson6.3 KB
- 参考文档remotion-maps/techniques/cesium/references/3d-data-sources.md1.4 KB
- 参考文档remotion-maps/techniques/cesium/references/3d-flyover-architecture.md7.7 KB
- 参考文档remotion-maps/techniques/cesium/references/3d-troubleshooting.md6.6 KB
- 脚本remotion-maps/techniques/cesium/scripts/prep-cesium-path.mjs5.4 KB
- 参考文档remotion-maps/techniques/cesium/TECHNIQUE.md3.8 KB
- 参考文档remotion-maps/techniques/mapbox/references/render-stability.md3.6 KB
- 参考文档remotion-maps/techniques/mapbox/TECHNIQUE.md12.9 KB
- 参考文档remotion-maps/techniques/maplibre/references/render-stability.md3.6 KB
- 参考文档remotion-maps/techniques/maplibre/TECHNIQUE.md13.1 KB
- 其他remotion-maps/techniques/maptiler/assets/CountryLabel.tsx1.8 KB
- 其他remotion-maps/techniques/maptiler/assets/example-Root.tsx1.0 KB
- 脚本remotion-maps/techniques/maptiler/assets/MapTilerVectorElement.ts2.1 KB
- 其他remotion-maps/techniques/maptiler/assets/RiverReveal.tsx10.6 KB
- 参考文档remotion-maps/techniques/maptiler/assets/sample-data/country-meta.json325.3 KB
- 参考文档remotion-maps/techniques/maptiler/assets/sample-data/yarlung-flow.json12.8 KB
- 脚本remotion-maps/techniques/maptiler/assets/tokens.ts1.2 KB
- 参考文档remotion-maps/techniques/maptiler/references/map-data-sources.md4.7 KB
- 参考文档remotion-maps/techniques/maptiler/references/map-explainer-architecture.md6.7 KB
- 参考文档remotion-maps/techniques/maptiler/references/map-geo-prep.md4.0 KB
- 参考文档remotion-maps/techniques/maptiler/references/render-stability.md3.6 KB
- 脚本remotion-maps/techniques/maptiler/scripts/prep-geo.mjs7.4 KB
- 参考文档remotion-maps/techniques/maptiler/TECHNIQUE.md4.4 KB
- 参考文档remotion-maps/techniques/static-map/TECHNIQUE.md1.1 KB
- 参考文档sequencing.md3.7 KB
- 参考文档sfx.md1.8 KB
- 参考文档silence-detection.md2.5 KB
- 参考文档text-highlights.md1.8 KB
- 参考文档timing.md3.2 KB
- 参考文档transitions.md6.7 KB
- 参考文档video-editing.md3.3 KB
- 参考文档voiceover.md3.3 KB
03 SKILL.md 正文
This is guidance for writing Remotion React Markup. If this is not relevant, load Remotion Best Practices instead.
Preserve user changes
Users may make edits in the code outside of the conversation.
If you detect a surprising change made in the meanwhile, don't overwrite it, assume it was intentional or ask for confirmation.
General rules
Drive animations using useCurrentFrame() and interpolate().
CSS transition or animation will not render correctly, they need to refactored.
Tailwind animation class will not render correctly, they need to be refactored.
Use Easing.bezier() and Easing.spring() to customize timing.
Structure your markup according to Remotion Interactivity Best Practices
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Title"
style={{
opacity: interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Hello World!
</Interactive.Div>
);
};
Keep the interpolate() call inline in the style prop.
Use scale, translate, rotate CSS properties over transform.
// 👍 Inline editable keyframes and transform shorthands
style={{
scale: interpolate(frame, [0, 100], [0, 1], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
output: 'perceptual-scale' // For `scale` animations, use "output: 'perceptual-scale'"
}),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
}}
// 👎 Non-inline values and transform strings become harder to edit in Studio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Assets
Place assets in the public/ folder at your project root.
Use staticFile() to reference files from the public/ folder.
Media components
Add video and audio using <Video> and <Audio> from @remotion/media.
Add images using the <CanvasImage> component.
Add animated GIFs, APNG, WebP or AVIF images using <AnimatedImage>, use @remotion/gif if not using Chrome.
Use staticFile() for files in public/ or pass a remote URL directly:
import { Audio, Video } from "@remotion/media";
import { staticFile, CanvasImage, AnimatedImage } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<CanvasImage
src={staticFile("logo.png")}
style={{ width: 100, height: 100 }}
/>
<Video src="https://remotion.media/video.mp4" />
<AnimatedImage src={staticFile('nyancat.gif')} />
</>
);
};
Example scene
import {
AbsoluteFill,
Easing,
Interactive,
interpolate,
useCurrentFrame,
useVideoConfig
} from "remotion";
export const Empty = () => {
const {fps} = useVideoConfig();
const frame = useCurrentFrame();
return (
<AbsoluteFill
name="Scene"
style={{
display: 'flex',
justifyContent: 'center',
alignItems: 'center',
backgroundColor: 'white'
}}
>
<Interactive.Div
name="Title"
style={{
opacity: interpolate(frame, [1 * fps, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
fontSize: 88
}}
>
Title
</Interactive.Div>
<Interactive.Div
name="Subtitle"
style={{
opacity: interpolate(frame, [2 * fps, 3 * fps, 8 * fps, 10 * fps], [0, 1, 1, 0], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: [Easing.bezier(0.16, 1, 0.3, 1), Easing.linear, Easing.bezier(0.16, 1, 0.3, 1)],
}),
fontSize: 32
}}
>
Subtitle
</Interactive.Div>
</AbsoluteFill>
);
}
Delaying, trimming
Most components (<AbsoluteFill>, <Interactive.*> <Img>, <AnimatedImage>, <CanvasImage>, <HtmlInCanvas>, <Solid>, <Sequence> from remotion, <Video> and <Audio> from @remotion/media, <Gif>, and more) support the following props:
from
<Img from={1 * fps} {/* ... */}/>
<Video from={1 * fps} {/* ... */}/>
<Interactive.Div from={1 * fps} {/* ... */}/>
When the element starts appearing in the timelien.
durationInFrames
<Img durationInFrames={20 * fps} {/* ... */}/>
<Interactive.Div durationInFrames={20 * fps} {/* ... */}/>
For how long the layer plays in the timeline.
For media, pass the natural duration of the media: <Video durationInFrames={29.322 * fps}/>
trimBefore
Useful for components whose internal clock should start later:
// Trim away first 2 seconds of footage
<Video trimBefore={2 * fps} {/* ... */} />
// `useCurrenFrame()` for children starts at `10 * fps`
<Sequence trimBefore={10 * fps} {/* ... */} />
Fallback
If a component does not support these props, wrap it in<Sequence> from remotion, which has them.
layout="absolute-fill"makes the Sequence behave like AbsoluteFilllayout="none"is "headless" mode, no wrapper element is used.
Maps
See Remotion Maps if wanting to include maps in the video.
Text highlights and annotations
See text-highlights.md for text highlights (highlight markers), circles, underlines, strike-throughs, crossed-off text, boxes.
Multi-scene videos
See multi-scene-video.md if planning to make a video with multiple subsequent scenes.
Voiceover
See voiceover.md for adding an AI-generated voiceover to Remotion compositions using ElevenLabs TTS.
Embedding Videos
See embedding-videos.md for advanced knowledge about embedding videos - trimming, volume, speed, looping, pitch.
Embedding Audio
See audio.md for advanced audio features like trimming, volume, speed, pitch.
Video editing
See video-editing.md for structuring editable video timelines in Remotion Studio.
Cropping
See cropping.md if needing to crop the visible rectangle of a component.
Transitions
See transitions.md for scene transition patterns.
Visual and pixel effects
When creating a visual effect, consider whether it is feasible using CSS and HTML, or whether a shader is needed.
Order or preference:
- Regular HTML + CSS or other web techniques
- An effect applied to the element directly (
<Video>,<Img>), or by wrapping the content in<HtmlInCanvas>, which also acceptseffects:
- A listed effect via effects.md
- A custom
createEffect()via effects.md when no preset is available.
3D content
See ./3d.md for 3D content in Remotion using Three.js and React Three Fiber.
Sound effects
When needing to use sound effects, load the ./sfx.md file for more information.
Audio visualization
When needing to visualize audio (spectrum bars, waveforms, bass-reactive effects), load the ./audio-visualization.md file for more information.
Maps
For static maps, animated routes and markers, geographic explainers, Mapbox, MapLibre, MapTiler, GeoJSON, or 3D geographic flyovers, load Remotion Maps.
Captions
When dealing with captions or subtitles, load the Remotion Captions skill for more information.
Google Fonts
Is the recommended way to load fonts in Remotion. See google-fonts.md for how to load Google Fonts.
Local fonts
See local-fonts.md for how to load local fonts.
GIFs
See gifs.md for how to display GIFs synchronized with Remotion's timeline.
Advanced Images
See images.md for sizing and positioning images, dynamic image paths, and getting image dimensions.
Lottie animations
See lottie.md for embedding Lottie animations in Remotion.
Timing
See timing.md for more timing techniques for interpolate().
Parameterized videos
See parameters.md for making a composition parametrizable by adding a Zod schema.
Measuring DOM nodes
See measuring-dom-nodes.md for measuring DOM element dimensions in Remotion.
Measuring text
See measuring-text.md for measuring text dimensions, fitting text to containers, and checking overflow.
Using FFmpeg
For some video operations, such as trimming videos or detecting silence, FFmpeg should be used. Load the ./ffmpeg.md file for more information.
Silence detection
When needing to detect and trim silent segments from video or audio files, load the ./silence-detection.md file.
Dynamic duration, dimensions and data
See calculate-metadata.md for dynamically set composition duration, dimensions, and props.
Advanced compositions
See compositions.md for how to define stills, folders, default props and for how to nest compositions.
Advanced sequencing
See sequencing.md for more sequencing patterns - delay, trim, limit duration of items.
Install modules
Use npx remotion add to add new packages with the right version:
npx remotion add @remotion/media
This goes for @remotion/* packages, mediabunny, @mediabunny/*, and zod.
Previewing markup
npx remotion studio --no-open
This will start a long-running process and print the server URL for the preview.
If server is already started, it will print the URL.
You can visit a specific composition by navigating to /[composition-id], for example http://localhost:3000/MapAnimation.
Optional: one-frame render check
You can render a single frame with the CLI to sanity-check layout, colors, or timing.
Skip it for trivial edits, pure refactors, or when you already have enough confidence from Studio or prior renders.
npx remotion still [composition-id] --scale=0.25 --frame=30
At 30 fps, --frame=30 is the one-second mark (--frame is zero-based).
04 同仓库更多 Skills
youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
youtube-thumbnail-design
YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image
youtube-short-maker
Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: "youtube short", "make a youtube short", "shorts video", "short-form video". NOT for long-form or landscape video.
xcode-project-setup
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
x402
Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — "just use it" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or "build it in" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.
x-twitter-scraper
Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.