# wassermanproductions/scriptbreak architecture

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

- Interactive diagram: https://gitdiagram.com/wassermanproductions/scriptbreak
- Repository: https://github.com/wassermanproductions/scriptbreak

## Overview

ScriptBreak is an offline screenplay-breakdown desktop app, with a separate stdio MCP server for inspecting saved projects and generating exports. The main workflow is script import → breakdown and editable production planning → local project data → exports. README-documented capabilities are represented at the frontend path because its implementation was not sampled; MCP responsibilities and file reading are supported by the sampled server excerpt. The frontend’s detailed internal calls and persistence wiring were not shown, so those relationships are omitted or attributed only to explicit documentation.

Main entry points: [`src/index.html`](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html) (ScriptBreak app), [`mcp/scriptbreak-mcp.mjs`](https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs) (MCP stdio server), [`src-tauri/src/main.rs`](https://github.com/wassermanproductions/scriptbreak/blob/master/src-tauri/src/main.rs) (Tauri wrapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop breakdown"]
  node_frontend["ScriptBreak app<br/>[index.html]"]
  node_breakdown["Script breakdown<br/>[index.html]"]
  node_projectdata[("Project library<br/>[index.html]")]
  node_drafts["Draft comparison<br/>[index.html]"]
  node_tagging["Element tagging<br/>[index.html]"]
  node_bibles["Production bibles<br/>[index.html]"]
  node_lookguide["Look and style guide<br/>[index.html]"]
  node_tauri["Tauri wrapper<br/>[main.rs]"]
end

subgraph group_planning["Production planning"]
  node_shots["Shot lists<br/>[index.html]"]
  node_timeline["Timeline<br/>[index.html]"]
  node_schedule["Schedule and DOOD<br/>[index.html]"]
end

subgraph group_exports["Exports and prompts"]
  node_exports["Breakdown exports<br/>[index.html]"]
  node_promptpacks["Prompt packs<br/>[index.html]"]
end

subgraph group_mcp["MCP access"]
  node_mcpserver["MCP stdio server"]
  node_savedproject["Saved project file"]
  node_mcpquery["Project query tools"]
  node_mcpexport["MCP pack export"]
end

node_filmmaker(("Filmmaker"))
node_script["Screenplay file"]
node_llm(("External LLM"))
node_mcpclient(("MCP client"))

node_filmmaker -->|"loads script"| node_frontend
node_frontend -->|"imports and breaks down"| node_breakdown
node_breakdown -->|"seeds project"| node_projectdata
node_frontend -->|"compares drafts"| node_drafts
node_frontend -->|"edits tags"| node_tagging
node_frontend -->|"edits seeded bibles"| node_bibles
node_frontend -->|"ingests style PDF"| node_lookguide
node_frontend -->|"edits shot lists"| node_shots
node_frontend -->|"shows scenes"| node_timeline
node_frontend -->|"plans shoot days"| node_schedule
node_frontend -->|"exports breakdowns"| node_exports
node_frontend -->|"generates prompt packs"| node_promptpacks
node_filmmaker -->|"requests project data"| node_mcpclient
node_mcpclient -->|"sends tool calls"| node_mcpserver
node_mcpserver -->|"reads JSON"| node_savedproject
node_mcpserver -->|"dispatches tools"| node_mcpquery
node_mcpserver -->|"dispatches generators"| node_mcpexport
node_mcpexport -->|"returns Markdown"| node_mcpclient
node_promptpacks -->|"pasted into"| node_llm
node_frontend -->|"runs in desktop wrapper"| node_tauri

click node_frontend "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_breakdown "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_projectdata "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_drafts "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_tagging "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_bibles "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_lookguide "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_shots "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_timeline "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_schedule "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_exports "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_promptpacks "https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html"
click node_mcpserver "https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs"
click node_mcpquery "https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs"
click node_mcpexport "https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs"
click node_tauri "https://github.com/wassermanproductions/scriptbreak/blob/master/src-tauri/src/main.rs"

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_frontend,node_breakdown,node_projectdata,node_drafts,node_tagging,node_bibles,node_lookguide,node_tauri,node_script,node_mcpclient toneBlue
class node_shots,node_timeline,node_schedule toneAmber
class node_exports,node_promptpacks toneMint
class node_mcpserver,node_savedproject,node_mcpquery,node_mcpexport toneRose
class node_filmmaker,node_llm toneIndigo
```

## Components

### Desktop breakdown

- [ScriptBreak app](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Script breakdown](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Project library](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Draft comparison](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Element tagging](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Production bibles](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Look and style guide](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Tauri wrapper](https://github.com/wassermanproductions/scriptbreak/blob/master/src-tauri/src/main.rs): `src-tauri/src/main.rs`

### Production planning

- [Shot lists](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Timeline](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Schedule and DOOD](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`

### Exports and prompts

- [Breakdown exports](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`
- [Prompt packs](https://github.com/wassermanproductions/scriptbreak/blob/master/src/index.html): `src/index.html`

### MCP access

- [MCP stdio server](https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs): `mcp/scriptbreak-mcp.mjs`
- **Saved project file**
- [Project query tools](https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs): `mcp/scriptbreak-mcp.mjs`
- [MCP pack export](https://github.com/wassermanproductions/scriptbreak/blob/master/mcp/scriptbreak-mcp.mjs): `mcp/scriptbreak-mcp.mjs`

### Other components

- **Filmmaker**
- **Screenplay file**
- **External LLM**
- **MCP client**

## Connections

- Filmmaker → ScriptBreak app: loads script (evidence: `README.md`)
- ScriptBreak app → Script breakdown: imports and breaks down (evidence: `README.md`)
- Script breakdown → Project library: seeds project (evidence: `README.md`)
- ScriptBreak app → Draft comparison: compares drafts (evidence: `README.md`)
- ScriptBreak app → Element tagging: edits tags (evidence: `README.md`)
- ScriptBreak app → Production bibles: edits seeded bibles (evidence: `README.md`)
- ScriptBreak app → Look and style guide: ingests style PDF (evidence: `README.md`)
- ScriptBreak app → Shot lists: edits shot lists (evidence: `README.md`)
- ScriptBreak app → Timeline: shows scenes (evidence: `README.md`)
- ScriptBreak app → Schedule and DOOD: plans shoot days (evidence: `README.md`)
- ScriptBreak app → Breakdown exports: exports breakdowns (evidence: `README.md`)
- ScriptBreak app → Prompt packs: generates prompt packs (evidence: `README.md`)
- Filmmaker → MCP client: requests project data
- MCP client → MCP stdio server: sends tool calls (evidence: `mcp/scriptbreak-mcp.mjs`)
- MCP stdio server → Saved project file: reads JSON (evidence: `mcp/scriptbreak-mcp.mjs`)
- MCP stdio server → Project query tools: dispatches tools (evidence: `mcp/scriptbreak-mcp.mjs`)
- MCP stdio server → MCP pack export: dispatches generators (evidence: `mcp/scriptbreak-mcp.mjs`)
- MCP pack export → MCP client: returns Markdown (evidence: `mcp/scriptbreak-mcp.mjs`)
- Prompt packs → External LLM: pasted into (evidence: `README.md`)
- ScriptBreak app → Tauri wrapper: runs in desktop wrapper (evidence: `README.md`)
