# malte9799/factoriotools architecture

> Architecture diagram of the GitHub repository malte9799/factoriotools, 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/malte9799/factoriotools
- Repository: https://github.com/malte9799/factoriotools

## Overview

FactorioTools is a client-side blueprint editor and production-analysis app, with a separate live map seed viewer. The main workflow mounts the editor, loads blueprint/game data, renders and edits the layout, then calculates rates and simulates belts/circuits for bottleneck analysis and export. The graph includes documented map-generation, overlay, and game-art capabilities; the excerpts do not expose every internal call, so uncertain links are omitted rather than inferred.

Main entry points: [`apps/site/src/tools/blueprint-editor/index.ts`](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/blueprint-editor/index.ts) (Blueprint Editing), [`apps/site/src/rate-overlay/controller.ts`](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/controller.ts) (Rate Overlay), [`packages/renderer/src/render.ts`](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/render.ts) (Canvas Renderer), [`apps/site/src/app.ts`](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/app.ts) (App Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Blueprint Editor"]
  node_app["App Router<br/>[app.ts]"]
  node_blueprint["Blueprint Editing<br/>[index.ts]"]
  node_window["Floating Windows<br/>[window-manager.ts]"]
end

subgraph group_analysis["Production Analysis"]
  node_rate["Rate Overlay<br/>[controller.ts]"]
  node_ratepanels["Analysis Panels<br/>[panels.ts]"]
  node_issues["Bottleneck Detection<br/>[issues.ts]"]
  node_labfactory["Simulation Factory<br/>[factory.ts]"]
  node_overlaylab["Overlay Lab<br/>[index.ts]"]
end

subgraph group_rendering["Game Rendering"]
  node_renderer["Canvas Renderer<br/>[render.ts]"]
  node_collect["Draw Collection<br/>[collect.ts]"]
  node_commands["Draw Commands<br/>[commands.ts]"]
  node_paint["Canvas Painting<br/>[paint.ts]"]
  node_atlas["Sprite Atlas<br/>[spriteAtlas.ts]"]
  node_catalog["Render Catalog<br/>[render-catalog.ts]"]
end

subgraph group_core["Engine and Simulation"]
  node_engine["Blueprint and Rates<br/>[blueprint.ts]"]
  node_ratecalc["Rate Calculation<br/>[throughput.ts]"]
  node_belt["Belt Simulation<br/>[beltSim.ts]"]
  node_circuits["Circuit Simulation<br/>[circuit.ts]"]
end

subgraph group_seed["Seed Viewer"]
  node_seedviewer["Seed Viewer<br/>[index.ts]"]
  node_worker["Map Worker<br/>[worker.ts]"]
  node_mapgen["Map Generation<br/>[surface.ts]"]
end

node_user(("Player"))

node_user -->|"opens tool"| node_app
node_app -->|"mounts editor"| node_blueprint
node_app -->|"routes to"| node_overlaylab
node_app -->|"routes to"| node_seedviewer
node_blueprint -->|"creates windows"| node_window
node_blueprint -->|"imports and exports"| node_engine
node_blueprint -.->|"renders layout"| node_renderer
node_blueprint -->|"attaches analysis"| node_rate
node_rate -->|"loads data"| node_engine
node_rate -->|"builds simulation"| node_labfactory
node_rate -->|"detects issues"| node_issues
node_rate -->|"updates panels"| node_ratepanels
node_ratepanels -->|"reads settings"| node_rate
node_labfactory -.->|"steps simulation"| node_belt
node_labfactory -.->|"runs circuits"| node_circuits
node_engine -->|"calculates throughput"| node_ratecalc
node_renderer -->|"collects draw data"| node_collect
node_collect -->|"emits commands"| node_commands
node_renderer -->|"paints frame"| node_paint
node_paint -->|"consumes commands"| node_commands
node_paint -->|"loads sprites"| node_atlas
node_overlaylab -->|"configures overlay"| node_rate
node_user -->|"enters seed"| node_seedviewer
node_seedviewer -->|"requests generation"| node_worker
node_worker -->|"generates map"| node_mapgen
node_user -->|"imports blueprint"| node_blueprint
node_user -->|"exports blueprint"| node_blueprint
node_user -.->|"views game art"| node_renderer
node_catalog -.->|"supplies drawing data"| node_renderer

click node_app "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/app.ts"
click node_blueprint "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/blueprint-editor/index.ts"
click node_window "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/window-manager.ts"
click node_rate "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/controller.ts"
click node_ratepanels "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/panels.ts"
click node_issues "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/issues.ts"
click node_labfactory "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/factory.ts"
click node_overlaylab "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/overlay-lab/index.ts"
click node_engine "https://github.com/malte9799/factoriotools/blob/main/packages/engine/src/blueprint.ts"
click node_ratecalc "https://github.com/malte9799/factoriotools/blob/main/packages/engine/src/calc/throughput.ts"
click node_belt "https://github.com/malte9799/factoriotools/blob/main/packages/sim/src/beltSim.ts"
click node_circuits "https://github.com/malte9799/factoriotools/blob/main/packages/sim/src/circuit.ts"
click node_renderer "https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/render.ts"
click node_collect "https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/collect.ts"
click node_commands "https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/commands.ts"
click node_paint "https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/paint.ts"
click node_atlas "https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/spriteAtlas.ts"
click node_catalog "https://github.com/malte9799/factoriotools/blob/main/packages/data-pipeline/src/render-catalog.ts"
click node_seedviewer "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/seed-viewer/index.ts"
click node_worker "https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/seed-viewer/worker.ts"
click node_mapgen "https://github.com/malte9799/factoriotools/blob/main/packages/mapgen/src/surface.ts"

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_app,node_blueprint,node_window toneBlue
class node_rate,node_ratepanels,node_issues,node_labfactory,node_overlaylab toneAmber
class node_renderer,node_collect,node_commands,node_paint,node_atlas,node_catalog toneMint
class node_engine,node_ratecalc,node_belt,node_circuits toneRose
class node_seedviewer,node_worker,node_mapgen,node_user toneIndigo
```

## Components

### Blueprint Editor

- [App Router](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/app.ts): `apps/site/src/app.ts`
- [Blueprint Editing](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/blueprint-editor/index.ts): `apps/site/src/tools/blueprint-editor/index.ts`
- [Floating Windows](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/window-manager.ts): `apps/site/src/window-manager.ts`

### Production Analysis

- [Rate Overlay](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/controller.ts): `apps/site/src/rate-overlay/controller.ts`
- [Analysis Panels](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/panels.ts): `apps/site/src/rate-overlay/panels.ts`
- [Bottleneck Detection](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/issues.ts): `apps/site/src/rate-overlay/issues.ts`
- [Simulation Factory](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/rate-overlay/factory.ts): `apps/site/src/rate-overlay/factory.ts`
- [Overlay Lab](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/overlay-lab/index.ts): `apps/site/src/tools/overlay-lab/index.ts`

### Game Rendering

- [Canvas Renderer](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/render.ts): `packages/renderer/src/render.ts`
- [Draw Collection](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/collect.ts): `packages/renderer/src/draw/collect.ts`
- [Draw Commands](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/commands.ts): `packages/renderer/src/draw/commands.ts`
- [Canvas Painting](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/draw/paint.ts): `packages/renderer/src/draw/paint.ts`
- [Sprite Atlas](https://github.com/malte9799/factoriotools/blob/main/packages/renderer/src/spriteAtlas.ts): `packages/renderer/src/spriteAtlas.ts`
- [Render Catalog](https://github.com/malte9799/factoriotools/blob/main/packages/data-pipeline/src/render-catalog.ts): `packages/data-pipeline/src/render-catalog.ts`

### Engine and Simulation

- [Blueprint and Rates](https://github.com/malte9799/factoriotools/blob/main/packages/engine/src/blueprint.ts): `packages/engine/src/blueprint.ts`
- [Rate Calculation](https://github.com/malte9799/factoriotools/blob/main/packages/engine/src/calc/throughput.ts): `packages/engine/src/calc/throughput.ts`
- [Belt Simulation](https://github.com/malte9799/factoriotools/blob/main/packages/sim/src/beltSim.ts): `packages/sim/src/beltSim.ts`
- [Circuit Simulation](https://github.com/malte9799/factoriotools/blob/main/packages/sim/src/circuit.ts): `packages/sim/src/circuit.ts`

### Seed Viewer

- [Seed Viewer](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/seed-viewer/index.ts): `apps/site/src/tools/seed-viewer/index.ts`
- [Map Worker](https://github.com/malte9799/factoriotools/blob/main/apps/site/src/tools/seed-viewer/worker.ts): `apps/site/src/tools/seed-viewer/worker.ts`
- [Map Generation](https://github.com/malte9799/factoriotools/blob/main/packages/mapgen/src/surface.ts): `packages/mapgen/src/surface.ts`

### Other components

- **Player**

## Connections

- Player → App Router: opens tool (evidence: `apps/site/src/app.ts`)
- App Router → Blueprint Editing: mounts editor (evidence: `apps/site/src/app.ts`)
- App Router → Overlay Lab: routes to (evidence: `apps/site/src/app.ts`)
- App Router → Seed Viewer: routes to (evidence: `apps/site/src/app.ts`)
- Blueprint Editing → Floating Windows: creates windows (evidence: `apps/site/src/tools/blueprint-editor/index.ts`)
- Blueprint Editing → Blueprint and Rates: imports and exports (evidence: `apps/site/src/tools/blueprint-editor/index.ts`)
- Blueprint Editing → Canvas Renderer: renders layout
- Blueprint Editing → Rate Overlay: attaches analysis (evidence: `apps/site/src/tools/blueprint-editor/index.ts`)
- Rate Overlay → Blueprint and Rates: loads data (evidence: `apps/site/src/rate-overlay/controller.ts`)
- Rate Overlay → Simulation Factory: builds simulation (evidence: `apps/site/src/rate-overlay/controller.ts`)
- Rate Overlay → Bottleneck Detection: detects issues (evidence: `apps/site/src/rate-overlay/controller.ts`)
- Rate Overlay → Analysis Panels: updates panels (evidence: `apps/site/src/rate-overlay/controller.ts`)
- Analysis Panels → Rate Overlay: reads settings (evidence: `apps/site/src/rate-overlay/panels.ts`)
- Simulation Factory → Belt Simulation: steps simulation
- Simulation Factory → Circuit Simulation: runs circuits
- Blueprint and Rates → Rate Calculation: calculates throughput (evidence: `packages/engine/src/calc/throughput.ts`)
- Canvas Renderer → Draw Collection: collects draw data (evidence: `packages/renderer/src/render.ts`)
- Draw Collection → Draw Commands: emits commands (evidence: `packages/renderer/src/draw/collect.ts`)
- Canvas Renderer → Canvas Painting: paints frame (evidence: `packages/renderer/src/render.ts`)
- Canvas Painting → Draw Commands: consumes commands (evidence: `packages/renderer/src/draw/paint.ts`)
- Canvas Painting → Sprite Atlas: loads sprites (evidence: `packages/renderer/src/draw/paint.ts`)
- Overlay Lab → Rate Overlay: configures overlay (evidence: `apps/site/src/tools/overlay-lab/index.ts`)
- Player → Seed Viewer: enters seed (evidence: `README.md`)
- Seed Viewer → Map Worker: requests generation (evidence: `apps/site/src/tools/seed-viewer/worker.ts`)
- Map Worker → Map Generation: generates map (evidence: `apps/site/src/tools/seed-viewer/worker.ts`)
- Player → Blueprint Editing: imports blueprint (evidence: `README.md`)
- Player → Blueprint Editing: exports blueprint (evidence: `README.md`)
- Player → Canvas Renderer: views game art
- Render Catalog → Canvas Renderer: supplies drawing data
