Most hobbyists who assemble a custom mechanical keyboard treat the process like a weekend project. They solder, screw, and flash firmware, then close the case and move on. A month later, when a switch starts acting up or the stabilizer rattles, they have no idea what they did. The screw size, the lube type, the foam layer they added or removed, all of it is gone. I hit this wall twice before I started writing things down. Now I keep every detail of every build in a set of notes, and I check them before I touch a screwdriver. It sounds like busywork, but it has saved me hours of rework and more than a few dollars. I even keep my current project log public at cyoest build notes just so I can look back at my own mistakes without guessing.

The habit started when I swapped my third set of switches. I had used a particular lube on the springs, but I forgot which one. The result was a mushy feel that took me two evenings to fix, and I had to disassemble the whole board to get it right. That was the moment I realized that the only difference between a smooth rebuild and a frustrating one was a piece of paper or a text file. So I created a simple template. It takes five minutes to fill out, and it sits next to my soldering station. Since then, I have built four boards and modified two more, and each time the notes have paid for themselves.

What to Record When You Build

You do not need a fancy spreadsheet or a dedicated app. A plain text file works. The key is to capture the decisions that you cannot see after the case is closed. Here is what I put down for every board:

• Exact switch model and batch number, because two batches of the same switch can feel different.
• Lube type and where I applied it: springs, stems, or housings, and the thickness ratio if I mixed it.
• Screw sizes and lengths for each mounting point, plus the torque if you use a driver with a setting.
• Stabilizer mods: clipped, band-aided, or holee modded, and which brands I used.
• Foam or gasket placement, including the thickness and material, since a half-millimeter change alters acoustics.
• Firmware version and keymap settings, especially if you remap a layer or change the actuation point.

That list looks minor, but consider this: I once spent forty minutes hunting for a screw that had rolled under my desk. My notes told me the screw was M2.5 by 5mm, so I had a spare in a parts box. Without that note, I would have been at the hardware store.

How Notes Pay Off Later

The real return comes when you sell a board or hand it to a friend. I sold a custom 65% last year, and the buyer asked about the stabilizers. I pulled up my notes, told him exactly what was done, and he did not hesitate. That deal closed in an afternoon. Compare that to the three other boards I sold before I kept notes, which all came with questions I could not answer. Buyers are not looking for a mystery box. They want to know what they are getting.

There is also the simple fact that your memory lies. I thought I had used a 78g spring in a recent build, but my notes said 62g. I checked the bag of leftover springs, and sure enough, the 78g batch was still unopened. That error would have made the board feel like a brick, and I would have blamed the switches instead of my own forgetfulness. Writing it down keeps the blame where it belongs.

“A build without notes is a build you will do twice. Once for the assembly, once for the troubleshooting.”

The best part is that this habit does not slow you down. After the first two builds, filling out the template becomes part of the rhythm. You finish a step, you type a line. It is like saving a game before a boss fight. And when a new switch or a new plate comes out, you can compare the feel of your old builds with actual numbers instead of vague memories. That is how you learn what you actually like, not what the marketing says you should like.

So if you have a box of parts waiting for your next project, start a note file. Write down the date, the case, the PCB, and the first screw you turn. You will thank yourself later, and you may even find that the notes become a part of the hobby itself.