Repolode
agharsallah

agharsallah/esp-labs-web

An interactive browser guide to the ESP32-S3 with 32 labs, live simulators, a pinout, a firmware code reader and a datasheet section.

Stars
677
Forks
99
Open issues
1
Last commit
5 days ago

What is it?

ESP32 Labs is a React web app that teaches the ESP32-S3 microcontroller through hands-on labs. Each lesson is a single page with its goal, the pins it uses on a live pinout, wiring steps, the flash command, a checklist and a simulator. The simulated serial monitor responds to typed commands the way the real firmware does, so learners can try things before touching hardware.

A code reader shows the firmware each lab flashes, taken from the companion esp-labs repository at build time. It offers guided tours with guess-first questions, a step-by-step story mode that follows execution from setup(), and tap-to-explain on any line. A Datasheet section summarises the chip's pins, peripherals, memory and power modes, with citations to Espressif's reference where that text is available locally.

The guide is available in eight languages, including Arabic with right-to-left layout, and works on phones. Progress is stored in the browser without an account.

Key features

  • 0132 hands-on labs covering Wi-Fi, Bluetooth LE, RFID/NFC, sound and display
  • 02Simulated serial monitor that responds to typed commands
  • 03Live ESP32-S3 pinout and a 3D DevKitC-1 board view
  • 04Code reader with guided tours and line-by-line explanations of the firmware
  • 05Datasheet section with pin, peripheral and memory reference pages
  • 06Eight interface languages, including right-to-left Arabic

Use cases

  • Learning ESP32-S3 development before buying or wiring a board
  • Following a structured course of embedded labs at your own pace
  • Studying how a real ESP32 firmware program runs from setup() onward
  • Looking up ESP32-S3 pin functions and peripheral details while building a project

Quick start

  1. 1

    Clone the esp-labs firmware repo

    git clone https://github.com/agharsallah/esp-labs.git
  2. 2

    Clone the esp-labs-web repo

    git clone https://github.com/agharsallah/esp-labs-web.git
  3. 3

    Enter the project folder and install dependencies

    cd esp-labs-web && pnpm install
  4. 4

    Start the dev server at localhost:5180

    pnpm dev

Things to know

  • No license is specified, so reuse rights are unclear.
  • The code reader needs a sibling esp-labs checkout; without it only that feature is empty.
  • Espressif's reference text is not bundled and must be obtained separately for the full reader.

In collections

Topics

FAQ

What is esp-labs-web?
An interactive browser guide to the ESP32-S3 with 32 labs, live simulators, a pinout, a firmware code reader and a datasheet section. ESP32 Labs is a React web app that teaches the ESP32-S3 microcontroller through hands-on labs. Each lesson is a single page with its goal, the pins it uses on a live pinout, wiring steps, the flash command, a checklist and a simulator. The simulated serial monitor responds to typed commands the way the real firmware does, so learners can try things before touching hardware.
Is esp-labs-web free to use? What license does it have?
esp-labs-web has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is esp-labs-web still maintained?
Actively maintained. The last commit to esp-labs-web was on Nov 2, 2026.
What can I use esp-labs-web for?
Learning ESP32-S3 development before buying or wiring a board Following a structured course of embedded labs at your own pace Studying how a real ESP32 firmware program runs from setup() onward Looking up ESP32-S3 pin functions and peripheral details while building a project
How do I install esp-labs-web?
Clone the esp-labs firmware repo: git clone https://github.com/agharsallah/esp-labs.git Clone the esp-labs-web repo: git clone https://github.com/agharsallah/esp-labs-web.git Enter the project folder and install dependencies: cd esp-labs-web && pnpm install Start the dev server at localhost:5180: pnpm dev
Where can I get esp-labs-web?
The source code and installation instructions are on GitHub: https://github.com/agharsallah/esp-labs-web

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects