

Macroboard
- Size
- 102.9 × 45.7 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 20
- Nets
- 24
- Pads
- 133
- Tracks, vias
- 101, 3
- Pours
- 90
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 13 Jul 2026
- Updated
- 6 Oct 2026
Overview
Macroboard is an open-source printed circuit board by jjwuuu, from the jjwuuu/macropad repository on GitHub. It is a 2-layer board of 102.9 × 45.7 mm with 20 parts on 24 nets, routed with 101 tracks and 3 vias.
Its parts include 7 diodes, 1 IC, 1 connector and 1 switch. It belongs with the RP2040 boards of this library.
README
README.mdBill of Materials
Required
- 1x Seeed Studio XIAO RP2040
- 6x MX hotswap sockets
- 7x 1N4148 small signal diodes
- 1x EC11 rotary encoder with push button
- 4x M3x12 screws (support M3x8 - M3x14)
Assembly Instructions
- 3D print the top case, bottom case, and knob. For the best results, print the top case and bottom case with 100% infill.
- Solder the hotswap sockets and diodes, taking note of the polarity.
- Solder the microcontroller, using pin headers to align the pads but not soldering the pin headers.
- Solder the rotary encoder on the opposite side of the board as the rest of the components.
- Press and hold the BOOT button on the microcontroller. Then, while still holding the button, plug in the microcontroller to a computer. The microcontroller should appear as a virtual USB storage device.
- Upload the .uf2 firmware file to the microcontroller. The virtual USB storage device should disconnect once flashed.
- Unplug and replug the USB cable.
- Test that the keys work by inserting switches into the hotswap sockets and depressing them. The keys should type the numbers 1-6 by default.
- Test that the rotary encoder works by rotating it and pressing it. The encoder should control volume when rotated and type the number 7 when pressed.
- Unplug the USB cable.
- Insert the completed PCB into the bottom case, slotting in the USB conector first.
- Place the top case on top of the bottom case.
- Secure the bottom case to the top case with the M3x12 screws or the printable pegs/rivets.
- Insert the switches into the top case. The switches should securely slot into the hotswap sockets.
- Attach the keycaps and knob to the key switches and rotary encoder.
- Connect the USB cable.
- Open the VIA app.
- Go to the "Settings" tab and enable "Show Design tab".
- Go to the "Design" tab and upload the .json file.
- Go to the "Configure" tab. After authorizing the device, the macropad is now configurable!
Parts
20| Qty | Value | Footprint | References |
|---|---|---|---|
| 7 | 1N4148 | Library:D_DO-35_SOD27_P7.62mm_Horizontal_Hybrid | D1, D2, D3, D4, D5, D6, D7 |
| 6 | MX_SW_HS | PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1u | MX1, MX2, MX3, MX4, MX5, MX6 |
| 4 | MountingHole_M3 | MountingHole:MountingHole_3.2mm_M3_Pad | H1, H2, H3, H4 |
| 1 | PINHD_1x4_Male | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Horizontal | J1 |
| 1 | RotaryEncoder_Switch_MP | PCM_marbastlib-various:ROT_Alps_EC11E-Switch | SW7 |
| 1 | Seeeduino Xiao rp2040 | PCM_marbastlib-xp-promicroish:Xiao_rp2040_ACH | U1 |
Questions
How big is the Macroboard PCB?
It measures 102.9 × 45.7 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Macroboard use?
20 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 Macroboard KiCad files?
From the jjwuuu/macropad repository on GitHub, at the commit this page was made from: the board is PCB/macroboard.kicad_pcb and its schematic PCB/macroboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Macroboard design in my own project?
Its repository states no licence, so its author keeps all rights: ask jjwuuu before reusing the design.
Similar boards
- 2 layers66.9 × 74.5 mm

- 2 layers86.4 × 64.8 mm

- 2 layers36.2 × 26.8 mm

Esp32 minimal
atopile/atopile
Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️
20 parts4kMIT - 2 layers108.1 × 393.8 mm

Sweep compact ble
davidphilipbarr/Sweep
Sweep - a small promicro based keyboard inspired by the Ferris.
20 parts2.1k - 2 layers26 × 15.9 mm

TPS54340 Buck Regulator
rusefi/rusefi
rusefi - GPL internal combustion engine control unit
20 parts1.2k - 2 layers67.6 × 30.5 mm

Rgb to hdmi
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
20 parts1kGPL-3.0 - 2 layers44.3 × 28.7 mm

Lin bus adapter esp32
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
20 parts915 - 2 layers89.5 × 61.6 mm

FreeDeck TH 2020-02
FreeYourStream/freedeck-hardware
all the stuff you need to build your own FreeDeck
20 parts772