# edenfunf/reelmimic architecture

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

- Interactive diagram: https://gitdiagram.com/edenfunf/reelmimic
- Repository: https://github.com/edenfunf/reelmimic

## Overview

ReelMimic is a local video-remake workbench: users submit a reference and brief, review an analysis and plan, approve production, follow agent work and shot reviews, then comment on the finished video. The server coordinates the project lifecycle and Claude Code/Codex sessions; project artifacts and state live on disk. The README documents seven drawing engines, asset and music handling, proof-backed fixes, and multilingual UI. Several production skills and job internals were not sampled, so those subsystem links reflect README-level capabilities rather than inspected implementation details.

Main entry points: [`app/server/jobs.ts`](https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts) (Job coordinator), [`app/server/index.ts`](https://github.com/edenfunf/reelmimic/blob/main/app/server/index.ts) (REST and SSE), [`app/web/src/App.tsx`](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/App.tsx) (ReelMimic UI), [`app/web/src/Project.tsx`](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/Project.tsx) (Project view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Project workflow"]
  node_job_machine["Job coordinator<br/>[jobs.ts]"]
  node_project_state[("Project artifacts")]
  node_reference_analysis["Reference analysis<br/>[jobs.ts]"]
  node_plan_review["Plan and approval<br/>[jobs.ts]"]
end

subgraph group_production["Creative production"]
  node_style_routing["Style routing<br/>[skills]"]
  node_asset_music["Assets and music<br/>[skills]"]
  node_engine_skills["Drawing engines<br/>[skills]"]
  node_shot_review["Shot review<br/>[skills]"]
  node_final_video["Rendered video"]
end

subgraph group_runtime["Server runtime"]
  node_server["REST and SSE<br/>[index.ts]"]
  node_settings["Runtime settings<br/>[env.ts]"]
  node_agent_adapter["AI adapters<br/>[index.ts]"]
end

subgraph group_interface["Web interface"]
  node_web["ReelMimic UI<br/>[App.tsx]"]
  node_project_view["Project view<br/>[Project.tsx]"]
  node_chat_view["Chat and logs<br/>[Chat.tsx]"]
  node_translations["Translations<br/>[i18n.ts]"]
  node_api_client["API client<br/>[api.ts]"]
end

node_creator(("Creator"))

node_creator -->|"submits brief"| node_web
node_web -->|"selects language"| node_translations
node_web -->|"opens project"| node_project_view
node_project_view -->|"renders chat"| node_chat_view
node_web -->|"requests data"| node_api_client
node_project_view -->|"sends actions"| node_api_client
node_chat_view -->|"sends messages"| node_api_client
node_api_client -->|"calls REST/SSE"| node_server
node_server -->|"loads settings"| node_settings
node_server -->|"dispatches actions"| node_job_machine
node_job_machine -->|"reads and writes"| node_project_state
node_job_machine -.->|"analyzes reference"| node_reference_analysis
node_job_machine -.->|"routes style"| node_style_routing
node_job_machine -.->|"prepares plan"| node_plan_review
node_plan_review -.->|"requests approval"| node_creator
node_job_machine -.->|"handles assets"| node_asset_music
node_job_machine -.->|"dispatches rendering"| node_engine_skills
node_job_machine -->|"runs agent turns"| node_agent_adapter
node_agent_adapter -.->|"works in project"| node_project_state
node_job_machine -.->|"reviews shots"| node_shot_review
node_shot_review -.->|"requests fixes"| node_engine_skills
node_job_machine -.->|"delivers result"| node_final_video
node_server -->|"streams updates"| node_project_view

click node_web "https://github.com/edenfunf/reelmimic/blob/main/app/web/src/App.tsx"
click node_project_view "https://github.com/edenfunf/reelmimic/blob/main/app/web/src/Project.tsx"
click node_chat_view "https://github.com/edenfunf/reelmimic/blob/main/app/web/src/Chat.tsx"
click node_translations "https://github.com/edenfunf/reelmimic/blob/main/app/web/src/i18n.ts"
click node_api_client "https://github.com/edenfunf/reelmimic/blob/main/app/web/src/api.ts"
click node_server "https://github.com/edenfunf/reelmimic/blob/main/app/server/index.ts"
click node_settings "https://github.com/edenfunf/reelmimic/blob/main/app/server/env.ts"
click node_job_machine "https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts"
click node_project_state "https://github.com/edenfunf/reelmimic/tree/main/projects"
click node_reference_analysis "https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts"
click node_style_routing "https://github.com/edenfunf/reelmimic/tree/main/.claude/skills"
click node_plan_review "https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts"
click node_asset_music "https://github.com/edenfunf/reelmimic/tree/main/.claude/skills"
click node_engine_skills "https://github.com/edenfunf/reelmimic/tree/main/.claude/skills"
click node_agent_adapter "https://github.com/edenfunf/reelmimic/blob/main/app/server/agents/index.ts"
click node_shot_review "https://github.com/edenfunf/reelmimic/tree/main/.claude/skills"
click node_final_video "https://github.com/edenfunf/reelmimic/tree/main/projects"

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_job_machine,node_project_state,node_reference_analysis,node_plan_review toneBlue
class node_style_routing,node_asset_music,node_engine_skills,node_shot_review,node_final_video toneAmber
class node_server,node_settings,node_agent_adapter toneMint
class node_web,node_project_view,node_chat_view,node_translations,node_api_client toneRose
class node_creator toneIndigo
```

## Components

### Project workflow

- [Job coordinator](https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts): `app/server/jobs.ts`
- [Project artifacts](https://github.com/edenfunf/reelmimic/tree/main/projects): `projects`
- [Reference analysis](https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts): `app/server/jobs.ts`
- [Plan and approval](https://github.com/edenfunf/reelmimic/blob/main/app/server/jobs.ts): `app/server/jobs.ts`

### Creative production

- [Style routing](https://github.com/edenfunf/reelmimic/tree/main/.claude/skills): `.claude/skills`
- [Assets and music](https://github.com/edenfunf/reelmimic/tree/main/.claude/skills): `.claude/skills`
- [Drawing engines](https://github.com/edenfunf/reelmimic/tree/main/.claude/skills): `.claude/skills`
- [Shot review](https://github.com/edenfunf/reelmimic/tree/main/.claude/skills): `.claude/skills`
- [Rendered video](https://github.com/edenfunf/reelmimic/tree/main/projects): `projects`

### Server runtime

- [REST and SSE](https://github.com/edenfunf/reelmimic/blob/main/app/server/index.ts): `app/server/index.ts`
- [Runtime settings](https://github.com/edenfunf/reelmimic/blob/main/app/server/env.ts): `app/server/env.ts`
- [AI adapters](https://github.com/edenfunf/reelmimic/blob/main/app/server/agents/index.ts): `app/server/agents/index.ts`

### Web interface

- [ReelMimic UI](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/App.tsx): `app/web/src/App.tsx`
- [Project view](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/Project.tsx): `app/web/src/Project.tsx`
- [Chat and logs](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/Chat.tsx): `app/web/src/Chat.tsx`
- [Translations](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/i18n.ts): `app/web/src/i18n.ts`
- [API client](https://github.com/edenfunf/reelmimic/blob/main/app/web/src/api.ts): `app/web/src/api.ts`

### Other components

- **Creator**

## Connections

- Creator → ReelMimic UI: submits brief (evidence: `README.md`)
- ReelMimic UI → Translations: selects language (evidence: `app/web/src/App.tsx`)
- ReelMimic UI → Project view: opens project (evidence: `app/web/src/App.tsx`)
- Project view → Chat and logs: renders chat (evidence: `app/web/src/Project.tsx`)
- ReelMimic UI → API client: requests data (evidence: `app/web/src/App.tsx`)
- Project view → API client: sends actions (evidence: `app/web/src/Project.tsx`)
- Chat and logs → API client: sends messages (evidence: `app/web/src/Chat.tsx`)
- API client → REST and SSE: calls REST/SSE (evidence: `app/web/src/api.ts`)
- REST and SSE → Runtime settings: loads settings (evidence: `app/server/index.ts`)
- REST and SSE → Job coordinator: dispatches actions (evidence: `app/server/index.ts`)
- Job coordinator → Project artifacts: reads and writes (evidence: `app/server/jobs.ts`)
- Job coordinator → Reference analysis: analyzes reference (evidence: `README.md`)
- Job coordinator → Style routing: routes style (evidence: `README.md`)
- Job coordinator → Plan and approval: prepares plan (evidence: `README.md`)
- Plan and approval → Creator: requests approval (evidence: `README.md`)
- Job coordinator → Assets and music: handles assets (evidence: `README.md`)
- Job coordinator → Drawing engines: dispatches rendering (evidence: `README.md`)
- Job coordinator → AI adapters: runs agent turns (evidence: `app/server/jobs.ts`)
- AI adapters → Project artifacts: works in project
- Job coordinator → Shot review: reviews shots (evidence: `README.md`)
- Shot review → Drawing engines: requests fixes (evidence: `README.md`)
- Job coordinator → Rendered video: delivers result (evidence: `README.md`)
- REST and SSE → Project view: streams updates (evidence: `app/server/index.ts`)
