feat: add ESP32 CI build validation across all PlatformIO examples

Author: CameronBrooks11

.github/workflows/ci.yml

@@ -169,3 +169,28 @@ jobs:
 
       - name: Build display peripheral (families_usage)
         run: pio run -d examples/families_usage/lhwit_family/display -e nanoatmega328new
+
+      # ESP32 build validation
+      - name: Build simple_controller (core_usage, ESP32)
+        run: pio run -d examples/core_usage/platformio/simple_controller -e esp32dev
+
+      - name: Build simple_peripheral (core_usage, ESP32)
+        run: pio run -d examples/core_usage/platformio/simple_peripheral -e esp32dev
+
+      - name: Build mock_controller (handlers_usage, ESP32)
+        run: pio run -d examples/handlers_usage/platformio/mock_controller -e esp32dev
+
+      - name: Build mock_peripheral (handlers_usage, ESP32)
+        run: pio run -d examples/handlers_usage/platformio/mock_peripheral -e esp32dev
+
+      - name: Build calculator peripheral (families_usage, ESP32)
+        run: pio run -d examples/families_usage/lhwit_family/calculator -e esp32dev
+
+      - name: Build LED peripheral (families_usage, ESP32)
+        run: pio run -d examples/families_usage/lhwit_family/led -e esp32dev
+
+      - name: Build servo peripheral (families_usage, ESP32)
+        run: pio run -d examples/families_usage/lhwit_family/servo -e esp32dev
+
+      - name: Build display peripheral (families_usage, ESP32)
+        run: pio run -d examples/families_usage/lhwit_family/display -e esp32dev

CHANGELOG.md

@@ -6,6 +6,13 @@ All notable changes to CRUMBS are documented in this file.
 
 ## [Unreleased]
 
+### Added
+
+- **ESP32 CI build validation** — `[env:esp32dev]` added to all eight example `platformio.ini`
+  files; eight matching `esp32dev` build steps added to the `platformio` CI job. Validates that
+  all examples compile cleanly for ESP32 (espressif32 platform, Arduino framework).
+- `docs/platform-setup.md` — added ESP32 `platformio.ini` snippet with I²C pin note.
+
 ### Fixed
 
 - **`examples/handlers_usage/linux/mock_controller/mock_controller.c`** — updated all

docs/platform-setup.md

@@ -151,21 +151,38 @@ void loop() {
 
 PlatformIO can automatically fetch CRUMBS as a library dependency.
 
-**Example platformio.ini:**
+**Example platformio.ini (Arduino Nano):**
 
 ```ini
-[env:uno]
+[env:nanoatmega328new]
 platform = atmelavr
-board = uno
+board = nanoatmega328new
 framework = arduino
 
 lib_deps =
-    CRUMBS
+    cameronbrooks11/CRUMBS@^0.11.0
 
 build_flags =
-    -DCRUMBS_MAX_HANDLERS=8  # Optional: reduce handler table size
+    -DCRUMBS_MAX_HANDLERS=8  ; optional: reduce handler table size
 ```
 
+**Example platformio.ini (ESP32):**
+
+```ini
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+
+lib_deps =
+    cameronbrooks11/CRUMBS@^0.11.0
+
+build_flags =
+    -DCRUMBS_MAX_HANDLERS=8  ; optional
+```
+
+> **ESP32 I²C pins:** GPIO 21 (SDA), GPIO 22 (SCL) by default. Use `Wire.begin(sda, scl)` to override.
+
 **To install and build:**
 
 ```bash

examples/core_usage/platformio/simple_controller/platformio.ini

@@ -26,5 +26,13 @@ monitor_speed = 115200
 lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+
 [platformio]
 default_envs = nanoatmega328new

examples/core_usage/platformio/simple_peripheral/platformio.ini

@@ -26,5 +26,13 @@ monitor_speed = 115200
 lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+
 [platformio]
 default_envs = nanoatmega328new

examples/families_usage/lhwit_family/calculator/platformio.ini

@@ -22,5 +22,16 @@ build_flags =
 lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+build_flags =
+	-DCRUMBS_MAX_HANDLERS=8
+	-I ..
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+
 [platformio]
 default_envs = nanoatmega328new

examples/families_usage/lhwit_family/display/platformio.ini

@@ -24,5 +24,17 @@ lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
     adrian200223/Simple5641AS@^1.0.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+build_flags =
+	-DCRUMBS_MAX_HANDLERS=6
+	-I ..
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+	adrian200223/Simple5641AS@^1.0.0
+
 [platformio]
 default_envs = nanoatmega328new

examples/families_usage/lhwit_family/led/platformio.ini

@@ -22,5 +22,16 @@ build_flags =
 lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+build_flags =
+	-DCRUMBS_MAX_HANDLERS=8
+	-I ..
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+
 [platformio]
 default_envs = nanoatmega328new

examples/families_usage/lhwit_family/servo/platformio.ini

@@ -24,5 +24,17 @@ lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
     Servo
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+build_flags =
+	-DCRUMBS_MAX_HANDLERS=8
+	-I ..
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+	Servo
+
 [platformio]
 default_envs = nanoatmega328new

examples/handlers_usage/platformio/mock_controller/platformio.ini

@@ -20,5 +20,15 @@ build_flags =
 lib_deps =
     cameronbrooks11/CRUMBS@^0.11.0
 
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+build_flags =
+	-I ../..
+lib_deps =
+	cameronbrooks11/CRUMBS@^0.11.0
+
 [platformio]
 default_envs = nanoatmega328new