Skip to the content
2 layers169.2 × 120.2 mmLeft keyboard, the printed circuit board in 3D

Construction of a custom split keyboard for Keeb YSWS project

Size
169.2 × 120.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
63
Nets
89
Pads
303
Tracks, vias
310, 7
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
21 Jun 2026
Updated
26 Oct 2026

Overview

Left keyboard is an open-source printed circuit board by jijiaceness, from the jijiaceness/custom-keyboard repository on GitHub. It is a 2-layer board of 169.2 × 120.2 mm with 63 parts on 89 nets, routed with 310 tracks and 7 vias.

It is built around the RJ45. Its parts include 28 diodes, 28 switches, 1 IC and 1 connector. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

1

README

README.md

My Custom Keyboard: Overview

This is a fully custom 55-key split mechanical keyboard built from scratch, from the PCB to the 3D-printed case, developed with the support of Hack Club Program Keeb. I came into this project with almost no knowledge of how a keyboard works or the parts it consisted of, and over this two-month journey, I learned how to make all the components that make up a functional keyboard.

Features

  • Unique split keyboard layout
  • Ergonomic ortholinear and column-staggered keys
  • RJ45 socket connecting the two sides that supports hot-plugging
  • 3D-printed top mount case with a base, plate, and top frame
  • QMK firmware support with 3 custom layers

Why I Built It

I've been wanting a split keyboard for a while after typing for hours on my laptop and experiencing hand pain and cramps. Mechanical keyboards have always appealed to me, and the Hack Club program Keeb was a great opportunity for me to build my own while learning the inner workings of a keyboard. I also liked the idea of how customizable my own keyboard would be as I could code what each key does instead of relying on the built-in funcitonality.

What I Learned

Again, I came into this endeavor with no idea what a switch even was, so I most likely learned more from building this keyboard than in any of my year-long classes at school.

I learned ...

  • What a PCB actually does and its relation to a microcontroller
  • How to make a PCB from scratch
  • How to use Onshape and how to 3D-design with parametric modeling
  • The different parts of a keyboard (switches, diodes, stabilizers, sockets, microcontroller, etc.)
  • The software that makes your computer actually recognize and process keyboard input
  • How to write the software and tailor it to my design
    • The relation between keymaps.c, keyboard.h, and info.json was particularly interesting; I didn't know that the matrix in info.json was based on the physical positioning of the switches

Challenges

The biggest challenge was definitely getting used to the applications (KiCad and Onshape) and their workflow. Not understanding the right sequence and way to do things, even with the help of Keeb's guide, cost me many hours of redoing things and searching into the depths of the internet to fix.

For KiCad, I didn't really finalize my layout on the schematic before moving onto the PCB editor and also put my left and right PCB on the same project, which went against KiCad's method of designing PCBs. I spent a lot of time moving the right PCB into a new project but still had to redo most of it.

For Onshape, I had no idea how to properly constrain my sketches, and my first iterations were filled with haphazard lengths and angles. I probably redid my sketch 10 times while designing the case. I do feel proud now in how far I've come in CADing since the beginning, and my sketches are much cleaner now.

Keyboard Overview

Schematic

Left schematic

Right schematic

PCB

3D view

left viewright view

Case

Left Case


Right Case


Bill of Materials (BOM)

ItemNameQuantityNotesCost (USD)
1Raspberry Pi Pico2SC0916$7.82
2Left PCB from JLCPCB1$13.8
3Right PCB from JLCPCB1$13.8
4Cherry MX Switches5570 count, Orange key switch.$16.8
51N4148 Diodes55100 count$3.91
6M3xD4.6xL3.0 heatset inserts52100 count$5.18
7M3x5mm screws750 count$2.56
8M3x14mm screws650 count$3.54
9RJ45 Shield Network Jack2Comes in pack of 2, RJHSE-XM80$3.82
10Micro USB to USB-A Cable11m$2.6
11USB-A to USB-C adapter1$3.45
12Rj45 Connector10.5m$4.37
13DSA Blank Custom Keycaps6285 pcs (any keycaps bigger than 1u counts as 2 pcs$32.94
14
TOTAL$114.59

Credits

This project was possible due to the numerous open-source projects and resources, especially the the keyther by MagoSaronno as well as many other detailed in the journal. Finally, thank you to Hack Club Keeb for providing the guides and opportunity for me to build a keyboard!

Parts

63
QtyValueFootprintReferences
281N4148Diode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +12
25SW_PushPCM_marbastlib-mx:SW_MX_1uSW1, SW2, SW10, SW11, SW12, SW14, SW15, SW16, SW17, SW18, SW20, SW21, SW22, SW23, SW24, SW25 +9
5MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4, H5
1PicoRaspberry_Pi_Pico_and_Boards:RPi_Pico_SMD_THU1
1RJ45Connector_RJ:RJ45_Amphenol_RJHSE5380J1
1SW_PushPCM_marbastlib-mx:SW_MX_1.75uSW19
1SW_PushPCM_marbastlib-mx:SW_MX_1.5uSW13
1SW_PushPCM_marbastlib-mx:SW_MX_1.25uSW7

Similar boards

  • 2 layers33.7 × 97.8 mmHAN ESP TSS721, the printed circuit board in 3D

    HAN ESP TSS721

    UtilitechAS/amsreader-firmware

    ESP8266 and ESP32 compatible firmware to read, interpret and publish data to MQTT from smart electrical meters, both DLMS and DSMR is supported

    29 parts470
  • 4 layers84 × 82 mmToad, the printed circuit board in 3D

    Toad

    travisgoodspeed/goodfet

    An embedded bus adapter for various microcontrollers and radios.

    241 parts333
  • 2 layers100 × 100 mmCANBuster, the printed circuit board in 3D

    CANBuster

    GBert/misc

    miscellaneous stuff / unsorted

    182 parts99
  • 2 layers50 × 55.4 mmCasserole, the printed circuit board in 3D

    Casserole

    puddly/casserole

    Control GE appliances

    23 parts94Apache-2.0
  • 2 layers67.9 × 47.8 mmPlatine, the printed circuit board in 3D

    Platine

    nv1t/standing-desk-interceptor

    I wanted to intercept the communication between my Flexispot standing desk buttons. This is the progress on the project

    11 parts52CC0-1.0
  • 4 layers90 × 75 mmCM4 2 Backup, the printed circuit board in 3D

    CM4 2 Backup

    olvint/CM4-NAS-MiniPCIE

    Raspberry Pi CM4 based NAS solution board

    21 parts51
  • 4 layers73.9 × 84.5 mmAei, the printed circuit board in 3D

    Aei

    Severson-Group/AMDC-Hardware

    Circuit board designs for controlling advanced motor systems

    54 parts51
  • 2 layers99 × 60 mmPwr, the printed circuit board in 3D

    Pwr

    mfkiwl/KiwiSDR_PCB

    KiCAD PCB files for KiwiSDR project including active antenna and bias tee

    64 parts46

Questions

How big is the Left keyboard PCB?

It measures 169.2 × 120.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Left keyboard use?

63 parts, built around the RJ45. 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 Left keyboard KiCad files?

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

Can I use the Left keyboard design in my own project?

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