# ryanmatthes/remotion-studio architecture

> Architecture diagram of the GitHub repository ryanmatthes/remotion-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ryanmatthes/remotion-studio
- Repository: https://github.com/ryanmatthes/remotion-studio

## Overview

Remotion Studio turns TypeScript video data into a registered Remotion composition that renders as an MP4. In the demonstrated Video002 workflow, its scene sequence selects templates, which render the title, text, bullet, statistic, and outro stages; shared tokens and animation hooks provide styling and motion. The repository also includes three additional documented templates and reusable visual components. The graph uses README and SOURCE INDEX relationships, plus sampled source excerpts; several template internals and the font/audio wiring were not sampled.

Main entry points: [`src/tokens.ts`](https://github.com/ryanmatthes/remotion-studio/blob/main/src/tokens.ts) (Design tokens), [`src/videos/Video002/index.tsx`](https://github.com/ryanmatthes/remotion-studio/blob/main/src/videos/Video002/index.tsx) (Video002 sequence), [`src/templates/TitleCard/index.tsx`](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/TitleCard/index.tsx) (TitleCard), [`src/templates/OutroCard/index.tsx`](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/OutroCard/index.tsx) (OutroCard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_composition["Composition flow"]
  node_scene_data["Scene data<br/>[data.ts]"]
  node_video002["Video002 sequence<br/>[index.tsx]"]
  node_root["Composition registry<br/>[Root.tsx]"]
end

subgraph group_templates["Video templates"]
  node_title["TitleCard<br/>[index.tsx]"]
  node_text["TextSlide<br/>[index.tsx]"]
  node_bullets["BulletReveal<br/>[index.tsx]"]
  node_stat["StatCard<br/>[index.tsx]"]
  node_outro["OutroCard<br/>[index.tsx]"]
  node_image["ImageReveal<br/>[index.tsx]"]
  node_list["ListRace<br/>[index.tsx]"]
  node_quote["QuoteCard<br/>[index.tsx]"]
end

subgraph group_design["Design system"]
  node_tokens["Design tokens<br/>[tokens.ts]"]
  node_fonts["Font loader<br/>[fonts.ts]"]
end

subgraph group_motion["Motion and effects"]
  node_text_reveal["Text reveal hook<br/>[useTextReveal.ts]"]
  node_slide_in["Slide-in hook<br/>[useSlideIn.ts]"]
  node_count_up["Count-up hook<br/>[useCountUp.ts]"]
  node_stagger["Stagger hook<br/>[useStagger.ts]"]
  node_gradient["Gradient background<br/>[GradientBg.tsx]"]
  node_noise["Film grain<br/>[Noise.tsx]"]
  node_progress["Progress bar<br/>[ProgressBar.tsx]"]
  node_animated_text["Animated text<br/>[AnimatedText.tsx]"]
  node_audio["Audio track<br/>[AudioTrack.tsx]"]
end

node_author(("Video author"))
node_render["Remotion renderer"]

node_author -->|"authors content"| node_scene_data
node_scene_data -->|"supplies sequence"| node_video002
node_video002 -->|"selects template"| node_title
node_video002 -->|"selects template"| node_text
node_video002 -->|"selects template"| node_bullets
node_video002 -->|"selects template"| node_stat
node_video002 -->|"selects template"| node_outro
node_root -->|"registers composition"| node_video002
node_root -->|"sets dimensions"| node_tokens
node_root -->|"loads fonts"| node_fonts
node_render -->|"renders composition"| node_root
node_title -->|"uses theme tokens"| node_tokens
node_text -->|"uses theme tokens"| node_tokens
node_bullets -->|"uses theme tokens"| node_tokens
node_stat -->|"uses theme tokens"| node_tokens
node_outro -->|"uses theme tokens"| node_tokens
node_image -->|"uses theme tokens"| node_tokens
node_list -->|"uses theme tokens"| node_tokens
node_quote -->|"uses theme tokens"| node_tokens
node_title -->|"animates words"| node_text_reveal
node_title -->|"renders background"| node_gradient
node_title -->|"renders grain"| node_noise
node_text -->|"reveals text"| node_text_reveal
node_text -->|"renders grain"| node_noise
node_bullets -->|"slides heading"| node_slide_in
node_stat -->|"animates value"| node_count_up
node_stat -->|"slides label"| node_slide_in
node_outro -->|"renders background"| node_gradient
node_outro -->|"renders progress"| node_progress
node_outro -->|"renders grain"| node_noise
node_quote -->|"slides content"| node_slide_in
node_count_up -->|"formats numbers"| node_tokens

click node_scene_data "https://github.com/ryanmatthes/remotion-studio/blob/main/src/videos/Video002/data.ts"
click node_video002 "https://github.com/ryanmatthes/remotion-studio/blob/main/src/videos/Video002/index.tsx"
click node_root "https://github.com/ryanmatthes/remotion-studio/blob/main/src/Root.tsx"
click node_title "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/TitleCard/index.tsx"
click node_text "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/TextSlide/index.tsx"
click node_bullets "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/BulletReveal/index.tsx"
click node_stat "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/StatCard/index.tsx"
click node_outro "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/OutroCard/index.tsx"
click node_image "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/ImageReveal/index.tsx"
click node_list "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/ListRace/index.tsx"
click node_quote "https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/QuoteCard/index.tsx"
click node_tokens "https://github.com/ryanmatthes/remotion-studio/blob/main/src/tokens.ts"
click node_fonts "https://github.com/ryanmatthes/remotion-studio/blob/main/src/lib/fonts.ts"
click node_text_reveal "https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useTextReveal.ts"
click node_slide_in "https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useSlideIn.ts"
click node_count_up "https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useCountUp.ts"
click node_stagger "https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useStagger.ts"
click node_gradient "https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/GradientBg.tsx"
click node_noise "https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/Noise.tsx"
click node_progress "https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/ProgressBar.tsx"
click node_animated_text "https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/AnimatedText.tsx"
click node_audio "https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/AudioTrack.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scene_data,node_video002,node_root toneBlue
class node_title,node_text,node_bullets,node_stat,node_outro,node_image,node_list,node_quote toneAmber
class node_tokens,node_fonts toneMint
class node_text_reveal,node_slide_in,node_count_up,node_stagger,node_gradient,node_noise,node_progress,node_animated_text,node_audio toneRose
class node_author,node_render toneIndigo
```

## Components

### Composition flow

- [Scene data](https://github.com/ryanmatthes/remotion-studio/blob/main/src/videos/Video002/data.ts): `src/videos/Video002/data.ts`
- [Video002 sequence](https://github.com/ryanmatthes/remotion-studio/blob/main/src/videos/Video002/index.tsx): `src/videos/Video002/index.tsx`
- [Composition registry](https://github.com/ryanmatthes/remotion-studio/blob/main/src/Root.tsx): `src/Root.tsx`

### Video templates

- [TitleCard](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/TitleCard/index.tsx): `src/templates/TitleCard/index.tsx`
- [TextSlide](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/TextSlide/index.tsx): `src/templates/TextSlide/index.tsx`
- [BulletReveal](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/BulletReveal/index.tsx): `src/templates/BulletReveal/index.tsx`
- [StatCard](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/StatCard/index.tsx): `src/templates/StatCard/index.tsx`
- [OutroCard](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/OutroCard/index.tsx): `src/templates/OutroCard/index.tsx`
- [ImageReveal](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/ImageReveal/index.tsx): `src/templates/ImageReveal/index.tsx`
- [ListRace](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/ListRace/index.tsx): `src/templates/ListRace/index.tsx`
- [QuoteCard](https://github.com/ryanmatthes/remotion-studio/blob/main/src/templates/QuoteCard/index.tsx): `src/templates/QuoteCard/index.tsx`

### Design system

- [Design tokens](https://github.com/ryanmatthes/remotion-studio/blob/main/src/tokens.ts): `src/tokens.ts`
- [Font loader](https://github.com/ryanmatthes/remotion-studio/blob/main/src/lib/fonts.ts): `src/lib/fonts.ts`

### Motion and effects

- [Text reveal hook](https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useTextReveal.ts): `src/hooks/useTextReveal.ts`
- [Slide-in hook](https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useSlideIn.ts): `src/hooks/useSlideIn.ts`
- [Count-up hook](https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useCountUp.ts): `src/hooks/useCountUp.ts`
- [Stagger hook](https://github.com/ryanmatthes/remotion-studio/blob/main/src/hooks/useStagger.ts): `src/hooks/useStagger.ts`
- [Gradient background](https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/GradientBg.tsx): `src/components/GradientBg.tsx`
- [Film grain](https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/Noise.tsx): `src/components/Noise.tsx`
- [Progress bar](https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/ProgressBar.tsx): `src/components/ProgressBar.tsx`
- [Animated text](https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/AnimatedText.tsx): `src/components/AnimatedText.tsx`
- [Audio track](https://github.com/ryanmatthes/remotion-studio/blob/main/src/components/AudioTrack.tsx): `src/components/AudioTrack.tsx`

### Other components

- **Video author**
- **Remotion renderer**

## Connections

- Video author → Scene data: authors content (evidence: `README.md`)
- Scene data → Video002 sequence: supplies sequence (evidence: `src/videos/Video002/index.tsx`)
- Video002 sequence → TitleCard: selects template (evidence: `src/videos/Video002/index.tsx`)
- Video002 sequence → TextSlide: selects template (evidence: `src/videos/Video002/index.tsx`)
- Video002 sequence → BulletReveal: selects template (evidence: `src/videos/Video002/index.tsx`)
- Video002 sequence → StatCard: selects template (evidence: `src/videos/Video002/index.tsx`)
- Video002 sequence → OutroCard: selects template (evidence: `src/videos/Video002/index.tsx`)
- Composition registry → Video002 sequence: registers composition (evidence: `src/Root.tsx`)
- Composition registry → Design tokens: sets dimensions (evidence: `src/Root.tsx`)
- Composition registry → Font loader: loads fonts (evidence: `src/Root.tsx`)
- Remotion renderer → Composition registry: renders composition (evidence: `README.md`)
- TitleCard → Design tokens: uses theme tokens (evidence: `src/templates/TitleCard/index.tsx`)
- TextSlide → Design tokens: uses theme tokens (evidence: `src/templates/TextSlide/index.tsx`)
- BulletReveal → Design tokens: uses theme tokens (evidence: `src/templates/BulletReveal/index.tsx`)
- StatCard → Design tokens: uses theme tokens (evidence: `src/templates/StatCard/index.tsx`)
- OutroCard → Design tokens: uses theme tokens (evidence: `src/templates/OutroCard/index.tsx`)
- ImageReveal → Design tokens: uses theme tokens (evidence: `src/templates/ImageReveal/index.tsx`)
- ListRace → Design tokens: uses theme tokens (evidence: `src/templates/ListRace/index.tsx`)
- QuoteCard → Design tokens: uses theme tokens (evidence: `src/templates/QuoteCard/index.tsx`)
- TitleCard → Text reveal hook: animates words (evidence: `src/templates/TitleCard/index.tsx`)
- TitleCard → Gradient background: renders background (evidence: `src/templates/TitleCard/index.tsx`)
- TitleCard → Film grain: renders grain (evidence: `src/templates/TitleCard/index.tsx`)
- TextSlide → Text reveal hook: reveals text (evidence: `src/templates/TextSlide/index.tsx`)
- TextSlide → Film grain: renders grain (evidence: `src/templates/TextSlide/index.tsx`)
- BulletReveal → Slide-in hook: slides heading (evidence: `src/templates/BulletReveal/index.tsx`)
- StatCard → Count-up hook: animates value (evidence: `src/templates/StatCard/index.tsx`)
- StatCard → Slide-in hook: slides label (evidence: `src/templates/StatCard/index.tsx`)
- OutroCard → Gradient background: renders background (evidence: `src/templates/OutroCard/index.tsx`)
- OutroCard → Progress bar: renders progress (evidence: `src/templates/OutroCard/index.tsx`)
- OutroCard → Film grain: renders grain (evidence: `src/templates/OutroCard/index.tsx`)
- QuoteCard → Slide-in hook: slides content (evidence: `src/templates/QuoteCard/index.tsx`)
- Count-up hook → Design tokens: formats numbers (evidence: `src/hooks/useCountUp.ts`)
