# j-w9/arduconfigurator architecture

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

- Interactive diagram: https://gitdiagram.com/j-w9/arduconfigurator
- Repository: https://github.com/j-w9/arduconfigurator

## Overview

ArduConfigurator is a browser-first ArduPilot setup and configuration application, with an Electron shell for native connectivity. The principal workflow is: an operator connects to a flight controller, the runtime synchronizes configuration and status, and guided setup/configuration features help the operator review or change settings. The README documents additional firmware flashing, log analysis/upload, and AI-assistant capabilities. Source excerpts show the MAVLink session using transports and the setup-progress persistence model; other subsystem links below rely on the README’s workspace descriptions, so unsampled implementation details are not inferred.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/App.tsx) (Web application), [`packages/transport/src/types.ts`](https://github.com/j-w9/arduconfigurator/blob/main/packages/transport/src/types.ts) (Transport adapters), [`apps/desktop/src/electron-main.ts`](https://github.com/j-w9/arduconfigurator/blob/main/apps/desktop/src/electron-main.ts) (Desktop shell), [`packages/ardupilot-core/src/runtime.ts`](https://github.com/j-w9/arduconfigurator/blob/main/packages/ardupilot-core/src/runtime.ts) (ArduPilot runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surface["Operator surfaces"]
  node_web["Web application<br/>[App.tsx]"]
  node_desktop["Desktop shell<br/>[electron-main.ts]"]
end

subgraph group_connection["Connectivity and protocol"]
  node_transport["Transport adapters<br/>[types.ts]"]
  node_mavlink["MAVLink session<br/>[mavlink-session.ts]"]
  node_msp["MSP session<br/>[msp-session.ts]"]
end

subgraph group_configuration["Configuration runtime"]
  node_core["ArduPilot runtime<br/>[runtime.ts]"]
  node_metadata[("Parameter metadata<br/>[arducopter.ts]")]
  node_setup["Guided setup"]
  node_progress[("Setup progress")]
end

subgraph group_capabilities["Product capabilities"]
  node_firmware["Firmware flashing<br/>[bootloader.ts]"]
  node_analysis["Log analysis"]
  node_logupload["Log upload<br/>[client.ts]"]
  node_assistant["AI assistant<br/>[provider.ts]"]
end

subgraph group_services["External services"]
  node_aiproviders["AI providers<br/>[create-provider.ts]"]
  node_logserver["Log server"]
  node_flightcontroller["Flight controller"]
end

node_operator(("Operator"))

node_operator -->|"configures through"| node_web
node_operator -->|"connects through"| node_desktop
node_web -->|"uses adapters"| node_transport
node_desktop -->|"uses adapters"| node_transport
node_mavlink -->|"sends and receives"| node_transport
node_msp -->|"uses transport"| node_transport
node_web -->|"runs configuration"| node_core
node_core -->|"uses definitions"| node_metadata
node_web -->|"guides setup"| node_setup
node_setup -->|"persists progress"| node_progress
node_desktop -->|"connects to"| node_flightcontroller
node_transport -->|"communicates with"| node_flightcontroller
node_web -->|"offers flashing"| node_firmware
node_web -->|"offers log analysis"| node_analysis
node_web -->|"uploads logs"| node_logupload
node_logupload -.->|"sends logs"| node_logserver
node_web -->|"offers assistance"| node_assistant
node_assistant -.->|"selects provider"| node_aiproviders

click node_web "https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/App.tsx"
click node_desktop "https://github.com/j-w9/arduconfigurator/blob/main/apps/desktop/src/electron-main.ts"
click node_transport "https://github.com/j-w9/arduconfigurator/blob/main/packages/transport/src/types.ts"
click node_mavlink "https://github.com/j-w9/arduconfigurator/blob/main/packages/protocol-mavlink/src/mavlink-session.ts"
click node_msp "https://github.com/j-w9/arduconfigurator/blob/main/packages/protocol-msp/src/msp-session.ts"
click node_core "https://github.com/j-w9/arduconfigurator/blob/main/packages/ardupilot-core/src/runtime.ts"
click node_metadata "https://github.com/j-w9/arduconfigurator/blob/main/packages/param-metadata/src/arducopter.ts"
click node_setup "https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/setup-exercise-helpers.ts"
click node_progress "https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/setup-progress-storage.ts"
click node_firmware "https://github.com/j-w9/arduconfigurator/blob/main/packages/firmware-flash/src/bootloader.ts"
click node_analysis "https://github.com/j-w9/arduconfigurator/blob/main/packages/log-analysis/src/dataflash-parser.ts"
click node_logupload "https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/log-upload/client.ts"
click node_assistant "https://github.com/j-w9/arduconfigurator/blob/main/packages/ai-assistant/src/provider.ts"
click node_aiproviders "https://github.com/j-w9/arduconfigurator/blob/main/packages/ai-assistant/src/create-provider.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_web,node_desktop toneBlue
class node_transport,node_mavlink,node_msp toneAmber
class node_core,node_metadata,node_setup,node_progress toneMint
class node_firmware,node_analysis,node_logupload,node_assistant toneRose
class node_aiproviders,node_logserver,node_flightcontroller,node_operator toneIndigo
```

## Components

### Operator surfaces

- [Web application](https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Desktop shell](https://github.com/j-w9/arduconfigurator/blob/main/apps/desktop/src/electron-main.ts): `apps/desktop/src/electron-main.ts`

### Connectivity and protocol

- [Transport adapters](https://github.com/j-w9/arduconfigurator/blob/main/packages/transport/src/types.ts): `packages/transport/src/types.ts`
- [MAVLink session](https://github.com/j-w9/arduconfigurator/blob/main/packages/protocol-mavlink/src/mavlink-session.ts): `packages/protocol-mavlink/src/mavlink-session.ts`
- [MSP session](https://github.com/j-w9/arduconfigurator/blob/main/packages/protocol-msp/src/msp-session.ts): `packages/protocol-msp/src/msp-session.ts`

### Configuration runtime

- [ArduPilot runtime](https://github.com/j-w9/arduconfigurator/blob/main/packages/ardupilot-core/src/runtime.ts): `packages/ardupilot-core/src/runtime.ts`
- [Parameter metadata](https://github.com/j-w9/arduconfigurator/blob/main/packages/param-metadata/src/arducopter.ts): `packages/param-metadata/src/arducopter.ts`
- [Guided setup](https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/setup-exercise-helpers.ts): `apps/web/src/setup-exercise-helpers.ts`
- [Setup progress](https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/setup-progress-storage.ts): `apps/web/src/setup-progress-storage.ts`

### Product capabilities

- [Firmware flashing](https://github.com/j-w9/arduconfigurator/blob/main/packages/firmware-flash/src/bootloader.ts): `packages/firmware-flash/src/bootloader.ts`
- [Log analysis](https://github.com/j-w9/arduconfigurator/blob/main/packages/log-analysis/src/dataflash-parser.ts): `packages/log-analysis/src/dataflash-parser.ts`
- [Log upload](https://github.com/j-w9/arduconfigurator/blob/main/apps/web/src/log-upload/client.ts): `apps/web/src/log-upload/client.ts`
- [AI assistant](https://github.com/j-w9/arduconfigurator/blob/main/packages/ai-assistant/src/provider.ts): `packages/ai-assistant/src/provider.ts`

### External services

- [AI providers](https://github.com/j-w9/arduconfigurator/blob/main/packages/ai-assistant/src/create-provider.ts): `packages/ai-assistant/src/create-provider.ts`
- **Log server**
- **Flight controller**

### Other components

- **Operator**

## Connections

- Operator → Web application: configures through (evidence: `README.md`)
- Operator → Desktop shell: connects through (evidence: `README.md`)
- Web application → Transport adapters: uses adapters (evidence: `README.md`)
- Desktop shell → Transport adapters: uses adapters (evidence: `README.md`)
- MAVLink session → Transport adapters: sends and receives (evidence: `packages/protocol-mavlink/src/mavlink-session.ts`)
- MSP session → Transport adapters: uses transport (evidence: `packages/protocol-msp/src/msp-session.ts`)
- Web application → ArduPilot runtime: runs configuration (evidence: `README.md`)
- ArduPilot runtime → Parameter metadata: uses definitions (evidence: `README.md`)
- Web application → Guided setup: guides setup (evidence: `README.md`)
- Guided setup → Setup progress: persists progress (evidence: `apps/web/src/setup-progress-storage.ts`)
- Desktop shell → Flight controller: connects to (evidence: `README.md`)
- Transport adapters → Flight controller: communicates with (evidence: `README.md`)
- Web application → Firmware flashing: offers flashing (evidence: `README.md`)
- Web application → Log analysis: offers log analysis (evidence: `README.md`)
- Web application → Log upload: uploads logs (evidence: `README.md`)
- Log upload → Log server: sends logs
- Web application → AI assistant: offers assistance (evidence: `README.md`)
- AI assistant → AI providers: selects provider
