
Docs Demo
If you're working on Remotion's documentation and need to add an interactive demo that renders a composition inline using @remotion/player, this walks you through the exact file structure. You'll create a component in the demos folder, register it in types.ts with canvas dimensions and playback settings, add it to the demos array in index.tsx, then drop it into any MDX page. The options system is thoughtful: you can add sliders, checkboxes, dropdowns, or text inputs that get passed as props to your component, so readers can tweak parameters and see results live. It's narrowly scoped to one codebase, but if you're contributing to Remotion docs, it saves you from hunting through the repo to figure out the convention.
- skills.sh installs
- 2.6K
- GitHub stars
- 72.1K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add remotion-dev/remotion --skill docs-demo --agent claude-codeInstalls into .claude/skills of the current project.
Files
Adding an Interactive Demo to Docs
Interactive demos render a Remotion composition inline in documentation pages using @remotion/player. They live in packages/docs/components/demos/.
Effect demos are separate: use <EffectsDemo type="effects-..." /> and register them in packages/docs/components/effects-demos/registry.ts with the real effect schema, not the generic <Demo> options array.
Steps
-
Create a component in
packages/docs/components/demos/(e.g.MyDemo.tsx). It should be a standard React component using Remotion hooks likeuseCurrentFrame()anduseVideoConfig(). -
Register the demo in
packages/docs/components/demos/types.ts:- Import the component
- Export a
DemoTypeobject with these fields:id: unique string used in<Demo type="..." />comp: the React componentcompWidth/compHeight: canvas dimensions (e.g. 1280x720)fps: frame rate (typically 30)durationInFrames: animation lengthautoPlay: whether it plays automaticallyoptions: array of interactive controls (can be empty[])
Sponsors
Details
- Repository
- github.com/remotion-dev/remotion
- Categories
- Frontend Development, Documentation, Sales & Marketing, Generative Media
- First seen
- May 16, 2026