# iruora/stormix architecture

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

- Interactive diagram: https://gitdiagram.com/iruora/stormix
- Repository: https://github.com/iruora/stormix
- Video tour (about a minute): https://gitdiagram.com/iruora/stormix/video

## Overview

Stormix lets users define or import API flows, run them once or under load, and inspect or export results through a desktop app or CLI. Both front ends use the shared execution engine; collections are converted into flows, and the engine runs their requests and scripts. The README documents history, comparisons, diagnostics, reporting, and AI-related desktop features; some implementation details were not sampled, so those branches are shown without speculative internal links.

Main entry points: [`apps/desktop/src/App.tsx`](https://github.com/iruora/stormix/blob/main/apps/desktop/src/App.tsx) (Desktop workspace), [`crates/cli/src/main.rs`](https://github.com/iruora/stormix/blob/main/crates/cli/src/main.rs) (Stormix CLI), [`crates/engine/src/runner.rs`](https://github.com/iruora/stormix/blob/main/crates/engine/src/runner.rs) (Flow runner), [`apps/desktop/src-tauri/src/commands.rs`](https://github.com/iruora/stormix/blob/main/apps/desktop/src-tauri/src/commands.rs) (Command handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_desktop_app["Desktop workspace<br/>[App.tsx]"]
  node_flow_editor["Flow editor<br/>[StepsEditor.tsx]"]
  node_yaml_editor["YAML editor<br/>[YamlEditor.tsx]"]
  node_desktop_bridge["Desktop commands<br/>[bindings.ts]"]
  node_tauri_commands["Command handlers<br/>[commands.rs]"]
  node_ai_assistance["AI assistance<br/>[lib.rs]"]
end

subgraph group_inputs["Flow and collections"]
  node_flow_model["Flow model<br/>[model.rs]"]
  node_flow_validation["Flow validation<br/>[validate.rs]"]
  node_collection_import["Collection import<br/>[lib.rs]"]
  node_postman_import["Postman importer<br/>[postman.rs]"]
  node_bruno_import["Bruno importer<br/>[bruno.rs]"]
  node_collection_export["Collection export<br/>[export.rs]"]
end

subgraph group_runtime["Execution engine"]
  node_runner["Flow runner<br/>[runner.rs]"]
  node_load_engine["Load engine<br/>[load.rs]"]
  node_script_runtime["Script runtime<br/>[lib.rs]"]
  node_diagnostics["Request diagnosis<br/>[diagnose.rs]"]
end

subgraph group_outputs["Results and history"]
  node_run_history[("Run history<br/>[lib.rs]")]
  node_run_comparison["Run comparison<br/>[diff.rs]"]
  node_metrics["Run metrics<br/>[lib.rs]"]
  node_reports["Report export<br/>[lib.rs]"]
end

subgraph group_interfaces["CLI and integrations"]
  node_cli["Stormix CLI<br/>[main.rs]"]
end

node_user(("User"))

node_user -->|"edits or runs"| node_desktop_app
node_desktop_app -->|"edits steps"| node_flow_editor
node_desktop_app -->|"edits YAML"| node_yaml_editor
node_desktop_app -->|"invokes commands"| node_desktop_bridge
node_desktop_bridge -->|"dispatches to"| node_tauri_commands
node_tauri_commands -.->|"runs flows"| node_runner
node_tauri_commands -.->|"runs load tests"| node_load_engine
node_tauri_commands -.->|"records runs"| node_run_history
node_user -->|"runs commands"| node_cli
node_cli -->|"runs flows"| node_runner
node_cli -->|"runs load tests"| node_load_engine
node_cli -->|"imports collections"| node_collection_import
node_collection_import -->|"dispatches Postman"| node_postman_import
node_collection_import -->|"dispatches Bruno"| node_bruno_import
node_collection_import -->|"produces flows"| node_flow_model
node_cli -->|"exports collections"| node_collection_export
node_flow_validation -->|"validates"| node_flow_model
node_runner -->|"executes flow"| node_flow_model
node_runner -.->|"runs scripts"| node_script_runtime
node_load_engine -.->|"replays flow"| node_runner
node_runner -.->|"produces measurements"| node_metrics
node_cli -->|"exports reports"| node_reports
node_desktop_app -.->|"saves run history"| node_run_history
node_desktop_app -.->|"compares runs"| node_run_comparison
node_desktop_app -.->|"diagnoses failures"| node_diagnostics
node_desktop_app -.->|"offers assistance"| node_ai_assistance

click node_desktop_app "https://github.com/iruora/stormix/blob/main/apps/desktop/src/App.tsx"
click node_flow_editor "https://github.com/iruora/stormix/blob/main/apps/desktop/src/views/StepsEditor.tsx"
click node_yaml_editor "https://github.com/iruora/stormix/blob/main/apps/desktop/src/editor/YamlEditor.tsx"
click node_desktop_bridge "https://github.com/iruora/stormix/blob/main/apps/desktop/src/bindings.ts"
click node_tauri_commands "https://github.com/iruora/stormix/blob/main/apps/desktop/src-tauri/src/commands.rs"
click node_flow_model "https://github.com/iruora/stormix/blob/main/crates/flow/src/model.rs"
click node_flow_validation "https://github.com/iruora/stormix/blob/main/crates/flow/src/validate.rs"
click node_collection_import "https://github.com/iruora/stormix/blob/main/crates/collections/src/lib.rs"
click node_postman_import "https://github.com/iruora/stormix/blob/main/crates/collections/src/postman.rs"
click node_bruno_import "https://github.com/iruora/stormix/blob/main/crates/collections/src/bruno.rs"
click node_collection_export "https://github.com/iruora/stormix/blob/main/crates/collections/src/opencollection/export.rs"
click node_runner "https://github.com/iruora/stormix/blob/main/crates/engine/src/runner.rs"
click node_load_engine "https://github.com/iruora/stormix/blob/main/crates/engine/src/load.rs"
click node_script_runtime "https://github.com/iruora/stormix/blob/main/crates/script/src/lib.rs"
click node_cli "https://github.com/iruora/stormix/blob/main/crates/cli/src/main.rs"
click node_run_history "https://github.com/iruora/stormix/blob/main/crates/store/src/lib.rs"
click node_run_comparison "https://github.com/iruora/stormix/blob/main/crates/store/src/diff.rs"
click node_metrics "https://github.com/iruora/stormix/blob/main/crates/metrics/src/lib.rs"
click node_reports "https://github.com/iruora/stormix/blob/main/crates/report/src/lib.rs"
click node_diagnostics "https://github.com/iruora/stormix/blob/main/crates/engine/src/diagnose.rs"
click node_ai_assistance "https://github.com/iruora/stormix/blob/main/crates/ai/src/lib.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_desktop_app,node_flow_editor,node_yaml_editor,node_desktop_bridge,node_tauri_commands,node_ai_assistance,node_user toneBlue
class node_flow_model,node_flow_validation,node_collection_import,node_postman_import,node_bruno_import,node_collection_export toneAmber
class node_runner,node_load_engine,node_script_runtime,node_diagnostics toneMint
class node_run_history,node_run_comparison,node_metrics,node_reports toneRose
class node_cli toneIndigo
```

## Components

### Desktop app

- [Desktop workspace](https://github.com/iruora/stormix/blob/main/apps/desktop/src/App.tsx): `apps/desktop/src/App.tsx`
- [Flow editor](https://github.com/iruora/stormix/blob/main/apps/desktop/src/views/StepsEditor.tsx): `apps/desktop/src/views/StepsEditor.tsx`
- [YAML editor](https://github.com/iruora/stormix/blob/main/apps/desktop/src/editor/YamlEditor.tsx): `apps/desktop/src/editor/YamlEditor.tsx`
- [Desktop commands](https://github.com/iruora/stormix/blob/main/apps/desktop/src/bindings.ts): `apps/desktop/src/bindings.ts`
- [Command handlers](https://github.com/iruora/stormix/blob/main/apps/desktop/src-tauri/src/commands.rs): `apps/desktop/src-tauri/src/commands.rs`
- [AI assistance](https://github.com/iruora/stormix/blob/main/crates/ai/src/lib.rs): `crates/ai/src/lib.rs`

### Flow and collections

- [Flow model](https://github.com/iruora/stormix/blob/main/crates/flow/src/model.rs): `crates/flow/src/model.rs`
- [Flow validation](https://github.com/iruora/stormix/blob/main/crates/flow/src/validate.rs): `crates/flow/src/validate.rs`
- [Collection import](https://github.com/iruora/stormix/blob/main/crates/collections/src/lib.rs): `crates/collections/src/lib.rs`
- [Postman importer](https://github.com/iruora/stormix/blob/main/crates/collections/src/postman.rs): `crates/collections/src/postman.rs`
- [Bruno importer](https://github.com/iruora/stormix/blob/main/crates/collections/src/bruno.rs): `crates/collections/src/bruno.rs`
- [Collection export](https://github.com/iruora/stormix/blob/main/crates/collections/src/opencollection/export.rs): `crates/collections/src/opencollection/export.rs`

### Execution engine

- [Flow runner](https://github.com/iruora/stormix/blob/main/crates/engine/src/runner.rs): `crates/engine/src/runner.rs`
- [Load engine](https://github.com/iruora/stormix/blob/main/crates/engine/src/load.rs): `crates/engine/src/load.rs`
- [Script runtime](https://github.com/iruora/stormix/blob/main/crates/script/src/lib.rs): `crates/script/src/lib.rs`
- [Request diagnosis](https://github.com/iruora/stormix/blob/main/crates/engine/src/diagnose.rs): `crates/engine/src/diagnose.rs`

### Results and history

- [Run history](https://github.com/iruora/stormix/blob/main/crates/store/src/lib.rs): `crates/store/src/lib.rs`
- [Run comparison](https://github.com/iruora/stormix/blob/main/crates/store/src/diff.rs): `crates/store/src/diff.rs`
- [Run metrics](https://github.com/iruora/stormix/blob/main/crates/metrics/src/lib.rs): `crates/metrics/src/lib.rs`
- [Report export](https://github.com/iruora/stormix/blob/main/crates/report/src/lib.rs): `crates/report/src/lib.rs`

### CLI and integrations

- [Stormix CLI](https://github.com/iruora/stormix/blob/main/crates/cli/src/main.rs): `crates/cli/src/main.rs`

### Other components

- **User**

## Connections

- User → Desktop workspace: edits or runs (evidence: `README.md`)
- Desktop workspace → Flow editor: edits steps (evidence: `apps/desktop/src/App.tsx`)
- Desktop workspace → YAML editor: edits YAML (evidence: `apps/desktop/src/App.tsx`)
- Desktop workspace → Desktop commands: invokes commands (evidence: `apps/desktop/src/bindings.ts`)
- Desktop commands → Command handlers: dispatches to (evidence: `apps/desktop/src/bindings.ts`)
- Command handlers → Flow runner: runs flows
- Command handlers → Load engine: runs load tests
- Command handlers → Run history: records runs
- User → Stormix CLI: runs commands (evidence: `README.md`)
- Stormix CLI → Flow runner: runs flows (evidence: `crates/cli/src/main.rs`)
- Stormix CLI → Load engine: runs load tests (evidence: `crates/cli/src/main.rs`)
- Stormix CLI → Collection import: imports collections (evidence: `README.md`)
- Collection import → Postman importer: dispatches Postman (evidence: `crates/collections/src/lib.rs`)
- Collection import → Bruno importer: dispatches Bruno (evidence: `crates/collections/src/lib.rs`)
- Collection import → Flow model: produces flows (evidence: `README.md`)
- Stormix CLI → Collection export: exports collections (evidence: `crates/cli/src/main.rs`)
- Flow validation → Flow model: validates (evidence: `crates/flow/src/validate.rs`)
- Flow runner → Flow model: executes flow (evidence: `crates/engine/src/runner.rs`)
- Flow runner → Script runtime: runs scripts
- Load engine → Flow runner: replays flow
- Flow runner → Run metrics: produces measurements
- Stormix CLI → Report export: exports reports (evidence: `README.md`)
- Desktop workspace → Run history: saves run history
- Desktop workspace → Run comparison: compares runs
- Desktop workspace → Request diagnosis: diagnoses failures
- Desktop workspace → AI assistance: offers assistance
