remotion-agent-catalog

A practical catalog for agents and teams building video with Remotion.

Live catalog · Architecture · Operational guidance

The official Remotion Agent Skills explain how to use the framework. This repository adds the project-level context an agent needs before it starts writing:

Agent Skills   → how to write Remotion correctly
catalog.json   → what already exists and where each component came from
AGENTS.md      → where it breaks and how the failure appears

The viewer is English-first and includes a pt-BR interface option. catalog.json remains the generated, canonical Portuguese data source; the viewer localizes its presentation without changing component IDs, import paths, library attribution, or preview provenance.

Start here

npm install
npm run web             # static viewer at http://localhost:8080/web/
npm run studio          # Remotion Studio at http://localhost:3000
npm run validate && npm test

To bring the catalog into another Remotion project:

curl -O https://raw.githubusercontent.com/victorsodre/remotion-agent-catalog/main/AGENTS.md
curl -O https://raw.githubusercontent.com/victorsodre/remotion-agent-catalog/main/catalog.json
npx skills add remotion-dev/skills

Install the component indicated by importa through its source library's CLI. The lib field in catalog.json is the source of truth for provenance.

Contents

Origin	In the catalog	Available in Studio
RemotionUI	68	Yes — CLI-installed under src/remotion/ and src/compositions/
Authored	20	Marketing BR, four 3D/motion demos, and 12 Brazil vertical components
remotion-bits (MIT)	10	Yes — imported from the npm package
remocn	4	Three components run in Studio; Typewriter is documented as a card

The count is verified from catalog.json by npm run validate. Components from a library are catalogued and tested here; they are not claimed as authored work.

Previews

The static viewer uses the real .webm file named by an item's optional preview field. When no file is available, it displays a clearly labelled illustrative CSS preview. Previews are paginated so the browser does not load the entire catalog at once.

To render a single preview in this repository:

npx remotion render PixQr-Autoral web/previews/PixQr-Autoral.webm --codec=vp8 --scale=0.5
node scripts/link-previews.mjs

See origin-templates for the source-project workflow. The generated catalog is read-only here, except for the preview field maintained by the documented linking script.

Scope and licensing

This repository is MIT-licensed for its catalog, viewer, CLI, MCP server, validator, and components marked Autoral in catalog.json. RemotionUI, remocn, and remotion-bits retain their own licenses and attribution. Remotion uses a two-tier license; assess its terms for your production use.

Made by @ovictor.