# thesinc/badmintonace architecture

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

- Interactive diagram: https://gitdiagram.com/thesinc/badmintonace
- Repository: https://github.com/thesinc/badmintonace

## Overview

BadmintonAce is a Wi-Fi-controlled badminton shuttle launcher for training and STEM education. The documented user workflow is to connect to the launcher, then use a browser-based interactive 3D court to choose and adjust shot placement and patterns. The repository includes the browser assets, ESP32 code, and CAD models. The README describes the launcher’s motors and sensors but does not explain firmware internals or the exact browser-to-firmware protocol, so those implementation links are shown only as unverified.

Main entry points: [`Ace D4/ESP32 Code/ACE.ino`](https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/ACE.ino) (ESP32 firmware), [`Ace D4/ESP32 Code/data/ace.html`](https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/data/ace.html) (3D court controls), [`Ace D4/CAD`](https://github.com/thesinc/badmintonace/tree/main/Ace%20D4/CAD) (Launcher CAD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Training Interface"]
  node_court["3D court controls<br/>[ace.html]"]
end

subgraph group_control["Launcher Control"]
  node_firmware["ESP32 firmware<br/>[ACE.ino]"]
end

subgraph group_hardware["Launcher Hardware"]
  node_cad["Launcher CAD"]
end

node_trainer(("User or trainer"))

node_trainer -->|"sets shots"| node_court
node_trainer -->|"connects by Wi-Fi"| node_firmware
node_court -.->|"sends controls"| node_firmware
node_firmware -.->|"controls launcher"| node_cad

click node_court "https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/data/ace.html"
click node_firmware "https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/ACE.ino"
click node_cad "https://github.com/thesinc/badmintonace/tree/main/Ace%20D4/CAD"

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_court,node_trainer toneBlue
class node_firmware toneAmber
class node_cad toneMint
```

## Components

### Training Interface

- [3D court controls](https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/data/ace.html): `Ace D4/ESP32 Code/data/ace.html`

### Launcher Control

- [ESP32 firmware](https://github.com/thesinc/badmintonace/blob/main/Ace%20D4/ESP32%20Code/ACE.ino): `Ace D4/ESP32 Code/ACE.ino`

### Launcher Hardware

- [Launcher CAD](https://github.com/thesinc/badmintonace/tree/main/Ace%20D4/CAD): `Ace D4/CAD`

### Other components

- **User or trainer**

## Connections

- User or trainer → 3D court controls: sets shots
- User or trainer → ESP32 firmware: connects by Wi-Fi
- 3D court controls → ESP32 firmware: sends controls
- ESP32 firmware → Launcher CAD: controls launcher
