Build Steps
The Reviung 41 is a surface-mount, hotswap build: the diodes, LEDs and switch sockets are soldered to the PCB, and your switches push into the sockets afterwards. We'll prepare the controller first, then solder the SMD components before fitting the diffuser and assembling the case.
The front of the main PCB (switches and top plate mount here):

The back of the main PCB (reset switch and hotswap sockets mount here):

Have no-clean flux and fine tweezers on hand before you start. Surface-mount work is far easier with flux, and every SMD part is placed with tweezers.
1. Prepare the Controllerâ

The controller is socketed onto the PCB with two Conthrough spring-pin headers so it can be removed later. Solder the two headers to the controller with the end whose holes sit closer to the pins inserted into the controller.
Before soldering, flash the controller while it's still easy to handle:
Controllers aren't included with our kits, so the firmware you need depends on the Pro Micro-compatible controller you chose when ordering (or sourced yourself). Download the Reviung 41 firmware for your controller from the firmware page, then flash it:
| Your controller | Firmware page tab | File | How to flash |
|---|---|---|---|
| Helios or SVLinky (RP2040) | Helios / Svlinky | .uf2 | Double-tap the reset button (or hold BOOT while plugging in). A drive called RPI-RP2 appears; drag the .uf2 onto it. |
| StemCell (STM32) | StemCell | .uf2 | Double-tap the reset button. A drive appears; drag the .uf2 onto it. Check the StemCell page for any jumpers your board needs. |
| Classic Pro Micro (ATmega32U4) | Pro Micro | .hex | Open the .hex in QMK Toolbox, tick Auto-Flash, then briefly short RST to GND (or press reset) to start flashing. |
Each controller has two firmware options:
- Default: standard QMK firmware with the keymap built in.
- VIAL: the same firmware, plus live key remapping in Vial without rebuilding anything.
Flash your controller before soldering it to the PCB, while it's still easy to handle. If it shows up as a drive (or flashes successfully in QMK Toolbox), it's working. If it doesn't, see Entering the Bootloader.
If your controller has a Micro-USB connector (like a classic Pro Micro), reinforce it with a little glue before you start. Micro-USB ports are prone to tearing off with repeated use.
2. Solder the Reset Switchâ

Solder the tactile reset switch to the back of the PCB, in the position
marked RESET.
3. Install the LEDsâ

Install the 11 x WS2812B LEDs (10 rear-facing for underglow, 1 front-facing as an accent). Work through them in order and test each LED before moving on â the LEDs are wired in a chain, so one bad joint stops every LED after it from lighting.

LEDs are orientation-sensitive. Align the notched (cut) corner of the LED with the marking on the PCB, and make sure the data-in arrow points the right way.
Use a temperature-controlled iron around 300°C. Apply flux, pre-tin one pad, seat the LED with tweezers and tack it in place, then solder the remaining pads. Clean the flux and test before continuing to the next LED.
4. Install the Diodesâ

Install the 41 x 1N4148 SMD diodes.
Diodes are orientation-sensitive. The | mark on the diode must line up with
the | side of the âˇ| marking on the PCB.

Apply flux to both pads, pre-tin one pad, place the diode with tweezers and re-flow to tack it down, then solder the opposite pad.
5. Install the Switch Socketsâ

Solder the 41 x hotswap sockets to the back of the PCB.
The sockets fit only one way round. Make sure the open mouth of each socket faces outward and doesn't block the central switch hole.
Apply flux, heat the pad and socket together, feed a little solder into each of the two terminals, and hold the socket flat with tweezers as you remove the iron so it doesn't lift.
6. Attach the Diffuserâ

Attach the acrylic diffuser to the main PCB with double-sided tape, textured side facing up. Line it up with the guide marks on the PCB. This is what spreads the underglow into an even wash of light.
7. Mount the Stabiliserâ

Fit the 2u stabiliser to the front of the PCB for the thumb-cluster space key, with the wire shaft facing up. Check from the side and rear that the clips are fully engaged.
8. Attach the Pro Micro Protection Coverâ

Attach the acrylic Pro Micro protection cover to the top plate using the spacers and screws. Peel the protective film off the acrylic parts first.
Do not overtighten the screws â acrylic parts can crack. Snug is enough.
9. Assemble the Platesâ
Build up the case from the bottom, fixing the metal spacers to the bottom plate, seating the main PCB, then the top plate, and tightening the screws down from the top-plate side.



If you added the optional middle acrylic plates and silicone sheet, layer them in the same order as the Reviung 39 Mk-II: lower middle plate under the PCB, then upper middle plate and silicone sheet above it under the top plate.
Finally, stick the rubber feet to the five outer positions and the space-key position on the bottom plate.
10. Install the Switchesâ

Push your 41 MX switches down through the top plate and into the hotswap sockets below. Check that each switch's pins are straight before pressing it home â a bent pin will fold under the switch instead of entering the socket.
5-pin (plate-mount) switches may need a firm, even push to seat fully.
11. Install the Keycapsâ

Fit your keycaps and you're all done! The thumb row uses a 2.25U spacebar with 1.25U keys either side (or 1U variants, depending on your keycap set).
