Think in interfaces, not categories
A keyboard does not work because every product says “65%.” It works because the case accepts the PCB, the plate matches the PCB layout and mount, the stabilizers fit their mounting points, the switches fit the sockets and plate, and the keycaps match the stems and physical layout.
Start with the kit as the known system. If you are mixing a standalone case, PCB, and plate, require drawings or an explicit compatibility list from the designer. Shared dimensions in a size family are not a standard mounting contract.
Record exact identity before checking fit
- Product name and seller SKU
- Revision number for the case, PCB, plate, and daughterboard
- Selected hot-swap or soldered PCB option
- Selected ANSI, ISO, split-key, and bottom-row layout
- Plate material and cutout option
- Stabilizer mounting style
Run the core hardware checks
| Interface | Question to answer | Evidence to use |
|---|---|---|
| Case ↔ PCB | Do mounting points, ports, daughterboard, and clearance match? | Designer compatibility list or mechanical drawing |
| PCB ↔ Plate | Do switch positions, layout choices, and mount tabs match? | Exact PCB and plate layout diagrams |
| PCB / plate ↔ Stabilizers | Is the mount type correct, with every needed wire length? | PCB cutouts, plate drawing, and selected layout |
| PCB / plate ↔ Switches | Does the switch system, pin count, and plate cutout match? | PCB socket specification and switch drawing |
| Switches / layout ↔ Keycaps | Do stems, widths, rows, and spacebars all match? | Keycap kitting diagram against the final layout |
KBD Lab’s build tools can keep product candidates together, but no catalog can infer every selectable layout or revision. Use the product’s primary drawings as the final authority.
Check electrical and firmware requirements
- The PCB supports the intended wired or wireless mode.
- The case has room for the required battery and uses the specified connector.
- The daughterboard and cable match the PCB and case port placement.
- The exact revision has documented firmware and recovery instructions.
- Your operating system and preferred remapping tool are supported.
- Lighting orientation and keycap profile do not create a documented conflict.
Do not install an arbitrary lithium battery because the connector fits. Polarity, voltage, physical protection, and charging design must match the maker’s specification.
Audit the finished cart
- Re-open every cart line and confirm the selected variant, not the default product page.
- Count switches for the chosen layout and include a few spares.
- Count stabilizers and verify the spacebar wire.
- Match every non-standard key to the keycap kitting diagram.
- Compare the kit contents with the tools and accessories in the cart.
- Check stock type, shipping origin, return window, and defect process.
- Save the final configuration and diagrams with the build record.
If one link relies on “probably,” pause the order and ask the designer or seller a question that names both exact parts. Compatibility answers are most useful when they can be tied to a revision and a layout.
Verify while returns are still possible
Inventory the shipment immediately. Check that the PCB, plate, and case revisions match the order, then test the bare PCB using the maker’s instructions before soldering or applying irreversible modifications. Dry-fit major parts and a stabilized key before completing the assembly.
For the rest of the sequence, follow the first-build planning guide. It keeps each test at the earliest reversible checkpoint.
Sources and further reading
- Keyboard definition specificationVIA
Primary documentation for physical layout and hardware identifiers used by VIA.
- Adding a keyboard to QMKQMK Firmware
Technical background on the hardware definition behind QMK support.