# sekigon-gonnoc/torabo-tsuki-lp architecture

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

- Interactive diagram: https://gitdiagram.com/sekigon-gonnoc/torabo-tsuki-lp
- Repository: https://github.com/sekigon-gonnoc/torabo-tsuki-lp

## Overview

torabo-tsuki LP is a wireless split keyboard kit with an integrated trackball. The principal workflow is for a builder to choose a keyboard size and trackball configuration, use the published PCB and enclosure designs, assemble the kit, then customize its ZMK keymap. The repository contains design files rather than firmware source; the README documents assembly guidance and external keymap tools, but those relationships are shown only at that documented level.

Main entry points: [`README.md`](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/README.md) (Wireless split keyboard), [`pcb`](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/pcb) (Size-specific PCBs), [`3d-models/FreeCAD`](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/FreeCAD) (Trackball cases), [`build-guide.md`](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/build-guide.md) (Assembly guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Hardware designs"]
  node_pcb["Size-specific PCBs"]
  node_cases["Trackball cases"]
  node_covers["Battery covers"]
  node_stl["Printable models"]
end

subgraph group_customization["Firmware customization"]
  node_zmk["ZMK keymap<br/>[README.md]"]
  node_keymaptools["Keymap Editor / ZMK Studio"]
end

subgraph group_product["Finished kit"]
  node_buildguide["Assembly guidance<br/>[build-guide.md]"]
  node_kit["Wireless split keyboard<br/>[README.md]"]
end

node_builder(("Keyboard builder"))

node_builder -->|"chooses size"| node_pcb
node_builder -->|"chooses ball size"| node_cases
node_builder -->|"follows guidance"| node_buildguide
node_builder -->|"customizes keys"| node_keymaptools
node_keymaptools -->|"edits keymap"| node_zmk
node_buildguide -->|"assembles"| node_kit
node_pcb -->|"forms electronics"| node_kit
node_cases -->|"houses trackball"| node_kit
node_covers -->|"covers battery"| node_kit

click node_pcb "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/pcb"
click node_cases "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/FreeCAD"
click node_covers "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/FreeCAD"
click node_stl "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/STL"
click node_buildguide "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/build-guide.md"
click node_kit "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/README.md"
click node_zmk "https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/README.md"

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_pcb,node_cases,node_covers,node_stl toneBlue
class node_zmk,node_keymaptools toneAmber
class node_buildguide,node_kit toneMint
class node_builder toneIndigo
```

## Components

### Hardware designs

- [Size-specific PCBs](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/pcb): `pcb`
- [Trackball cases](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/FreeCAD): `3d-models/FreeCAD`
- [Battery covers](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/FreeCAD): `3d-models/FreeCAD`
- [Printable models](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/tree/master/3d-models/STL): `3d-models/STL`

### Firmware customization

- [ZMK keymap](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/README.md): `README.md`
- **Keymap Editor / ZMK Studio**

### Finished kit

- [Assembly guidance](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/build-guide.md): `build-guide.md`
- [Wireless split keyboard](https://github.com/sekigon-gonnoc/torabo-tsuki-lp/blob/master/README.md): `README.md`

### Other components

- **Keyboard builder**

## Connections

- Keyboard builder → Size-specific PCBs: chooses size (evidence: `README.md`)
- Keyboard builder → Trackball cases: chooses ball size (evidence: `README.md`)
- Keyboard builder → Assembly guidance: follows guidance (evidence: `README.md`)
- Keyboard builder → Keymap Editor / ZMK Studio: customizes keys (evidence: `README.md`)
- Keymap Editor / ZMK Studio → ZMK keymap: edits keymap (evidence: `README.md`)
- Assembly guidance → Wireless split keyboard: assembles (evidence: `README.md`)
- Size-specific PCBs → Wireless split keyboard: forms electronics (evidence: `README.md`)
- Trackball cases → Wireless split keyboard: houses trackball (evidence: `README.md`)
- Battery covers → Wireless split keyboard: covers battery (evidence: `README.md`)