Skip to the content
2 layers32 × 38.5 mmFirstProject, the printed circuit board in 3D

An ESP32-hosted webserver that controls an array of four LEDs with a browser based terminal interface

Size
32 × 38.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
11
Nets
10
Pads
24
Tracks, vias
28, 0
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
25 Feb 2026
Updated
11 Mar 2026

Overview

FirstProject is an open-source printed circuit board by pierretek, from the pierretek/ESP32-LED-Webserver repository on GitHub. It is a 2-layer board of 32 × 38.5 mm with 11 parts on 10 nets, routed with 28 tracks and 0 vias.

Its parts include 4 resistors, 4 diodes and 1 connector. It belongs with the interfaces and adapters boards of this library.

README

README.md

ESP32 LED Webserver  

An asynchronous webserver hosted on an ESP32 that controls an array of four LEDs using a browser based terminal interface

Details

  • Main program is in src/main.cpp, project libraries are in lib/ and the web interface is in data/.
  • The ESP32 hosts an asynchronous webserver that recieves commands and periodically sends watchdog signals
  • Check out the demo page!

Requirements

Hardware

  • ESP32 WROOM 32
  • Four uniquely colored LEDs
  • Four 220Ω resistors
  • Breadboard and connector wires

Software

  • VS Code with the platformIO extension

How to Use

  1. Build the simple circuit below with the components listed above:

circuit-schematic

  1. Import the project folder in VS Code with platformIO (platformio.ini must be in root)
  2. Navigate to src/main.cpp and fill in your WIFI details (lines 8-13)
  3. From the plugins bar, navigate to PlatformIO > Upload Filesystem Image, and run it to upload the website to the esp32
  4. Connect your ESP32 via USB and upload the project
  5. Open the serial monitor and connect to the IP mentioned using your browser
  6. Send commands via the terminal interface and enjoy!

Possible Commands

text
led red 100ms ⇒ Turns on red LED for 100ms 
led blue 10s blink ⇒ Repeatedly blinks blue LED every 10s
led all 5 ⇒ Turns on all LEDs for 5s 
led all 2 blink ⇒ Repeatedly blinks all LEDs every 2s
led all 1s pattern ⇒ Blinks the LEDs  a staggered offset pattern every 1s

Bonus

Although completely redundant and unnecessary, I also decided to make a simple PCB for fun and to free up my breadboard for other projects. I made the PCB in KiCAD and the project files can be found under PCBFiles/.

PCB Photos

Demo with PCB

https://github.com/user-attachments/assets/332d59a1-b7c1-4675-94df-a39690c8915f


thanks for reading

Parts

11
QtyValueFootprintReferences
4220Resistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P5.08mm_HorizontalR1, R2, R3, R4
2LOGOLOGOG***, G***
1Conn_01x08_SocketConnector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_VerticalJ1
1LED_BLUELED_THT:LED_D5.0mmD2
1LED_GREENLED_THT:LED_D5.0mmD3
1LED_REDLED_THT:LED_D5.0mmD4
1LED_WHITELED_THT:LED_D5.0mmD1

Similar boards

  • 2 layers60 × 30 mmController, the printed circuit board in 3D

    Controller

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    11 parts3kApache-2.0
  • 2 layers103 × 30.5 mmTS Front Endcap, the printed circuit board in 3D

    TS Front Endcap

    EEVengers/ThunderScope

    ThunderScope GitHub Repo

    11 parts1.3kMIT
  • 2 layers26 × 30 mmExpansion Card, the printed circuit board in 3D

    Expansion Card

    FrameworkComputer/ExpansionCards

    Reference designs and documentation to create Expansion Cards for the Framework Laptop

    11 parts1.1kCC-BY-4.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    11 parts1kGPL-3.0
  • 2 layers10 × 20 mm2 connector Sensor Board, the printed circuit board in 3D

    2 connector Sensor Board

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    11 parts915
  • 2 layersFet module, the printed circuit board in 3D

    Fet module

    ByteWelder/Decktility

    A handheld PC

    11 parts855CC-BY-SA-4.0
  • 2 layers47 × 33 mmSevensegment led display module, the printed circuit board in 3D

    Sevensegment led display module

    tardate/LittleArduinoProjects

    a collection of "Little Electronic & Arduino Projects", most involving electronics or an Arduino in one way or another!

    11 parts803MIT
  • 2 layers42.5 × 36.8 mmDevboard, the printed circuit board in 3D

    Devboard

    basilfx/TRADFRI-Hacking

    Hacking IKEA TRÅDFRI products, such as light bulbs, window blinds and other accessories.

    11 parts743CC-BY-4.0

Questions

How big is the FirstProject PCB?

It measures 32 × 38.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the FirstProject use?

11 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the FirstProject KiCad files?

From the pierretek/ESP32-LED-Webserver repository on GitHub, at the commit this page was made from: the board is PCBFIles/firstProject/firstProject.kicad_pcb and its schematic PCBFIles/firstProject/firstProject.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the FirstProject design in my own project?

Its repository states no licence, so its author keeps all rights: ask pierretek before reusing the design.