Your Beginner's Roadmap: The Full ESP32 + PlatformIO Video Series (So Far)

I get some version of this question in my inbox every week: "do I really need to leave the Arduino IDE?" and "which board should I actually start with?" Rather than answer it one message at a time, I put together a short video series that walks through the whole on-ramp — from opening PlatformIO for the first time to blinking your first LED on an ESP32. This post is the map to that series, in the order I'd actually watch it, plus what to build once you're through it.

Why PlatformIO instead of the Arduino IDE, and why the ESP32 as your first board? Because once you're past the very first blink sketch, you want real autocomplete, sane library management, and a build system that tells you what actually went wrong instead of a wall of red text. And the ESP32 gives you WiFi, Bluetooth, and enough pins and processing headroom that you won't outgrow the board in your second project. That combination is the backbone of almost everything I build and teach, wearable or otherwise.

Step 1: Leave the Arduino IDE behind (gently)

Start with Beyond Arduino IDE: Your First Steps with PlatformIO (EP2). I cover why I made the switch years ago and what actually changes for you day to day. If you've only ever used the Arduino IDE, this one sets up the rest of the series so it isn't a confusing jump.

Step 2: Understand your platformio.ini file

This is the file that trips up almost every student I've taught, including past me. Everything You Need to Know About PlatformIO.ini File breaks down what each line does — board definitions, framework, monitor speed, library dependencies — so you're editing it on purpose instead of copy-pasting from a forum thread and hoping.

Step 3: Fix build failures before they happen

Switching to PlatformIO? Do This to Avoid Build Failures! is short, specific, and covers the handful of mistakes that account for most first-time build errors. This is the video that would have saved me a weekend when I was starting out.

Step 4: Blink your first ESP32 LED, properly

Every course starts here for a reason — it's the smallest possible "yes, this actually works" moment. In Making the ESP32 Blink: A Beginner's Guide (Ep 5), I walk through wiring, uploading, and troubleshooting the classic blink sketch using PlatformIO instead of Arduino IDE, so you get the full workflow, not just the code snippet.

Now go build something with it

Once blink is working, the fastest way to actually learn is to attach a screen — it makes debugging visual and it's genuinely satisfying to see your own data show up on something. If you want the exact parts from one of my favorite beginner builds already boxed up, the ESP32 + OLED Video Kit has everything from that tutorial in one order, so you're not hunting down a dozen individual parts across three different sites.

And if you teach this stuff too — a classroom, a workshop, or just a curious kid at your kitchen table — this series doubles nicely as a lesson plan. Feel free to steal the order I've laid it out in here; it's the same progression I use when I'm teaching this in person.

Questions about any step, or stuck somewhere in the series? Leave a comment on the relevant video — I read all of them and I'd rather help you debug there than have you quietly give up.