Skip to the content
2 layers335.4 × 118.1 mmKeyboard, the printed circuit board in 3D

I made this project as a continuation for the hackpad, and I really wanted to know how building a real keyboard is, not just a macropad. This helped me finally understand how keyboards really work!

Size
335.4 × 118.1 mm
Copper layers
2
Thickness
1.6 mm
Parts
169
Nets
123
Pads
802
Tracks, vias
1,020, 187
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
20 Jun 2025
Updated
22 Sep 2025

Overview

Keyboard is an open-source printed circuit board by GuySabban, from the GuySabban/custom-keyboard repository on GitHub. It is a 2-layer board of 335.4 × 118.1 mm with 169 parts on 123 nets, routed with 1,020 tracks and 187 vias.

It is built around the ESP32-S3-DEVKITC-1-N8. Its parts include 84 switches, 83 diodes, 1 IC and 1 connector. It belongs with the keyboards and input boards and the ESP32 boards of this library.

Main components

1

README

README.md

Custom Keyboard

This is my fully custom keyboard, fitted with a 75% layout, 2 macro keys, a knob and an oled screen!

I made this project as a continuation for the hackpad, and I really wanted to know how building a real keyboard is, not just a macropad. This helped me finally understand how keyboards really work! image
image

BOM

ItemQuantityPriceLink #
INDIVIDUAL ITEMS
Womier Coffee Cat keycaps126.54 USDhttps://womierkeyboard.com/products/womier-coffee-cat-143?variant=40539585740871
Akko V3 Creamy Purple Pro switches9033.72 USDhttps://en.akkogear.com/product/akko-v3-creamy-purple-pro-switch
PCB513 + ~15 = 28 USD (can't see shipping estimate right now, it doesnt let me cause of war)
ALIEXPRESS ITEMS
Knob13.58 USDhttps://www.aliexpress.com/item/1005007576522714.html
OLED Screen 128x3213.68 USDhttps://www.aliexpress.com/item/1005007038294972.html
DO-35 Diodes1001.65 USDhttps://www.aliexpress.com/item/4000142272546.html
Hot swap sockets11015.59 USDhttps://www.aliexpress.com/item/1005007476614771.html
Stabilizers (4x 2u + 1x 6.25u)4+17.24 USDhttps://www.aliexpress.com/item/1005006528731543.html
ESP32 S3 Devkit C1119.56 USD (including shipping)https://www.aliexpress.com/item/1005003979778978.html
EC11 Rotary Encoder11.56 USD (including shipping)https://www.aliexpress.com/item/1975155185.html
M3 Screws202.54 USDhttps://www.aliexpress.com/item/32810872544.html
Poron strips644.75 USDhttps://www.aliexpress.com/item/1005003607093794.html
AliExpress Total (including their discounts and stuff)51.33 USD
TOTAL139.59 USD

Parts

169
QtyValueFootprintReferences
83DiodeScottoKeebs_Components:Diode_DO-35D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +67
72KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.00uS1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22, S23 +56
3KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.25uS72, S73, S74
3KeyswitchScottoKeebs_Hotswap:Hotswap_MX_2.00uS27, S58, S69
2KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.50uS29, S42
1ESP32-S3-DevKitCPCM_Espressif:ESP32-S3-DevKitCU1
1KeyswitchScottoKeebs_Hotswap:Hotswap_MX_2.25uS56
1KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.75uS44
1KeyswitchScottoKeebs_Hotswap:Hotswap_MX_6.25uS75
1OLED_128x32ScottoKeebs_Components:OLED_128x32J1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW1

Similar boards

  • 4 layers95 × 95 mmCube motherboard, the printed circuit board in 3D

    Cube motherboard

    willem-pennings/balancing-cube

    A cube that balances itself in a corner or edge using reaction wheels

    52 parts1.1kGPL-3.0
  • 2 layers129.9 × 63.6 mmTraeger rev 2.3.0.kicad pro, the printed circuit board in 3D

    Traeger rev 2.3.0.kicad pro

    jazzmonger/Traeger-PID-Controller

    Traeger Smoker/Grill Controller based on an

    45 parts36
  • 2 layers168.8 × 78.9 mmGameboy3, the printed circuit board in 3D

    Gameboy3

    ohasanov-hbrw/tribit32-advanced

    A tri-microcontroller, overengineered GameBoy Advance clone. More value was given to the controls and the exterior look, which is cool!

    61 parts8
  • 2 layers134.6 × 49.5 mmMem esp, the printed circuit board in 3D

    Mem esp

    fread/visvitalis

    A very simple modular relay computer

    71 parts7
  • 2 layers90 × 102 mmPL Toon, the printed circuit board in 3D

    PL Toon

    pl-toon/pl-toon-codes

    PL-TOON material

    39 parts7
  • 2 layers119.4 × 98.9 mmPCB Pami, the printed circuit board in 3D

    PCB Pami

    FIPATECH/CDFR26_PAMI

    Open source firmware and PCB for a differential mobile robot (PAMI) based on ESP32-S3 - Coupe de France de Robotique

    25 parts6
  • 2 layers76.2 × 40.6 mmEspressifESP32toExpressAdaptor, the printed circuit board in 3D

    EspressifESP32toExpressAdaptor

    dnhutchins/ETC_Express_Reverse_Eng

    The ultimate goal of this work is to develop an interface to use the control surface from a legacy ETC Express 24/48 lighting controller as a modern EOSNomad compatible programming and fader wing.

    3 parts5
  • 2 layersE ink multi sensor, the printed circuit board in 3D

    E ink multi sensor

    heckler/esphome-device-configs

    Configuration definitions for local ESPHome files

    11 parts4Apache-2.0

Questions

How big is the Keyboard PCB?

It measures 335.4 × 118.1 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Keyboard use?

169 parts, built around the ESP32-S3-DEVKITC-1-N8. 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 Keyboard KiCad files?

From the GuySabban/custom-keyboard repository on GitHub, at the commit this page was made from: the board is PCB/keyboard.kicad_pcb and its schematic PCB/keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Keyboard design in my own project?

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