

Keybordy
ESP32 DevKit keyboard: 8 MX switches on jumpers, rotary later, with a fully local Velxio simulator
- Size
- 111.5 × 72.6 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 17
- Nets
- 15
- Pads
- 116
- Tracks, vias
- 54, 1
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 29 Sep 2026
- Updated
- 27 Oct 2026
Overview
Keybordy is an open-source printed circuit board by davide97g, from the davide97g/keybordy repository on GitHub. It is a 2-layer board of 111.5 × 72.6 mm with 17 parts on 15 nets, routed with 54 tracks and 1 via.
Its parts include 8 switches and 4 connectors. It belongs with the keyboards and input boards of this library.
README
pcb/README.mdkeybordy PCB, rev A
A 2-layer carrier board, 111.5 × 72.6 mm. The ESP32 DevKit, the OLED and the rotary module plug into female headers. The eight MX switches go into Kailh hotswap sockets on the back. Every switch has a real GND through the ground pour, so no GPIO is used as a ground. That frees enough pins for the OLED and the rotary.
build.py generates the board (keybordy.kicad_pcb), with every coordinate written in the script. It needs no autorouter. just pcb-build regenerates the board, routes it, runs DRC and writes the fab files to pcb/fab/ (gitignored). just pcb-open opens the board in KiCad 10, installed in ~/Applications/KiCad. If you edit the board by hand in KiCad, just pcb-build overwrites those edits, so run just pcb-fab afterwards instead.
File in pcb/fab/ | Use |
|---|---|
keybordy-gerbers.zip | upload this to the fab |
print-1to1-top.pdf | print at 100 % to check the fit on paper |
render-top.png, render-bottom.png | 3D previews |
drc.json | DRC report: 0 violations, 0 unconnected |
Pin map
This map differs from the jumper rig in firmware/keys8. The key pins are the eight usable pins on the DevKit row nearest the keys, so the tracks fan out without crossings.
| Part | Signal | GPIO (DevKit label) |
|---|---|---|
| K1 / K2 / K3 / K4 (top row) | leg A | 16 (RX2) / 18 / 21 / 23 |
| K5 / K6 / K7 / K8 (bottom row) | leg A | 4 / 17 (TX2) / 19 / 22 |
| all keys | leg B | GND |
| OLED | SDA / SCL | 33 / 32 |
| OLED | VCC / GND | 3V3 / GND |
| Rotary | CLK / DT / SW | 35 / 34 / 39 (VN) |
| Rotary | + / GND | 3V3 / GND |
Firmware for this board needs:
static const int KEY_PINS[] = {16, 18, 21, 23, 4, 17, 19, 22};
// no GND_PINS: every switch is on the GND pour
Wire.begin(33, 32); // SDA, SCL
// rotary: CLK 35, DT 34, SW 39, pull-ups on the modulekeys8 as it is will not read the keys on this board, because its key pins are different.
Before you order: check on paper
- Print
pcb/fab/print-1to1-top.pdfat 100 % ("actual size", not "fit to page"). Measure the board outline on paper. It must be 111.5 mm wide. - Lay the DevKit on the print chip up, with USB at the
USBmark. Every DevKit pin must sit on a pad, and the DevKit's own labels must match the silkscreen labels:VINoverVIN,3V3over3V3. If they are mirrored, stop: the board is wrong for your DevKit. - Check that the rows are 25.4 mm apart (10 holes on perfboard). If yours are 22.86 mm, change
DEVKIT_ROW_SPACINGinbuild.pyand runjust pcb-build. - Check the pin order printed on the OLED (
GND VCC SCL SDA) and on the rotary (CLK DT SW + GND) against the silkscreen.
Ordering at JLCPCB
- Open jlcpcb.com, go to "Order now" and upload
pcb/fab/keybordy-gerbers.zip. The viewer should show 2 layers and 111.5 × 72.6 mm. - Keep the defaults: FR-4, 2 layers, 1.6 mm thick, 1 oz copper, HASL (lead-free costs a little more), quantity 5. Any colour works; green ships fastest.
- Under "Mark on PCB", choose "Remove Mark" if you don't want JLC's order number printed on the silkscreen. It costs a little extra.
- Leave PCB Assembly off. Every part is hand-soldered.
- Pay and pick shipping. Tax for Italy/EU is charged at checkout (IOSS), so nothing is due on delivery.
PCBWay (pcbway.com) and Aisler (aisler.net, made in Germany, no customs) accept the same zip. Aisler can also take keybordy.kicad_pcb directly.
Parts to buy
| Qty | Part |
|---|---|
| 8 (+2 spare) | Kailh MX hotswap socket (CPG151101S11) |
| 2 | female header 1×15, 2.54 mm, vertical (DevKit) |
| 1 | female header 1×4, 2.54 mm, vertical (OLED) |
| 1 | female header 1×5, 2.54 mm, right angle (rotary) |
| 5 | M2 screws + standoffs, optional, for a case or plate |
Without a plate, 3-pin switches sit loosely in hotswap sockets. A 3D-printed plate 5 mm above the PCB, the standard MX height, holds them. The M2 holes are there for it.
Assembly order
- Hotswap sockets on the back. Tin one pad, slide the socket in with tweezers, reflow the pad, then solder the other pad.
- DevKit headers on the front. Plug both headers onto the DevKit first, then solder them with the DevKit in place, so the rows stay parallel and at the right spacing.
- OLED header and rotary right-angle header, the same way, with the module plugged in.
- Flash the PCB firmware, then plug the DevKit in.
Credits
keybordy.pretty/SW_MX_HS_CPG151101S11_1u.kicad_mod comes from marbastlib by ebastler and is licensed CERN-OHL-P v2. Every other footprint ships with KiCad.
Parts
17| Qty | Value | Footprint | References |
|---|---|---|---|
| 8 | Kailh MX hotswap | SW_MX_HS_CPG151101S11_1u | K1, K2, K3, K4, K5, K6, K7, K8 |
| 5 | M2 | MountingHole_2.2mm_M2 | H1, H2, H3, H4, H5 |
| 1 | DevKit bottom row | PinSocket_1x15_P2.54mm_Vertical | J2 |
| 1 | DevKit top row | PinSocket_1x15_P2.54mm_Vertical | J1 |
| 1 | KY-040 rotary | PinSocket_1x05_P2.54mm_Horizontal | J4 |
| 1 | SSD1306 OLED | PinSocket_1x04_P2.54mm_Vertical | J3 |
Similar boards
- 2 layers50 × 35 mm

- 2 layers139.7 × 62.2 mm

- 2 layers29.2 × 55.9 mm

Deniseadapter
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
17 parts1kGPL-3.0 - 2 layers24.5 × 36.5 mm

- 2 layers56.3 × 55.7 mm

StarNecklace
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
17 parts915 - 2 layers25 × 25 mm

SmallEncoder
DDeGonge/OS-ARM
This arm is not industrial and it will not be fast, but that is not my goal. But it will hopefully be a very nice looking arm fully capable of 6dof motion, cheap enough to keep it accessable but capable enough to…
17 parts498MIT - 2 layers38.9 × 16.1 mm

- 2 layers36 × 51 mm

Questions
How big is the Keybordy PCB?
It measures 111.5 × 72.6 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Keybordy use?
17 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 Keybordy KiCad files?
From the davide97g/keybordy repository on GitHub, at the commit this page was made from: the board is pcb/keybordy.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Can I use the Keybordy design in my own project?
Its repository states no licence, so its author keeps all rights: ask davide97g before reusing the design.