Inspiration
I love building keyboards, and I wanted designing one to feel as relaxed as playing Tiny Glade, where you drag a wall and the castle builds itself. The tools for designing keyboards and PCBs already exist. None of them feel like a game.
What it does
BYOKb lets you design a custom mechanical keyboard in 3D, in the browser:
- Start from a preset (60%, 75%, TKL, split, ortholinear…) and drag keys around. The case reshapes itself to fit them.
- Pick switches and keycaps, and hear the switch click when you drop a key.
- Add parts like a knob, screen or trackball, and design an LED pattern.
- Export what you need to build it: a 3D-printable case, QMK firmware with a wiring guide, and a KiCad PCB.
How we built it
I built it with Claude Code, following the Devpost "Build With AI" skills: scope, PRD, spec, then build step by step. Each step was checked and committed before the next one. The stack is React, Three.js (react-three-fiber), Zustand, Clipper for the 2D geometry, and Vite and Vitest.
Challenges we ran into
- Being a parent of two kids. Most of this was built in the gaps between bedtimes.
- Getting the case to wrap any layout. Split boards, rotated keys and odd gaps all needed a clean outline.
- The rounded top edge. My first try twisted the surface at the corners, so I rebuilt it from thin stacked layers.
- Fitting the electronics. A full-size keyboard and its parts had to fit the few pins of a small controller, and the USB port had to line up with an opening in the case.
Accomplishments that we're proud of
- A cozy, stylish app whose keyboards you can actually build: printable case, working firmware, real PCB file.
- Shipping a full product with AI, from idea to export.
What we learned
Running long AI build sessions works when the plan is clear and every step gets checked before moving on.
What's next for BYOKb - Bring Your Own Keyboard
- Polish the experience and add more sound effects.
- Make the PCB less bulky.
- Route the PCB traces (they aren't drawn yet).
Built With
- 3js
- claude
- javascript
- react
- zustand