Skip to the content
2 layers86 × 97.5 mmKeyraHackpad, the printed circuit board in 3D

My first custom Hackpad: 10-key macropad with an OLED display, RGB LED, and XIAO RP2040.

Size
86 × 97.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
23
Nets
25
Pads
92
Tracks, vias
168, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
17 Aug 2026
Updated
22 Aug 2026

Overview

KeyraHackpad is an open-source printed circuit board by Keyrajmnz, from the Keyrajmnz/KeyraHackpad repository on GitHub. It is a 2-layer board of 86 × 97.5 mm with 23 parts on 25 nets, routed with 168 tracks and 0 vias.

It is built around the SK6812MINI-E. Its parts include 11 diodes, 10 switches and 2 ICs. It belongs with the lEDs and displays and keyboards and input boards of this library.

Main components

1

README

README.md

KeyraHackpad

My first custom Hackpad: a 10-key macropad with an OLED display, RGB LED, and Seeed Studio XIAO RP2040.

✧˚ ⋆。˚ Design Preview ⋆。˚ ✧

Schematic

PCB Layout

✧˚ ⋆。˚ Features ⋆。˚ ✧

★ 10 mechanical keys

★ 0.91" 128×32 OLED display

★ SK6812MINI-E RGB LED

★ Seeed Studio XIAO RP2040

★ Custom PCB designed in KiCad

★ 4×3 switch matrix with 10 populated positions

★ Through-hole diodes for the switch matrix

★ Two firmware modes: Coding and Daily

★ Custom Fusion 360 case

✧˚ ⋆。˚ Coding Mode ⋆。˚ ✧

Coding Mode is designed for VS Code and includes:

★ Save — Ctrl + S

★ Undo — Ctrl + Z

★ Redo — Ctrl + Y

★ Copy — Ctrl + C

★ Paste — Ctrl + V

★ Screenshot — Win + Shift + S

★ Delete Line — Ctrl + Shift + K

★ Duplicate Line — Shift + Alt + Down

★ Find — Ctrl + F

✧˚ ⋆。˚ Daily Mode ⋆。˚ ✧

Daily Mode provides quick access to:

★ Gmail

★ Canvas

★ GitHub

★ Google Calendar

★ ClassLink

★ Screenshot

★ Google Classroom

★ Highline Portal

★ ChatGPT

The bottom-center key switches between Coding Mode and Daily Mode.

The OLED displays the current mode, and the RGB LED changes color to indicate the active mode.

✧˚ ⋆。˚ Hardware Design ⋆。˚ ✧

I designed the schematic and PCB in KiCad. I wired the 10-key switch matrix, connected the XIAO, OLED, and RGB LED, routed the PCB, checked the design, and exported the Gerber files for manufacturing.

The case was designed in Fusion 360 and exported as printable 3MF files and a STEP assembly.

✧˚ ⋆。˚ Firmware ⋆。˚ ✧

The firmware is written in CircuitPython using KMK.

It includes:

★ 10-key matrix scanning

★ Coding Mode

★ Daily Mode

★ Mode switching

★ Keyboard shortcuts

★ Website shortcuts

★ OLED mode display

★ RGB mode indication

Firmware source:

Firmware/code.py

✧˚ ⋆。˚ Bill of Materials ⋆。˚ ✧

QtyComponentNotes
10Cherry MX-compatible mechanical switches1.00u PCB mount
101N4148 diodesThrough-hole, DO-35
1Seeed Studio XIAO RP2040Microcontroller
1SK6812MINI-ERGB LED
10.91" 128×32 OLED displayI²C
10MX-compatible keycapsOne per switch
13D-printed caseCustom Fusion 360 design

✧˚ ⋆。˚ What I Learned ⋆。˚ ✧

This was my first hardware project, so there was definitely a lot I had to figure out along the way.

★ I learned how to design a schematic and PCB in KiCad.

★ I learned how switch matrices, diodes, and microcontrollers work together.

★ I learned how to route a PCB and fix DRC issues.

★ I learned how to design a custom case in Fusion 360.

★ I learned how to create Gerber files for manufacturing.

★ I learned how to write CircuitPython firmware with KMK.

★ I learned how the PCB, case, OLED, RGB LED, and firmware all come together to make one project.

★ The hardest part for me was definitely the case in Fusion 360. I got stuck a lot and honestly wanted to give up at one point, but I kept working through the problems and eventually got the case to fit.

★ This project taught me that debugging and being patient are just as important as knowing how to code.

✧˚ ⋆。˚ Repository Structure ⋆。˚ ✧

text
KeyraHackpad/
├── CAD/
│   └── KeyraHackpad_Case.step
│
├── PCB/
│   ├── KeyraHackpad.kicad_pcb
│   ├── KeyraHackpad.kicad_pro
│   └── KeyraHackpad.kicad_sch
│
├── Firmware/
│   └── code.py
│
├── production/
│   ├── CaseBottom.3mf
│   ├── Casewalls.3mf
│   ├── KeyraHackpad-Gerbers.zip
│   ├── main.py
│   └── SwitchPlatee.3mf
│
└── README.md

Parts

23
QtyValueFootprintReferences
101N4148Diode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7, D8, D9, D10
10SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10
1ER_OLEDM0.91_1x-I2CDisplay:ER_OLEDM0.91_1x-I2CU2
1MOUDLE-SEEEDUINO-XIAOfootprints:XIAO-Generic-Hybrid-14P-2.54-21X17.8MMU1
1SK6812MINI-Efootprints:SK6812MINI-E_fixedD11

Similar boards

  • 4 layers234 × 84 mmMain panel, the printed circuit board in 3D

    Main panel

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    234 parts3kApache-2.0
  • 4 layers180.8 × 300.3 mmDilemma, the printed circuit board in 3D

    Dilemma

    Bastardkb/Dilemma

    The Dilemma is a vertical stagger low-profile keyboard with mods.

    383 parts590
  • 4 layers48 × 32 mmFlatSat, the printed circuit board in 3D

    FlatSat

    Pwnsat/FlatSat

    Flatsat v1.0 is a hardware based platform for aerospace cybersecurity research

    106 parts575GPL-2.0
  • 2 layersDemo, the printed circuit board in 3D

    Demo

    adamws/kicad-kbplacer

    KiCad plugin for automatic keyboard's key placement and routing

    48 parts547GPL-3.0
  • 2 layers97 × 78.5 mmDumbpad, the printed circuit board in 3D

    Dumbpad

    imchipwood/dumbpad

    Simple 4x4 numpad with rotary encoder. Powered by QMK via ATmega32u4 Pro Micro

    62 parts517GPL-2.0
  • 4 layers82.5 × 39.4 mmV4head, the printed circuit board in 3D

    V4head

    makerforgetech/modular-biped

    An open source framework for creating a bipedal modular companion robot.

    26 parts493GPL-3.0
  • 2 layers115.7 × 95.7 mmFifi split keeb, the printed circuit board in 3D

    Fifi split keeb

    raychengy/fifi_split_keeb

    Fifi Keyboard 🐶 ⌨️

    66 parts334
  • 4 layers70 × 54 mmPicoLab, the printed circuit board in 3D

    PicoLab

    CoretechR/PicoLab

    Web-GUI Embedded Multitool

    285 parts327GPL-3.0

Questions

How big is the KeyraHackpad PCB?

It measures 86 × 97.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the KeyraHackpad use?

23 parts, built around the SK6812MINI-E. 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 KeyraHackpad KiCad files?

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

Can I use the KeyraHackpad design in my own project?

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