real-time 3D · open hardware

Keyboard configurator

A free configurator for enthusiast keyboards, built from their designers’ published CAD. Choose a board, its case, caps, colourway, legends and light, then take it apart to see every part.

role
product · design · build
for
people choosing, or dreaming about, their next board
status
live · 2026

[live: the configurator in its embed mode · it rolls a new look every few seconds · choose a preset, or press into the board to turn it]

01why it exists

You cannot try on a keyboard that has not been built.

Enthusiast keyboards are bought as parts or in group buys, months before they exist. The decision is made from a handful of renders, in whatever colours the designer happened to choose.

This puts the real board on screen: its actual case, plates and circuit boards from the designer’s files, in any material, under any caps. Turn it, light it, pull it apart, and send the link to whoever is talking you out of it.

14
boards: eight splits, a TKL and a five-board retro family
59
colourways, each with a note on where it comes from
15
keycap sets, from Cherry and SA to low-profile Choc
15
case materials: eight metals and seven woods, plus plastics
4K
photo of any build, saved from the page

02builds

Three boards, three moods.

Cygnus 3x5 · walnut · Olivia colourway · 36 keys
Charybdis Nano · clear caps · per-key RGB wave · 35 keys
Dilemma MAX · exploded · 56 keys

03what it does

Features.

Boards

  • Eight community split keyboards: Cygnus, Charybdis Nano, Dilemma MAX, moNa2, TOTEM, and three Cornes
  • A tenkeyless: the Geonworks F1-8X 722, 84 keys
  • A retro family from 39 to 101 keys, modelled from my own 1980s Acer KB-101A
  • The picker is a gallery of technical drawings, generated from the models themselves

Configure

  • Cases in aluminium, anodised aluminium, brass, copper, silver, steel, titanium or gold
  • Seven woods, each board with its own grain; clear, frosted and opaque plastics
  • Finishes: sandblasted, clear, brushed or polished; patina; heat-tint colours on titanium
  • Legends in English, Thai or Japanese
  • Per-key light with shine-through legends; an OLED panel in four styles on the retro boards
  • A dice button rolls a look from Western and Japanese colour theory, with undo

Look closer

  • Exploded view: caps, switches, plates, circuit boards and case in separate layers
  • Show parts: name any part and see where it sits
  • Five fixed views and a slow turntable
  • Studio light, or a single soft spotlight

Share and keep

  • One link holds the board, materials, light, camera and even the wood’s grain
  • A 3840 × 2160 photo of the build; phones get the share sheet
  • The last build returns on reload
  • Credits and licences for every board and keycap set, in the viewer

Engineering

  • Built from the designers’ STEP, KiCad and STL files by Python generators
  • Models ship as compact indexed binaries, about 2 MB for the lightest board to 30 MB for the heaviest
  • A worker thread finds the free edges that get a machined chamfer
  • After each deploy a script warms the CDN’s cache with every model

04decisions

Why it is the way it is.

fidelityStart from the designers’ own CAD.
These boards are open hardware; their makers publish the files. Building from those files means the keyboard on screen is the keyboard that gets made, down to the screws, and the credit goes where it is due: every board and keycap set carries its author and licence in the viewer.
craftChamfers only on edges a machinist would cut.
A chamfer on every edge softens the seams where parts meet, and the board stops looking assembled. Only exposed free edges get one. A bug once silently dropped two thirds of them, so the build now checks that the chamfer list matches the models’ free edges.
honestyOffer the look, say the limit.
Low-profile Kailh caps look good on MX boards, so they are offered there, with a note that they would bottom out before the switch actuates. A configurator should not let someone order a mistake unwarned.
accuracyRound parts sit on the hole, not the circuit board.
Jacks and knobs placed from the PCB data sat 1.1 mm off their openings in the case. They are centred on the case’s hole instead, because that is what the eye checks.
delightA dice button, with undo.
Fifty-nine colourways across fifteen materials is a lot of choosing. Rolling a look built on colour theory gets people to something handsome in one press, and undo makes it safe to keep rolling.
speedEach board loads only its own models.
Models are baked to compact binaries and fetched per board, and the page that embeds the configurator caps its resolution, sleeps off screen and never touches the visitor’s saved build.
licencesThe source stays private; the result is free to use.
Some of the bundled models are licensed for personal or non-commercial use only, so the repository is private and the configurator sells nothing.

[three.js in a single page · Python generators · the boards are their designers’ work, credited in the viewer]

the whole ledger patricktanna.com