# vincentwei1021/video-shotcraft architecture

> Architecture diagram of the GitHub repository vincentwei1021/video-shotcraft, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vincentwei1021/video-shotcraft
- Repository: https://github.com/vincentwei1021/video-shotcraft

## Overview

video-shotcraft is an agent-oriented, code-rendered promo-video toolkit: an agent captures product pages, assembles a film from motion recipes, renders and checks the result, and can hand it off for continued editing or JianYing. Its Motion Workbench provides a browser timeline for editing cards, media, themes, and linked film units; the Gallery exposes the shot library and previews. README documents the end-to-end workflow and exports, while sampled source confirms the template scene composition and key Workbench wiring. Some export, capture, and QA implementation is unsampled, so those links reflect documented capabilities, not inspected calls.

Main entry points: [`template/src/aifl/Main.tsx`](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/Main.tsx) (Ink Press Film), [`template/src/aifl/live/PageCam.tsx`](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/PageCam.tsx) (Page Camera), [`workbench/src/App.tsx`](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/App.tsx) (Workbench UI), [`workbench/src/panels/LibraryPanel.tsx`](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/panels/LibraryPanel.tsx) (Motion Library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Film Creation"]
  node_capture["Page Capture"]
  node_storyboard["Shot Storyboard"]
end

subgraph group_template["Remotion Template"]
  node_templatefilm["Ink Press Film<br/>[Main.tsx]"]
  node_sceneopen["Opening Scene<br/>[SceneOpen.tsx]"]
  node_sceneflyin["Fly-in Scene<br/>[SceneFlyIn.tsx]"]
  node_scenedetail["Detail Scene<br/>[SceneDetail.tsx]"]
  node_scenepapers["Paper Scene<br/>[ScenePapers.tsx]"]
  node_scenewbr["WBR Scene<br/>[SceneWbr.tsx]"]
  node_sceneoutro["Live Outro<br/>[SceneOutroLive.tsx]"]
  node_pagecam["Page Camera<br/>[PageCam.tsx]"]
  node_titlecard["Paper Title Card<br/>[PaperTitleCard.tsx]"]
  node_visualtheme["Visual Themes<br/>[visual-theme.tsx]"]
  node_workbenchmanifest["Film Edit Manifest<br/>[workbench.ts]"]
end

subgraph group_editing["Motion Workbench"]
  node_workbenchapp["Workbench UI<br/>[App.tsx]"]
  node_library["Motion Library<br/>[LibraryPanel.tsx]"]
  node_registry["Card Registry<br/>[registry.ts]"]
  node_projectcards["Film Units<br/>[projectCards.ts]"]
  node_timeline["Timeline Editor<br/>[Timeline.tsx]"]
  node_preview["Film Preview<br/>[PreviewPanel.tsx]"]
  node_projectstate["Project State<br/>[store.ts]"]
end

subgraph group_gallery["Shot Gallery"]
  node_gallery["Gallery Previews<br/>[app.js]"]
  node_showcase["Community Showcase<br/>[showcase.js]"]
end

subgraph group_delivery["Delivery"]
  node_mp4["Rendered MP4"]
  node_frameqa["Frame QA"]
  node_jianying["JianYing Draft<br/>[mac_draft.py]"]
  node_windowsdraft["Windows Draft<br/>[windows_draft.py]"]
end

node_agent(("User / Agent"))

node_agent -->|"requests capture"| node_capture
node_capture -->|"provides pages"| node_storyboard
node_storyboard -->|"selects recipes"| node_templatefilm
node_templatefilm -->|"sequences"| node_sceneopen
node_templatefilm -->|"sequences"| node_sceneflyin
node_templatefilm -->|"sequences"| node_scenedetail
node_templatefilm -->|"sequences"| node_scenepapers
node_templatefilm -->|"sequences"| node_scenewbr
node_templatefilm -->|"sequences"| node_sceneoutro
node_templatefilm -->|"sequences"| node_titlecard
node_templatefilm -->|"uses theme"| node_visualtheme
node_sceneopen -->|"uses camera"| node_pagecam
node_sceneflyin -->|"uses camera"| node_pagecam
node_scenedetail -->|"uses camera"| node_pagecam
node_scenepapers -.->|"uses camera"| node_pagecam
node_scenewbr -.->|"uses camera"| node_pagecam
node_sceneoutro -.->|"uses camera"| node_pagecam
node_templatefilm -->|"describes edit units"| node_workbenchmanifest
node_agent -->|"edits film"| node_workbenchapp
node_workbenchapp -->|"renders"| node_library
node_workbenchapp -->|"renders"| node_timeline
node_workbenchapp -->|"renders"| node_preview
node_workbenchapp -->|"reads and updates"| node_projectstate
node_library -->|"lists cards"| node_registry
node_library -->|"lists film units"| node_projectcards
node_timeline -->|"edits clips"| node_projectstate
node_preview -->|"loads cards"| node_registry
node_preview -->|"reads project"| node_projectstate
node_workbenchmanifest -->|"defines film units"| node_projectcards
node_agent -->|"browses shots"| node_gallery
node_gallery -.->|"offers showcase"| node_showcase
node_templatefilm -->|"renders film"| node_mp4
node_mp4 -->|"checks frames"| node_frameqa
node_mp4 -->|"exports draft"| node_jianying
node_jianying -.->|"platform variant"| node_windowsdraft

click node_templatefilm "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/Main.tsx"
click node_sceneopen "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneOpen.tsx"
click node_sceneflyin "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneFlyIn.tsx"
click node_scenedetail "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneDetail.tsx"
click node_scenepapers "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/ScenePapers.tsx"
click node_scenewbr "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneWbr.tsx"
click node_sceneoutro "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneOutroLive.tsx"
click node_pagecam "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/PageCam.tsx"
click node_titlecard "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/PaperTitleCard.tsx"
click node_visualtheme "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/themes/visual-theme.tsx"
click node_workbenchmanifest "https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/workbench.ts"
click node_workbenchapp "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/App.tsx"
click node_library "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/panels/LibraryPanel.tsx"
click node_registry "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/cards/registry.ts"
click node_projectcards "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/cards/projectCards.ts"
click node_timeline "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/timeline/Timeline.tsx"
click node_preview "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/preview/PreviewPanel.tsx"
click node_projectstate "https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/store.ts"
click node_gallery "https://github.com/vincentwei1021/video-shotcraft/blob/main/gallery/app.js"
click node_showcase "https://github.com/vincentwei1021/video-shotcraft/blob/main/gallery/showcase.js"
click node_jianying "https://github.com/vincentwei1021/video-shotcraft/blob/main/jianying-export/mac_draft.py"
click node_windowsdraft "https://github.com/vincentwei1021/video-shotcraft/blob/main/jianying-export/windows_draft.py"

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_capture,node_storyboard,node_agent toneBlue
class node_templatefilm,node_sceneopen,node_sceneflyin,node_scenedetail,node_scenepapers,node_scenewbr,node_sceneoutro,node_pagecam,node_titlecard,node_visualtheme,node_workbenchmanifest toneAmber
class node_workbenchapp,node_library,node_registry,node_projectcards,node_timeline,node_preview,node_projectstate toneMint
class node_gallery,node_showcase toneRose
class node_mp4,node_frameqa,node_jianying,node_windowsdraft toneIndigo
```

## Components

### Film Creation

- **Page Capture**
- **Shot Storyboard**

### Remotion Template

- [Ink Press Film](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/Main.tsx): `template/src/aifl/Main.tsx`
- [Opening Scene](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneOpen.tsx): `template/src/aifl/live/SceneOpen.tsx`
- [Fly-in Scene](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneFlyIn.tsx): `template/src/aifl/live/SceneFlyIn.tsx`
- [Detail Scene](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneDetail.tsx): `template/src/aifl/live/SceneDetail.tsx`
- [Paper Scene](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/ScenePapers.tsx): `template/src/aifl/live/ScenePapers.tsx`
- [WBR Scene](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneWbr.tsx): `template/src/aifl/live/SceneWbr.tsx`
- [Live Outro](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/SceneOutroLive.tsx): `template/src/aifl/live/SceneOutroLive.tsx`
- [Page Camera](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/live/PageCam.tsx): `template/src/aifl/live/PageCam.tsx`
- [Paper Title Card](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/aifl/PaperTitleCard.tsx): `template/src/aifl/PaperTitleCard.tsx`
- [Visual Themes](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/themes/visual-theme.tsx): `template/src/themes/visual-theme.tsx`
- [Film Edit Manifest](https://github.com/vincentwei1021/video-shotcraft/blob/main/template/src/workbench.ts): `template/src/workbench.ts`

### Motion Workbench

- [Workbench UI](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/App.tsx): `workbench/src/App.tsx`
- [Motion Library](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/panels/LibraryPanel.tsx): `workbench/src/panels/LibraryPanel.tsx`
- [Card Registry](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/cards/registry.ts): `workbench/src/cards/registry.ts`
- [Film Units](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/cards/projectCards.ts): `workbench/src/cards/projectCards.ts`
- [Timeline Editor](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/timeline/Timeline.tsx): `workbench/src/timeline/Timeline.tsx`
- [Film Preview](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/preview/PreviewPanel.tsx): `workbench/src/preview/PreviewPanel.tsx`
- [Project State](https://github.com/vincentwei1021/video-shotcraft/blob/main/workbench/src/store.ts): `workbench/src/store.ts`

### Shot Gallery

- [Gallery Previews](https://github.com/vincentwei1021/video-shotcraft/blob/main/gallery/app.js): `gallery/app.js`
- [Community Showcase](https://github.com/vincentwei1021/video-shotcraft/blob/main/gallery/showcase.js): `gallery/showcase.js`

### Delivery

- **Rendered MP4**
- **Frame QA**
- [JianYing Draft](https://github.com/vincentwei1021/video-shotcraft/blob/main/jianying-export/mac_draft.py): `jianying-export/mac_draft.py`
- [Windows Draft](https://github.com/vincentwei1021/video-shotcraft/blob/main/jianying-export/windows_draft.py): `jianying-export/windows_draft.py`

### Other components

- **User / Agent**

## Connections

- User / Agent → Page Capture: requests capture (evidence: `README.md`)
- Page Capture → Shot Storyboard: provides pages (evidence: `README.md`)
- Shot Storyboard → Ink Press Film: selects recipes (evidence: `README.md`)
- Ink Press Film → Opening Scene: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Fly-in Scene: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Detail Scene: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Paper Scene: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → WBR Scene: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Live Outro: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Paper Title Card: sequences (evidence: `template/src/aifl/Main.tsx`)
- Ink Press Film → Visual Themes: uses theme (evidence: `template/src/aifl/Main.tsx`)
- Opening Scene → Page Camera: uses camera (evidence: `template/src/aifl/live/SceneOpen.tsx`)
- Fly-in Scene → Page Camera: uses camera (evidence: `template/src/aifl/live/SceneFlyIn.tsx`)
- Detail Scene → Page Camera: uses camera (evidence: `template/src/aifl/live/SceneDetail.tsx`)
- Paper Scene → Page Camera: uses camera (evidence: `template/src/aifl/live/ScenePapers.tsx`)
- WBR Scene → Page Camera: uses camera (evidence: `template/src/aifl/live/SceneWbr.tsx`)
- Live Outro → Page Camera: uses camera (evidence: `template/src/aifl/live/SceneOutroLive.tsx`)
- Ink Press Film → Film Edit Manifest: describes edit units (evidence: `template/src/workbench.ts`)
- User / Agent → Workbench UI: edits film (evidence: `README.md`)
- Workbench UI → Motion Library: renders (evidence: `workbench/src/App.tsx`)
- Workbench UI → Timeline Editor: renders (evidence: `workbench/src/App.tsx`)
- Workbench UI → Film Preview: renders (evidence: `workbench/src/App.tsx`)
- Workbench UI → Project State: reads and updates (evidence: `workbench/src/App.tsx`)
- Motion Library → Card Registry: lists cards (evidence: `workbench/src/panels/LibraryPanel.tsx`)
- Motion Library → Film Units: lists film units (evidence: `workbench/src/panels/LibraryPanel.tsx`)
- Timeline Editor → Project State: edits clips (evidence: `workbench/src/timeline/Timeline.tsx`)
- Film Preview → Card Registry: loads cards (evidence: `workbench/src/preview/PreviewPanel.tsx`)
- Film Preview → Project State: reads project (evidence: `workbench/src/preview/PreviewPanel.tsx`)
- Film Edit Manifest → Film Units: defines film units (evidence: `workbench/src/cards/projectCards.ts`)
- User / Agent → Gallery Previews: browses shots (evidence: `README.md`)
- Gallery Previews → Community Showcase: offers showcase
- Ink Press Film → Rendered MP4: renders film (evidence: `README.md`)
- Rendered MP4 → Frame QA: checks frames (evidence: `README.md`)
- Rendered MP4 → JianYing Draft: exports draft (evidence: `README.md`)
- JianYing Draft → Windows Draft: platform variant
