Pick your board, plug it in over USB, hit install. The browser does the rest - no Arduino, no PlatformIO, no toolchain.
Before you start
Three things that cover 90% of failed flash attempts.
Desktop Chrome or Edge. Web Serial doesn't run on Firefox, Safari, or mobile.
A real data USB cable. Power-only cables are silent killers. The port just won't show up.
Nothing else on the serial port. Close Arduino IDE, PlatformIO Monitor, screen, picocom, etc.
Flash your board
The full image is written - bootloader, partitions, and app. Existing settings on the device are erased on a fresh install.
…
community
chip
ESP32
display
…
touch
…
printers
…
board id
esp32s3
firmware
…
A dialog will ask which serial port to use. Pick the one that appears when you plug the board in.
After flashing
Get the device on your WiFi. Two ways - the first one happens right in this tab.
recommended
Configure WiFi in this tab
~3 min window
When the flash completes, the install dialog opens a
Configure WiFi step. Pick your home network from the
list, type the password, and hit Connect. Credentials
go to the device over USB using
Improv Serial.
No phone, no captive portal, no app switching.
Wait for "Installation complete", then keep the dialog open.
Pick your WiFi network and enter the password.
Follow the link to the device's config page and finish setup.
or after timeout
fallback
Join the device's hotspot from any device
If the Configure WiFi step times out or you dismiss the dialog,
the board falls back to hotspot mode and prints these credentials on
its screen. Connect to it from a phone or laptop and finish setup in
a browser.
Enter your home WiFi and printer details, then save.
Either way, the device reboots, joins your WiFi, and starts monitoring the printer.
View serial logs
Capture a crash, a stack trace, or WiFi/TLS errors for a bug report.
Plug the board in over USB, click Connect, and pick the same serial port you'd use for flashing. Baud rate is 115200 to match the firmware.
Only one program can hold the serial port at a time - close PlatformIO Monitor or Arduino IDE first, and don't click Install during a monitor session.
Need more detail in the log? Open your device's config page in a browser, go to Diagnostics, and turn on Enable verbose serial logging. That streams MQTT and printer events over USB. Disable it again when you're done - it impacts performance.