2 layers31.6 × 14.3 mm
2 layers28.4 × 22.6 mm
Onekey
shreeyuvan2020/Onekey- Size
- 28.4 × 22.6 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 6
- Nets
- 16
- Pads
- 31
- Tracks, vias
- 73, 0
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 18 Apr 2026
- Updated
- 28 Aug 2026
Overview
Onekey is an open-source printed circuit board by shreeyuvan2020, from the shreeyuvan2020/Onekey repository on GitHub. It is a 2-layer board of 28.4 × 22.6 mm with 6 parts on 16 nets, routed with 73 tracks and 0 vias.
It is built around the SK6812MINI-E. Its parts include 1 capacitor, 1 resistor, 1 IC, 1 diode and 1 connector.
Main components
1README
readme.mdThe Onekey
The one key and knob macropad(available at onekey.hackclub.com)
Features
- Sandwhich mount for constistency of feel
- Magnetic Pogo Pin connectors for easily bonding the two sides of the macropad.
- Xiao RP2040 for cost efficiency
- Neopixel for shiny
Reasons I built this
- @maxstellar on slack asked me to help with his internship project, so I did!
Schematic
These schematics are very concise, it's just a MCU, whatever input device, and magnetic pogo pin connectors(generic symbol). Plus neopixel for key. First one is encoder, second is keyswitch
PCB
I designed the encoder PCB especially with a lot of care because the pcb had to stick out enough to reach into the case of the main onekey. The pcb with the key also took some time because at first I decided hotswap, but then changed to normal switches. I then made these basically centered. Also I had to work a bit on routing for the neopixel
Keyswitch PCB
Encoder PCB
CAD
I designed the CAD with portability, usability, and elegance in mind. I also had to design it with both a cutout for the USB and pogo pin connector.
Bottom Case of Encoder
Top Plate of Encoder
Bottom Case of Keyswitch
Top Plate of Keyswitch
Encoder Assembly
Keyswitch Assembly
Full Assembly
Firmware
The whole point of this YSWS is for people to create their own firmware for a one key macropad, so I don't have firmware here.
My Zine
Zine is at zine.pdf too, that might not load properly, try using chrome. Or download it and open. It's a known github issue.
Assembly Instructions
- First, obviously fabricate the PCB and solder everything.
- Next is printing the plates and cases.
- This is pretty simple, it was designed with tolerances, you can keep it at basically whatever setting
- Put heatset inserts through the bottom of the cases
- Then just screw the pcb and the bottom case together via those
- Then put the plate on
- Put the keycap on the switch
- You have a Onekey!
BOM
Credits
This project was helped by @owais. Thanks to fallout for sponsoring this!
Parts
6| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | 0.1 uF | Capacitor_SMD:C_0402_1005Metric | C1 |
| 1 | 330 ohms | Resistor_SMD:R_0402_1005Metric | R1 |
| 1 | Conn_01x04_Socket | 829-22-003-20-001101:MILL-MAX_829-22-003-20-001101 | J1 |
| 1 | MOUDLE-SEEEDUINO-XIAO | xiao:XIAO-Generic-Hybrid-14P-2.54-21X17.8MM | U1 |
| 1 | SK6812MINI-E | kicad-keyboard-parts.pretty-master:MX_SK6812MINI-E_REV | LED1 |
| 1 | SW_Push | PCM_marbastlib-mx:SW_MX_1u | SW1 |
More from shreeyuvan2020/Onekey
1Similar boards
- 4 layers234 × 84 mm
Main panel
google/mozc-devices
Circuit diagrams and firmware source code for Gboard DIY keyboards
234 parts3kApache-2.0 - 4 layers180.8 × 300.3 mm
Dilemma
Bastardkb/Dilemma
The Dilemma is a vertical stagger low-profile keyboard with mods.
383 parts590 - 4 layers48 × 32 mm
FlatSat
Pwnsat/FlatSat
Flatsat v1.0 is a hardware based platform for aerospace cybersecurity research
106 parts575GPL-2.0 - 2 layers
Demo
adamws/kicad-kbplacer
KiCad plugin for automatic keyboard's key placement and routing
48 parts547GPL-3.0 - 2 layers97 × 78.5 mm
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 mm
V4head
makerforgetech/modular-biped
An open source framework for creating a bipedal modular companion robot.
26 parts493GPL-3.0 - 2 layers115.7 × 95.7 mm
- 4 layers70 × 54 mm
Questions
How big is the Onekey PCB?
It measures 28.4 × 22.6 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Onekey use?
6 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 Onekey KiCad files?
From the shreeyuvan2020/Onekey repository on GitHub, at the commit this page was made from: the board is onekey/PCB/onekey.kicad_pcb and its schematic oneencoder/PCB/oneencoder.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Onekey design in my own project?
Its repository states no licence, so its author keeps all rights: ask shreeyuvan2020 before reusing the design.