# qs-1/bredbord architecture

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

- Interactive diagram: https://gitdiagram.com/qs-1/bredbord
- Repository: https://github.com/qs-1/bredbord

## Overview

Bredbord is a browser-based 3D breadboard simulator with circuit editing, live electronics simulation, and community features. The main workflow is user interaction through the workbench UI, editing a saved circuit, synchronizing it with the 3D scene, and running the simulation whose state is reflected in the view. The graph also includes circuit modeling, routing, instruments, and community/account capabilities documented or referenced by the source index. Some subsystem links rely on indexed imports rather than inspected implementation; uncertain links are omitted.

Main entry points: [`src/app/scene-sync.ts`](https://github.com/qs-1/bredbord/blob/main/src/app/scene-sync.ts) (Scene Sync), [`src/engine/sim/simulator.ts`](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/simulator.ts) (Circuit Simulator), [`src/app/simulation.ts`](https://github.com/qs-1/bredbord/blob/main/src/app/simulation.ts) (Simulation Control), [`src/ui/ui.ts`](https://github.com/qs-1/bredbord/blob/main/src/ui/ui.ts) (Workbench UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Workbench"]
  node_ui["Workbench UI<br/>[ui.ts]"]
  node_tools["Editing Tools<br/>[tools.ts]"]
  node_store["Circuit Store<br/>[store.ts]"]
  node_scene_sync["Scene Sync<br/>[scene-sync.ts]"]
end

subgraph group_circuit["Circuit Model"]
  node_document["Circuit Document<br/>[document.ts]"]
  node_circuit_types["Circuit Model<br/>[circuit.ts]"]
  node_board["Board Layout<br/>[breadboard.ts]"]
  node_parts["Parts Catalogue<br/>[parts.ts]"]
  node_netlist["Connectivity<br/>[netlist.ts]"]
  node_autoroute["Wire Autorouting<br/>[autoroute.ts]"]
end

subgraph group_runtime["Simulation Runtime"]
  node_app_sim["Simulation Control<br/>[simulation.ts]"]
  node_simulator["Circuit Simulator<br/>[simulator.ts]"]
  node_electrical["Electrical Network<br/>[electrical.ts]"]
  node_chips["Chip Models<br/>[chips.ts]"]
  node_cpu["6502 CPU<br/>[cpu65.ts]"]
  node_nano["Arduino Nano<br/>[nano.ts]"]
  node_instruments["Meters and Scopes<br/>[meter.ts]"]
end

subgraph group_render["3D View"]
  node_view["3D Workbench<br/>[view.ts]"]
  node_components["Part Models<br/>[components.ts]"]
  node_wires["Wire Rendering<br/>[wires.ts]"]
  node_routing["Wire Geometry<br/>[routing.ts]"]
end

subgraph group_community["Community"]
  node_community_sync["Community Sync<br/>[sync.ts]"]
  node_account["Accounts<br/>[account.ts]"]
  node_supabase["Supabase Client<br/>[supabase.ts]"]
  node_community_pages["Community Pages<br/>[community-page.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_ui
node_ui -->|"wires up"| node_tools
node_ui -->|"uses"| node_store
node_ui -->|"uses"| node_scene_sync
node_store -->|"reads"| node_document
node_store -->|"holds"| node_circuit_types
node_scene_sync -->|"updates"| node_view
node_scene_sync -->|"builds connectivity"| node_netlist
node_scene_sync -->|"reads"| node_circuit_types
node_scene_sync -->|"renders parts"| node_components
node_scene_sync -->|"renders wires"| node_wires
node_circuit_types -->|"uses layout"| node_board
node_circuit_types -->|"describes parts"| node_parts
node_app_sim -->|"runs"| node_simulator
node_app_sim -->|"reads connectivity"| node_scene_sync
node_app_sim -->|"subscribes to"| node_store
node_simulator -->|"uses connectivity"| node_netlist
node_simulator -->|"solves network"| node_electrical
node_simulator -->|"runs models"| node_chips
node_chips -->|"uses"| node_cpu
node_simulator -->|"supports"| node_nano
node_app_sim -->|"samples readings"| node_instruments
node_components -->|"models definitions"| node_parts
node_wires -->|"uses routes"| node_routing
node_routing -->|"uses dimensions"| node_board
node_community_pages -->|"uses"| node_community_sync
node_community_sync -->|"uses identity"| node_account
node_account -->|"loads client"| node_supabase

click node_ui "https://github.com/qs-1/bredbord/blob/main/src/ui/ui.ts"
click node_tools "https://github.com/qs-1/bredbord/blob/main/src/app/tools/tools.ts"
click node_store "https://github.com/qs-1/bredbord/blob/main/src/app/store.ts"
click node_scene_sync "https://github.com/qs-1/bredbord/blob/main/src/app/scene-sync.ts"
click node_document "https://github.com/qs-1/bredbord/blob/main/src/engine/document.ts"
click node_circuit_types "https://github.com/qs-1/bredbord/blob/main/src/engine/circuit.ts"
click node_board "https://github.com/qs-1/bredbord/blob/main/src/engine/breadboard.ts"
click node_parts "https://github.com/qs-1/bredbord/blob/main/src/engine/parts.ts"
click node_netlist "https://github.com/qs-1/bredbord/blob/main/src/engine/netlist.ts"
click node_autoroute "https://github.com/qs-1/bredbord/blob/main/src/engine/autoroute.ts"
click node_app_sim "https://github.com/qs-1/bredbord/blob/main/src/app/simulation.ts"
click node_simulator "https://github.com/qs-1/bredbord/blob/main/src/engine/sim/simulator.ts"
click node_electrical "https://github.com/qs-1/bredbord/blob/main/src/engine/sim/electrical.ts"
click node_chips "https://github.com/qs-1/bredbord/blob/main/src/engine/sim/chips.ts"
click node_cpu "https://github.com/qs-1/bredbord/blob/main/src/engine/sim/cpu65.ts"
click node_nano "https://github.com/qs-1/bredbord/blob/main/src/engine/sim/nano.ts"
click node_instruments "https://github.com/qs-1/bredbord/blob/main/src/engine/meter.ts"
click node_view "https://github.com/qs-1/bredbord/blob/main/src/view/view.ts"
click node_components "https://github.com/qs-1/bredbord/blob/main/src/view/components.ts"
click node_wires "https://github.com/qs-1/bredbord/blob/main/src/view/wires.ts"
click node_routing "https://github.com/qs-1/bredbord/blob/main/src/view/routing.ts"
click node_community_sync "https://github.com/qs-1/bredbord/blob/main/src/community/sync.ts"
click node_account "https://github.com/qs-1/bredbord/blob/main/src/community/account.ts"
click node_supabase "https://github.com/qs-1/bredbord/blob/main/src/community/supabase.ts"
click node_community_pages "https://github.com/qs-1/bredbord/blob/main/src/site/community-page.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_ui,node_tools,node_store,node_scene_sync,node_user toneBlue
class node_document,node_circuit_types,node_board,node_parts,node_netlist,node_autoroute toneAmber
class node_app_sim,node_simulator,node_electrical,node_chips,node_cpu,node_nano,node_instruments toneMint
class node_view,node_components,node_wires,node_routing toneRose
class node_community_sync,node_account,node_supabase,node_community_pages toneIndigo
```

## Components

### Workbench

- [Workbench UI](https://github.com/qs-1/bredbord/blob/main/src/ui/ui.ts): `src/ui/ui.ts`
- [Editing Tools](https://github.com/qs-1/bredbord/blob/main/src/app/tools/tools.ts): `src/app/tools/tools.ts`
- [Circuit Store](https://github.com/qs-1/bredbord/blob/main/src/app/store.ts): `src/app/store.ts`
- [Scene Sync](https://github.com/qs-1/bredbord/blob/main/src/app/scene-sync.ts): `src/app/scene-sync.ts`

### Circuit Model

- [Circuit Document](https://github.com/qs-1/bredbord/blob/main/src/engine/document.ts): `src/engine/document.ts`
- [Circuit Model](https://github.com/qs-1/bredbord/blob/main/src/engine/circuit.ts): `src/engine/circuit.ts`
- [Board Layout](https://github.com/qs-1/bredbord/blob/main/src/engine/breadboard.ts): `src/engine/breadboard.ts`
- [Parts Catalogue](https://github.com/qs-1/bredbord/blob/main/src/engine/parts.ts): `src/engine/parts.ts`
- [Connectivity](https://github.com/qs-1/bredbord/blob/main/src/engine/netlist.ts): `src/engine/netlist.ts`
- [Wire Autorouting](https://github.com/qs-1/bredbord/blob/main/src/engine/autoroute.ts): `src/engine/autoroute.ts`

### Simulation Runtime

- [Simulation Control](https://github.com/qs-1/bredbord/blob/main/src/app/simulation.ts): `src/app/simulation.ts`
- [Circuit Simulator](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/simulator.ts): `src/engine/sim/simulator.ts`
- [Electrical Network](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/electrical.ts): `src/engine/sim/electrical.ts`
- [Chip Models](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/chips.ts): `src/engine/sim/chips.ts`
- [6502 CPU](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/cpu65.ts): `src/engine/sim/cpu65.ts`
- [Arduino Nano](https://github.com/qs-1/bredbord/blob/main/src/engine/sim/nano.ts): `src/engine/sim/nano.ts`
- [Meters and Scopes](https://github.com/qs-1/bredbord/blob/main/src/engine/meter.ts): `src/engine/meter.ts`

### 3D View

- [3D Workbench](https://github.com/qs-1/bredbord/blob/main/src/view/view.ts): `src/view/view.ts`
- [Part Models](https://github.com/qs-1/bredbord/blob/main/src/view/components.ts): `src/view/components.ts`
- [Wire Rendering](https://github.com/qs-1/bredbord/blob/main/src/view/wires.ts): `src/view/wires.ts`
- [Wire Geometry](https://github.com/qs-1/bredbord/blob/main/src/view/routing.ts): `src/view/routing.ts`

### Community

- [Community Sync](https://github.com/qs-1/bredbord/blob/main/src/community/sync.ts): `src/community/sync.ts`
- [Accounts](https://github.com/qs-1/bredbord/blob/main/src/community/account.ts): `src/community/account.ts`
- [Supabase Client](https://github.com/qs-1/bredbord/blob/main/src/community/supabase.ts): `src/community/supabase.ts`
- [Community Pages](https://github.com/qs-1/bredbord/blob/main/src/site/community-page.ts): `src/site/community-page.ts`

### Other components

- **User**

## Connections

- User → Workbench UI: uses (evidence: `README.md`)
- Workbench UI → Editing Tools: wires up (evidence: `src/ui/ui.ts`)
- Workbench UI → Circuit Store: uses (evidence: `src/ui/ui.ts`)
- Workbench UI → Scene Sync: uses (evidence: `src/ui/ui.ts`)
- Circuit Store → Circuit Document: reads (evidence: `src/app/store.ts`)
- Circuit Store → Circuit Model: holds (evidence: `src/app/store.ts`)
- Scene Sync → 3D Workbench: updates (evidence: `src/app/scene-sync.ts`)
- Scene Sync → Connectivity: builds connectivity (evidence: `src/app/scene-sync.ts`)
- Scene Sync → Circuit Model: reads (evidence: `src/app/scene-sync.ts`)
- Scene Sync → Part Models: renders parts (evidence: `src/app/scene-sync.ts`)
- Scene Sync → Wire Rendering: renders wires (evidence: `src/app/scene-sync.ts`)
- Circuit Model → Board Layout: uses layout (evidence: `src/engine/circuit.ts`)
- Circuit Model → Parts Catalogue: describes parts (evidence: `src/engine/circuit.ts`)
- Simulation Control → Circuit Simulator: runs (evidence: `src/app/simulation.ts`)
- Simulation Control → Scene Sync: reads connectivity (evidence: `src/app/simulation.ts`)
- Simulation Control → Circuit Store: subscribes to (evidence: `src/app/simulation.ts`)
- Circuit Simulator → Connectivity: uses connectivity (evidence: `src/engine/sim/simulator.ts`)
- Circuit Simulator → Electrical Network: solves network (evidence: `src/engine/sim/simulator.ts`)
- Circuit Simulator → Chip Models: runs models (evidence: `src/engine/sim/simulator.ts`)
- Chip Models → 6502 CPU: uses (evidence: `src/engine/sim/chips.ts`)
- Circuit Simulator → Arduino Nano: supports (evidence: `src/engine/sim/simulator.ts`)
- Simulation Control → Meters and Scopes: samples readings (evidence: `src/app/simulation.ts`)
- Part Models → Parts Catalogue: models definitions (evidence: `src/view/components.ts`)
- Wire Rendering → Wire Geometry: uses routes (evidence: `src/view/wires.ts`)
- Wire Geometry → Board Layout: uses dimensions (evidence: `src/view/routing.ts`)
- Community Pages → Community Sync: uses (evidence: `src/site/community-page.ts`)
- Community Sync → Accounts: uses identity (evidence: `src/community/sync.ts`)
- Accounts → Supabase Client: loads client (evidence: `src/community/account.ts`)
