# roadsidebomb/polybar-system architecture

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

- Interactive diagram: https://gitdiagram.com/roadsidebomb/polybar-system
- Repository: https://github.com/roadsidebomb/polybar-system

## Overview

The Polybar System is a modular, 3D-printable guitar controller project for music games. Its repository is a hardware design archive rather than a software runtime: it provides order-ready PCB Gerbers for fret and strum board variants, build guides for PCB and handwired builds, and a STEP-file archive. The principal workflow is to choose board designs, fabricate and assemble a controller using the relevant guide, then use the finished controller with a music game. The tree and README support these capabilities; no source excerpts were provided to establish further implementation details.

Main entry points: [`Polybar System PCB and Source Files/Gerber Files/Fret Boards/MicroChocFret.kicad_pcb.zip`](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroChocFret.kicad_pcb.zip) (Micro Choc Fret), [`Polybar System PCB and Source Files/Gerber Files/Fret Boards/MicroMXFret.kicad_pcb.zip`](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroMXFret.kicad_pcb.zip) (Micro MX Fret), [`Polybar System PCB and Source Files/Gerber Files/Fret Boards/Mini-MaxChocFret.kicad_pcb.zip`](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxChocFret.kicad_pcb.zip) (Mini-Max Choc Fret), [`Polybar System PCB and Source Files/Gerber Files/Fret Boards/Mini-MaxMXFret.kicad_pcb.zip`](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxMXFret.kicad_pcb.zip) (Mini-Max MX Fret)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pcb["PCB designs"]
  node_fret_micro_choc["Micro Choc Fret"]
  node_fret_micro_mx["Micro MX Fret"]
  node_fret_minimax_choc["Mini-Max Choc Fret"]
  node_fret_minimax_mx["Mini-Max MX Fret"]
  node_strum_micro_kb["Micro KB Strum"]
  node_strum_micro_pico["Micro Pico Strum"]
  node_strum_minimax_kb["Mini-Max KB Strum"]
  node_strum_minimax_pico["Mini-Max Pico Strum"]
end

subgraph group_build["Build resources"]
  node_pcb_guide["PCB build guide"]
  node_handwire_guide["Handwire build guide"]
end

subgraph group_mechanical["Mechanical models"]
  node_step_models["STEP files<br/>[STEP Files.zip]"]
end

node_builder(("Controller builder"))
node_fabricator(("PCB fabricator"))
node_controller["Built controller"]
node_music_game(("Music game"))

node_builder -->|"selects design"| node_fret_micro_choc
node_builder -->|"selects design"| node_fret_micro_mx
node_builder -->|"selects design"| node_fret_minimax_choc
node_builder -->|"selects design"| node_fret_minimax_mx
node_builder -->|"selects design"| node_strum_micro_kb
node_builder -->|"selects design"| node_strum_micro_pico
node_builder -->|"selects design"| node_strum_minimax_kb
node_builder -->|"selects design"| node_strum_minimax_pico
node_fret_micro_choc -->|"fabricates PCB"| node_fabricator
node_fret_micro_mx -->|"fabricates PCB"| node_fabricator
node_fret_minimax_choc -->|"fabricates PCB"| node_fabricator
node_fret_minimax_mx -->|"fabricates PCB"| node_fabricator
node_strum_micro_kb -->|"fabricates PCB"| node_fabricator
node_strum_micro_pico -->|"fabricates PCB"| node_fabricator
node_strum_minimax_kb -->|"fabricates PCB"| node_fabricator
node_strum_minimax_pico -->|"fabricates PCB"| node_fabricator
node_builder -->|"follows guide"| node_pcb_guide
node_builder -->|"follows guide"| node_handwire_guide
node_builder -->|"uses models"| node_step_models
node_fabricator -->|"supplies boards"| node_controller
node_builder -->|"assembles"| node_controller
node_controller -->|"controls"| node_music_game

