# Universal Product Assembly Guide

Most of our products are built exactly the same way so we've make one universal guide you can follow to assemble your keyboard or macropad kit.

If your product is listed under the "Specific Assembly Guides" on the left, disregard this universal guide and follow the specific one instead.

# NOTE This guide is a work in progress

# Flash the MCU

It's important to flash the MCU before starting to make sure it works.

  1. Download the .uf2 file for the device from the firmware list.
  2. While holding the boot button, plug the MCU into the computer.
  3. Drag the .uf2 file into the new drive that shows up. Confirm the device shows up in VIAL after it disconnects and reconnects.

TODO(add photos)

# Solder the Diodes

  1. Bend the diode and insert it into the PCB being careful it is the correct orientation. The black bar on the diode matches with the thicker white bar on the PCB.

  1. After the diode is inserted, bend the leads outwards so it stays in place. Repeat steps 1 and 2 for each diode.

  1. With each diode in place, Solder them to be permanently secured.

  1. Bend the diodes legs straight and use flush cuts to them off. Be careful not to scratch the PCB when doing this.

# Solder Hotswap Sockets

  1. If any come with your kit, you'll need to solder them now. Most keyboards will at least have a few hotswap sockets that go under the MCU.

# Stabilizers

  1. Install the PCB mounted stabilizers.

They usually screw in but some might clip in. Below are a few links that explain keyboard stabilizers and how to install them. You'll need a stabilizer for each key that is 2u or larger.

# Trim The Headers

The headers might need to be trimmed or the backplate will not fit. This is especially true for keyboards that have less than 4 rows. We recommend always trimming them. (Different boards will have different MCUs which will have different amounts of headers.)

  1. Cut the longer side of the headers in half as shown. It doesn't have to be precise.

# Check for Soldered/Hotswap switches under the MCU

Check to see if there are switches that need to be soldered under the MCU. (Most designs will use hotswap sockets)

Example of soldered switches under MCU.

Example of hotswap switches under MCU.

  • If your keyboard kit contains soldered switches under the MCU, it's extremely important to follow a specific order. We also recommend converting them to hotswap with Mil-Max Sockets. Once a switch is soldered, it cannot be removed because the MCU will be covering it (We do our best to avoid this senario but it may be necessary because of design constraints. It's important to double check). Follow the step order outlined in The Richard Guide (v1)

  • If your keyboard kit contains hotswap sockets under the MCU, proceed with this guide as outlined.

# Solder MCU

  1. Insert the trimmed headers into the PCB.

  1. Add the MCU on top.

  1. Use a rubber band to hold everything in place.

  1. Solder both sides of the headers to perminently hold everything together.


TODO (install the OLED at this point)

# Switches and Plate

The switches and the plate steps go together. It's your preference on the exact way to do it. If you're new to assembling keyboards, we recommend trying the order outlined

  1. Install a few switches into the plate.

  1. Install the plate and switches on the PCB, solder one lead of each switch if it's a soldered board.

  1. Verify switches are sitting flush.

  2. Insert the remaining switches into the plate.

  1. finish soldering all the remaining switches.

# Rotary Encoders

WIP install rotary encoders

# Test the PCB

  1. Plug the finished MCU into the computer and open VIAL. Verify that each switch works by using the matrix tester in VIAL.

oops I missed a switch!

# Finish Assembly


  • 3D printed cases should be assembled with caution. Do not use a drill.
  • Insert and M3 square nuts

# Add Keyboard Feet

# Add keycaps and knobs

# That's it!

  1. Celebrate. It's required.

Check out the programming guide to learn more about how to use your device.