# yellobyte/esp32-devboards-getting-started architecture

> Architecture diagram of the GitHub repository yellobyte/esp32-devboards-getting-started, 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/yellobyte/esp32-devboards-getting-started
- Repository: https://github.com/yellobyte/esp32-devboards-getting-started

## Overview

This repository is a getting-started guide and example collection for ESP32 development boards, not a single application. The main workflow is to choose a board, find its board-specific example, use an Arduino IDE or VSCode/PlatformIO project, and try a small program on the hardware. It also provides chip reference manuals and board-specific materials, plus debugging and reset/upload resources. The tree shows those latter resources, but no source excerpts were supplied, so their internal relationships are not inferred.

Main entry points: [`boards`](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards) (Board catalog), [`README.md`](https://github.com/yellobyte/esp32-devboards-getting-started/blob/main/README.md) (Getting started), [`boards/ESP32-1.14-Display-DevBoard/examples/ArduinoIDE/Test-ESP32-TTGO_Display`](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/ArduinoIDE/Test-ESP32-TTGO_Display) (Arduino sketches), [`boards/ESP32-1.14-Display-DevBoard/examples/PlatformIO/Test-ESP32-TTGO_Display`](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/PlatformIO/Test-ESP32-TTGO_Display) (PlatformIO project)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Guides and references"]
  node_readme["Getting started<br/>[README.md]"]
  node_chipdocs["ESP32 manuals"]
  node_boarddocs["Board documentation"]
end

subgraph group_boards["Board catalog"]
  node_boardcatalog["Board catalog"]
  node_displayboard["ESP32 display board"]
  node_camboard["ESP32-CAM"]
  node_devkit["ESP32-DevKit-V1"]
  node_s3boards["ESP32-S3 boards"]
end

subgraph group_examples["Board examples"]
  node_examplecollection["Software examples"]
  node_arduinoexample["Arduino sketches"]
  node_pioexample["PlatformIO project"]
end

subgraph group_tools["Development and debugging"]
  node_arduino["Arduino IDE"]
  node_platformio["VSCode / PlatformIO"]
  node_jtagdebug["JTAG debugging"]
  node_nojtag["Non-JTAG debugging"]
  node_upload["Reset and upload"]
end

node_developer(("Developer"))

node_developer -->|"uses guide"| node_readme
node_readme -->|"points to"| node_chipdocs
node_readme -->|"lists examples"| node_examplecollection
node_examplecollection -->|"organizes by board"| node_boardcatalog
node_boardcatalog -->|"includes board"| node_displayboard
node_boardcatalog -->|"includes board"| node_camboard
node_boardcatalog -->|"includes board"| node_devkit
node_boardcatalog -->|"includes boards"| node_s3boards
node_examplecollection -->|"offers sketches"| node_arduinoexample
node_examplecollection -->|"offers projects"| node_pioexample
node_arduinoexample -->|"runs in"| node_arduino
node_pioexample -->|"runs in"| node_platformio
node_readme -.->|"identifies board materials"| node_boarddocs

click node_readme "https://github.com/yellobyte/esp32-devboards-getting-started/blob/main/README.md"
click node_chipdocs "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/ESP32_specs_and_manuals"
click node_boarddocs "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards"
click node_boardcatalog "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards"
click node_displayboard "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard"
click node_camboard "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-CAM"
click node_devkit "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-DevKit-V1"
click node_s3boards "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-S3-0.85-Display-DevBoard"
click node_examplecollection "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards"
click node_arduinoexample "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/ArduinoIDE/Test-ESP32-TTGO_Display"
click node_pioexample "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/PlatformIO/Test-ESP32-TTGO_Display"
click node_jtagdebug "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/debugging"
click node_nojtag "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/debugging_without_JTAG"
click node_upload "https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/reset_and_software_upload"

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_readme,node_chipdocs,node_boarddocs toneBlue
class node_boardcatalog,node_displayboard,node_camboard,node_devkit,node_s3boards toneAmber
class node_examplecollection,node_arduinoexample,node_pioexample toneMint
class node_arduino,node_platformio,node_jtagdebug,node_nojtag,node_upload toneRose
class node_developer toneIndigo
```

## Components

### Guides and references

- [Getting started](https://github.com/yellobyte/esp32-devboards-getting-started/blob/main/README.md): `README.md`
- [ESP32 manuals](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/ESP32_specs_and_manuals): `ESP32_specs_and_manuals`
- [Board documentation](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards): `boards`

### Board catalog

- [Board catalog](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards): `boards`
- [ESP32 display board](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard): `boards/ESP32-1.14-Display-DevBoard`
- [ESP32-CAM](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-CAM): `boards/ESP32-CAM`
- [ESP32-DevKit-V1](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-DevKit-V1): `boards/ESP32-DevKit-V1`
- [ESP32-S3 boards](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-S3-0.85-Display-DevBoard): `boards/ESP32-S3-0.85-Display-DevBoard`

### Board examples

- [Software examples](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards): `boards`
- [Arduino sketches](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/ArduinoIDE/Test-ESP32-TTGO_Display): `boards/ESP32-1.14-Display-DevBoard/examples/ArduinoIDE/Test-ESP32-TTGO_Display`
- [PlatformIO project](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/boards/ESP32-1.14-Display-DevBoard/examples/PlatformIO/Test-ESP32-TTGO_Display): `boards/ESP32-1.14-Display-DevBoard/examples/PlatformIO/Test-ESP32-TTGO_Display`

### Development and debugging

- **Arduino IDE**
- **VSCode / PlatformIO**
- [JTAG debugging](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/debugging): `debugging`
- [Non-JTAG debugging](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/debugging_without_JTAG): `debugging_without_JTAG`
- [Reset and upload](https://github.com/yellobyte/esp32-devboards-getting-started/tree/main/reset_and_software_upload): `reset_and_software_upload`

### Other components

- **Developer**

## Connections

- Developer → Getting started: uses guide (evidence: `README.md`)
- Getting started → ESP32 manuals: points to (evidence: `README.md`)
- Getting started → Software examples: lists examples (evidence: `README.md`)
- Software examples → Board catalog: organizes by board (evidence: `README.md`)
- Board catalog → ESP32 display board: includes board (evidence: `README.md`)
- Board catalog → ESP32-CAM: includes board (evidence: `README.md`)
- Board catalog → ESP32-DevKit-V1: includes board (evidence: `README.md`)
- Board catalog → ESP32-S3 boards: includes boards (evidence: `README.md`)
- Software examples → Arduino sketches: offers sketches (evidence: `README.md`)
- Software examples → PlatformIO project: offers projects (evidence: `README.md`)
- Arduino sketches → Arduino IDE: runs in (evidence: `README.md`)
- PlatformIO project → VSCode / PlatformIO: runs in (evidence: `README.md`)
- Getting started → Board documentation: identifies board materials
