# codeand-copper/boardlens architecture

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

- Interactive diagram: https://gitdiagram.com/codeand-copper/boardlens
- Repository: https://github.com/codeand-copper/boardlens

## Overview

BoardLens is a cross-platform desktop hardware-information viewer. The user runs the app, starts a scan, and sees detected system and hardware details in its GUI. The sampled source shows a scan worker calling a universal detector, which dispatches by operating system. The README documents motherboard, BIOS, OS, and hardware reporting across Windows, macOS, and Linux. Because the single source file is only partially excerpted, several documented reporting stages are shown without inferred call links.

Main entry points: [`main.py`](https://github.com/codeand-copper/boardlens/blob/main/main.py) (Platform dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_gui["Results interface<br/>[main.py]"]
  node_scan["Scan worker<br/>[main.py]"]
end

subgraph group_detect["Hardware detection"]
  node_dispatch["Platform dispatch<br/>[main.py]"]
  node_windows["Windows detector<br/>[main.py]"]
  node_macos["macOS detector<br/>[main.py]"]
  node_linux["Linux detector<br/>[main.py]"]
  node_board["Motherboard details<br/>[main.py]"]
  node_bios["BIOS details<br/>[main.py]"]
  node_osinfo["OS details<br/>[main.py]"]
  node_hardware["Hardware details<br/>[main.py]"]
end

node_user(("User"))

node_user -->|"runs app"| node_gui
node_scan -->|"calls detector"| node_dispatch
node_dispatch -->|"dispatches"| node_windows
node_dispatch -->|"dispatches"| node_macos
node_dispatch -->|"dispatches"| node_linux

click node_gui "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_scan "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_dispatch "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_windows "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_macos "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_linux "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_board "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_bios "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_osinfo "https://github.com/codeand-copper/boardlens/blob/main/main.py"
click node_hardware "https://github.com/codeand-copper/boardlens/blob/main/main.py"

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_gui,node_scan,node_user toneBlue
class node_dispatch,node_windows,node_macos,node_linux,node_board,node_bios,node_osinfo,node_hardware toneAmber
```

## Components

### Desktop app

- [Results interface](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [Scan worker](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`

### Hardware detection

- [Platform dispatch](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [Windows detector](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [macOS detector](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [Linux detector](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [Motherboard details](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [BIOS details](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [OS details](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`
- [Hardware details](https://github.com/codeand-copper/boardlens/blob/main/main.py): `main.py`

### Other components

- **User**

## Connections

- User → Results interface: runs app (evidence: `README.md`)
- Scan worker → Platform dispatch: calls detector (evidence: `main.py`)
- Platform dispatch → Windows detector: dispatches (evidence: `main.py`)
- Platform dispatch → macOS detector: dispatches (evidence: `main.py`)
- Platform dispatch → Linux detector: dispatches (evidence: `main.py`)
