Macropad
dialgorithm·macropad·KiCad/macropad.kicad_pcb
About the Macropad PCB
Macropad is an open source ESP32 PCB design by dialgorithm, published on GitHub. It is a 2-layer board measuring 138.5 × 100 mm, with 30 components from 10 distinct parts.
Its main chip is the Val**, from the ESP32 family. Other key parts include the TFT_320x240. By type, the board carries 13 switches, 12 diodes, 2 ICs, 2 capacitors and 1 connector.
It belongs with the iot & wireless and keyboards designs in this gallery.
From the project
xiao esp32s3 based 10 key custom wireless macropad
xiao esp32s3 based 10 key custom wireless macropad with a display to show the current layer and controls.
There are 10 keys, 1 layer switch button, 1 rotary encoder, and a slide switch for turning on and off.
I am using cnc'd acrylic transparent sheets to keep a minimal and clean look.
you can find the detailed bill of materials here

Main components on the Macropad
Macropad bill of materials (BOM)
30 components, 10 distinct parts — part numbers from the project's BOM.
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | Val** | XIAO-ESP32-S3-SMD | U1 |
| 1 | TFT_320x240 | TFT-320x240 | U2 |
| 1 | Conn_01x02 | JST_PH_S2B-PH-K_1x02_P2.00mm_Horizontal | J1 |
| 10 | SW_Push | SW_Cherry_MX_1.00u_PCB | SW1, SW2, SW3, SW5, SW6, SW7, SW8, SW9 +2 |
| 1 | RotaryEncoder_Switch | RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW4 |
| 1 | SW_Push | SW_PUSH_6mm | SW12 |
| 1 | SW_SPST | SW_Slide_SPDT_Straight_CK_OS102011MS2Q | SW13 |
| 12 | D | D_SOD-123 | D1, D2, D3, D4, D5, D6, D7, D8 +4 |
| 1 | 100nF | C_0603_1608Metric | C1 |
| 1 | 10uF | C_0805_2012Metric | C2 |
Macropad design files
The KiCad project lives in the dialgorithm/macropad repository on GitHub; these links point at the commit this page was built from.
- LayoutKiCad/macropad.kicad_pcb
- SchematicKiCad/macropad.kicad_sch
- BOMbom.csv
Macropad: common questions
What microcontroller does the Macropad use?
The Macropad is built around the Val**, from the ESP32 family.
How big is the Macropad PCB?
The Macropad measures 138.5 × 100 mm, has 2 copper layers and is 1.6 mm thick.
How many components are on the Macropad?
30 components, from 10 distinct parts, with part numbers taken from the project's own BOM. The full bill of materials is listed on this page.
Where can I download the Macropad design files?
From the dialgorithm/macropad repository on GitHub, which has the KiCad layout, the schematic and the BOM; the links under Design files point to each one.
Can I use the Macropad design in my own project?
The repository has no license, so all rights stay with dialgorithm. Use it as a reference, and ask the author before reusing the design.
Can I test firmware for the Macropad without the hardware?
Yes. HardLabs builds a simulation of the board from its netlist and BOM, so you can run and debug ESP32 firmware against it before you order a PCB.
Similar boards
ESP32
Open Book Abridged Edition
joeycastillo
85 × 115 mm65 parts2LCC-BY-SA-4.08.1kESP32
Esp32 minimal
atopile
36.2 × 26.8 mm20 parts2LMIT4.0kESP32
Badge
atopile
56.3 × 39 mm239 parts4LMIT4.0kESP32
Controller
StuckAtPrototype
29 × 74 mm58 parts4LApache-2.03.8kESP32
Racer
StuckAtPrototype
36 × 50.2 mm70 parts4LApache-2.03.8kESP32
Bitaxe
skot
56.5 × 99.8 mm86 parts4LCERN-OHL-S-2.01.4k