A custom 75% mechanical keyboard with macro keys powered by a Raspberry pi pico and KMK firmware that I designed and built during Hackclub's Blueprint program - project link

I made this project to learn the fundamentals of how keyboards and macropads work, to improve my PCB design skills by learning how switch matrixes work and to get more familiar with modelling parts in CAD for 3D printing.

BOM • Images • Firmware • Wiring • Keys • Stabilizers

• 93 programmable macro keys
• Custom 2-layer PCB
• Powered by a Raspberry Pi Pico
• Custom KMK firmware
• Simple USB connectivity
• Clicky Cherry MX key switches
• 3D printed case & platelate
• Rubber feet pads for stability
• Easy assembly with no screws

Demo video: click here

Final Build	PCB

Here, you can see my KiCad schematic, PCB layout and 3D model of my PCB. On the right, you can see my keyboard bottom case I modelled in Fusion 360 as well as my custom plate and an assembly image.

Click to see schematic

Click to see PCB

Click to see 3D PCB

Click any of the images below or click above to see it in more detail

PCB	CAD

Click to see case model

Click to see plate model

Click to see keyboard assembly

I have written my custom keyboard code in CircuitPython using KMK to control the keystrokes and I have made a macro handler at the start that means I can change the function of any of my keys whenever I want.

My macro keys at the moment:

• Previous song
• Play / Pause
• Next song
• Volume down
• Volume up
• Lock
• File Explorer
• Task Manager

Setup:

• Flash CircuitPython onto the pico
• Download KMK from Github and copy to root
• Import code.py onto the pico using Thonny

My keyboard is a 75% keyboard with a total of 93 keys - 85 normal and 8 custom macro keys.

Here is the link to my custom keyboard layout

Click to expand cart screenshots

My spacebar, left shift, right shift, enter and backspace all need MX stabilizers as they are above 2u and these will be plate-mounted.

• [✅] A short description of what your project is

• [✅] A couple of sentences on how to use your project

• [✅] A couple of sentences on why you made the project

• [✅ ] Screenshot of a full 3D model of your project

• [✅ ] Screenshot of your PCB (if applicable)

• [✅ ] Wiring diagram (if any wiring is not on a PCB)

• [✅] Bill of Materials (BOM) in table format at the end of the README, with links BOM

• [✅] Fully original, customized design (not a direct copy of any guide)

• [✅] Complete CAD assembly including all components (electronics included)

• [✅] Firmware present (even if untested)

• [✅] Design sanity‑checked with someone else (checked by @krunch) + preliminary approved by @shadow

• [✅] BOM in CSV format in the root directory, with links

• [✅] PCB source files (.kicad_pro, .kicad_sch, gerbers.zip, etc.) if applicable

• [✅] A .STEP file of the full 3D CAD model including electronics

• [✅] Source CAD files (.f3d, .FCStd, etc., or OnShape public link in README)

• [✅] All other project files included (firmware, libraries, references, etc.)

• [✅] Repository organized into readable, logical folders

⚠️ Important: Missing a complete .STEP file with all electronics and CAD will result in project rejection. ✅

Designed and built by @gethin101