Skip to the content
2 layers111.5 × 72.6 mmKeybordy, the printed circuit board in 3D

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.md

keybordy 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.zipupload this to the fab
print-1to1-top.pdfprint at 100 % to check the fit on paper
render-top.png, render-bottom.png3D previews
drc.jsonDRC 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.

PartSignalGPIO (DevKit label)
K1 / K2 / K3 / K4 (top row)leg A16 (RX2) / 18 / 21 / 23
K5 / K6 / K7 / K8 (bottom row)leg A4 / 17 (TX2) / 19 / 22
all keysleg BGND
OLEDSDA / SCL33 / 32
OLEDVCC / GND3V3 / GND
RotaryCLK / DT / SW35 / 34 / 39 (VN)
Rotary+ / GND3V3 / GND

Firmware for this board needs:

cpp
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 module

keys8 as it is will not read the keys on this board, because its key pins are different.

Before you order: check on paper

  1. Print pcb/fab/print-1to1-top.pdf at 100 % ("actual size", not "fit to page"). Measure the board outline on paper. It must be 111.5 mm wide.
  2. Lay the DevKit on the print chip up, with USB at the USB mark. Every DevKit pin must sit on a pad, and the DevKit's own labels must match the silkscreen labels: VIN over VIN, 3V3 over 3V3. If they are mirrored, stop: the board is wrong for your DevKit.
  3. Check that the rows are 25.4 mm apart (10 holes on perfboard). If yours are 22.86 mm, change DEVKIT_ROW_SPACING in build.py and run just pcb-build.
  4. 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

  1. 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.
  2. 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.
  3. 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.
  4. Leave PCB Assembly off. Every part is hand-soldered.
  5. 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

QtyPart
8 (+2 spare)Kailh MX hotswap socket (CPG151101S11)
2female header 1×15, 2.54 mm, vertical (DevKit)
1female header 1×4, 2.54 mm, vertical (OLED)
1female header 1×5, 2.54 mm, right angle (rotary)
5M2 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

  1. Hotswap sockets on the back. Tin one pad, slide the socket in with tweezers, reflow the pad, then solder the other pad.
  2. 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.
  3. OLED header and rotary right-angle header, the same way, with the module plugged in.
  4. 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
QtyValueFootprintReferences
8Kailh MX hotswapSW_MX_HS_CPG151101S11_1uK1, K2, K3, K4, K5, K6, K7, K8
5M2MountingHole_2.2mm_M2H1, H2, H3, H4, H5
1DevKit bottom rowPinSocket_1x15_P2.54mm_VerticalJ2
1DevKit top rowPinSocket_1x15_P2.54mm_VerticalJ1
1KY-040 rotaryPinSocket_1x05_P2.54mm_HorizontalJ4
1SSD1306 OLEDPinSocket_1x04_P2.54mm_VerticalJ3

Similar boards

  • 2 layers50 × 35 mmServo power, the printed circuit board in 3D

    Servo power

    earthtojake/text-to-cad

    Design physical products with AI

    17 parts26kMIT
  • 2 layers139.7 × 62.2 mmBreakout 60pin EEC IV, the printed circuit board in 3D

    Breakout 60pin EEC IV

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    17 parts1.2k
  • 2 layers29.2 × 55.9 mmDeniseadapter, the printed circuit board in 3D

    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 mmCluster, the printed circuit board in 3D

    Cluster

    JesusFreke/lalboard

    A 3D-printed keyboard inspired by the DataHand

    17 parts993
  • 2 layers56.3 × 55.7 mmStarNecklace, the printed circuit board in 3D

    StarNecklace

    hackclub/OnBoard

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

    17 parts915
  • 2 layers25 × 25 mmSmallEncoder, the printed circuit board in 3D

    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 mmAmoeba spc, the printed circuit board in 3D

    Amoeba spc

    mtl/keyboard-pcbs

    Keyboard PCBs

    17 parts485
  • 2 layers36 × 51 mmABSIS ALE, the printed circuit board in 3D

    ABSIS ALE

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    17 parts431

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.