click node_fret_micro_choc "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroChocFret.kicad_pcb.zip"
click node_fret_micro_mx "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroMXFret.kicad_pcb.zip"
click node_fret_minimax_choc "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxChocFret.kicad_pcb.zip"
click node_fret_minimax_mx "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxMXFret.kicad_pcb.zip"
click node_strum_micro_kb "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/MicroKBStrum.kicad_pcb.zip"
click node_strum_micro_pico "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/MicroPicoStrum.kicad_pcb.zip"
click node_strum_minimax_kb "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/Mini-MaxKBStrum.kicad_pcb.zip"
click node_strum_minimax_pico "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/Mini-MaxPicoStrum.kicad_pcb.zip"
click node_pcb_guide "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Polybar%20System%20Build%20Guide.pdf"
click node_handwire_guide "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Polybar%20System%20Handwire%20Build%20Guide.pdf"
click node_step_models "https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/STEP%20Files.zip"

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_fret_micro_choc,node_fret_micro_mx,node_fret_minimax_choc,node_fret_minimax_mx,node_strum_micro_kb,node_strum_micro_pico,node_strum_minimax_kb,node_strum_minimax_pico toneBlue
class node_pcb_guide,node_handwire_guide toneAmber
class node_step_models toneMint
class node_builder,node_fabricator,node_controller,node_music_game toneIndigo
```

## Components

### PCB designs

- [Micro Choc Fret](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroChocFret.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Fret Boards/MicroChocFret.kicad_pcb.zip`
- [Micro MX Fret](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/MicroMXFret.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Fret Boards/MicroMXFret.kicad_pcb.zip`
- [Mini-Max Choc Fret](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxChocFret.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Fret Boards/Mini-MaxChocFret.kicad_pcb.zip`
- [Mini-Max MX Fret](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Fret%20Boards/Mini-MaxMXFret.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Fret Boards/Mini-MaxMXFret.kicad_pcb.zip`
- [Micro KB Strum](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/MicroKBStrum.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Strum Boards/MicroKBStrum.kicad_pcb.zip`
- [Micro Pico Strum](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/MicroPicoStrum.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Strum Boards/MicroPicoStrum.kicad_pcb.zip`
- [Mini-Max KB Strum](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/Mini-MaxKBStrum.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Strum Boards/Mini-MaxKBStrum.kicad_pcb.zip`
- [Mini-Max Pico Strum](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Gerber%20Files/Strum%20Boards/Mini-MaxPicoStrum.kicad_pcb.zip): `Polybar System PCB and Source Files/Gerber Files/Strum Boards/Mini-MaxPicoStrum.kicad_pcb.zip`

### Build resources

- [PCB build guide](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Polybar%20System%20Build%20Guide.pdf): `Polybar System PCB and Source Files/Polybar System Build Guide.pdf`
- [Handwire build guide](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/Polybar%20System%20Handwire%20Build%20Guide.pdf): `Polybar System PCB and Source Files/Polybar System Handwire Build Guide.pdf`

### Mechanical models

- [STEP files](https://github.com/roadsidebomb/polybar-system/blob/main/Polybar%20System%20PCB%20and%20Source%20Files/STEP%20Files.zip): `Polybar System PCB and Source Files/STEP Files.zip`

### Other components

- **Controller builder**
- **PCB fabricator**
- **Built controller**
- **Music game**

## Connections

- Controller builder → Micro Choc Fret: selects design
- Controller builder → Micro MX Fret: selects design
- Controller builder → Mini-Max Choc Fret: selects design
- Controller builder → Mini-Max MX Fret: selects design
- Controller builder → Micro KB Strum: selects design
- Controller builder → Micro Pico Strum: selects design
- Controller builder → Mini-Max KB Strum: selects design
- Controller builder → Mini-Max Pico Strum: selects design
- Micro Choc Fret → PCB fabricator: fabricates PCB
- Micro MX Fret → PCB fabricator: fabricates PCB
- Mini-Max Choc Fret → PCB fabricator: fabricates PCB
- Mini-Max MX Fret → PCB fabricator: fabricates PCB
- Micro KB Strum → PCB fabricator: fabricates PCB
- Micro Pico Strum → PCB fabricator: fabricates PCB
- Mini-Max KB Strum → PCB fabricator: fabricates PCB
- Mini-Max Pico Strum → PCB fabricator: fabricates PCB
- Controller builder → PCB build guide: follows guide
- Controller builder → Handwire build guide: follows guide
- Controller builder → STEP files: uses models
- PCB fabricator → Built controller: supplies boards
- Controller builder → Built controller: assembles
- Built controller → Music game: controls