// the find
nkolban/esp32-snippets
Sample ESP32 snippets and code fragments
A collection of ESP32 code snippets and a C++ utility library that the author built while learning the platform, covering BLE, WiFi, HTTP, GPIO, and a handful of peripheral drivers. It was the go-to reference for early ESP32 adopters before the official IDF documentation matured. The README now says plainly that it's abandoned.
The cpp_utils BLE wrapper is genuinely thorough — it covers server, client, scanning, security pairing modes, HID, and Eddystone, which was hard to find in one place when this was written. There are working end-to-end examples for things like BLE notify and passkey auth that you can actually run, not just API stubs. The peripheral coverage (MPU6050, MFRC522, MAX7219, WS2812, OV7670) is broader than most hobbyist repos and saves real wiring-up time. PDF guides for BLE and HTTP server are included and were well-regarded in the community.
Explicitly abandoned — the author says issues won't be fixed, and ESP-IDF has changed enough since this was written that chunks of it simply won't compile against a modern toolchain without patches. The build system is the old component.mk make-based IDF v3 style; CMake support is tacked on partially, so you'll fight the build before you write a single line of your own code. No thread-safety story for the BLE layer — the C++ wrappers call ESP-IDF BLE APIs in ways that can deadlock if you use them from multiple tasks. The cpp_utils directory is a flat pile of 80+ files with no grouping, no versioning, and no clear indication of which pieces depend on which.