# How do I build a mechanical keyboard?

**Building a custom mechanical keyboard with Modo takes 3-5 hours.** Here's the complete process:

## Step 1: Generate Your Design (5 minutes)

Tell Modo what you want:

> "A 60% mechanical keyboard with hot-swap sockets, USB-C, and per-key RGB"

Modo generates:

- Parts list with switches, controller, LEDs
- 3D printable case files
- Wiring diagram
- QMK firmware
- Assembly instructions

## Step 2: Order Parts (~$60-100)

**Core Components:**

- Microcontroller (Pro Micro or RP2040): $8-15
- Hot-swap sockets (Kailh or Mill-Max): $15-25
- Diodes (1N4148): $3-5
- USB-C breakout: $3-5
- Stabilizers: $10-15

**Optional:**

- RGB LEDs (WS2812B): $10-15
- OLED display: $5-10

**You'll Also Need:**

- Switches (your choice): $20-40
- Keycaps: $15-50

Parts arrive in 2-5 days from DigiKey.

## Step 3: 3D Print Case (6-10 hours)

- Download STL files
- Print case bottom (4-6 hours)
- Print case top/plate (3-5 hours)
- Use PLA or PETG filament

## Step 4: Build the Keyboard (2-3 hours)

1. **Install hot-swap sockets** on PCB or plate
2. **Solder diodes** (if not using integrated PCB)
3. **Wire the matrix** following the diagram
4. **Connect USB** to microcontroller
5. **Test with multimeter** before powering

## Step 5: Flash Firmware (15 minutes)

- Compile QMK firmware
- Flash using QMK Toolbox
- Test every key

## Step 6: Final Assembly (30 minutes)

- Insert switches into hot-swap sockets
- Add keycaps
- Attach case halves
- Done!

## Tips for First-Time Builders:

✅ Start with a hot-swap design (no soldering switches)
✅ Test the matrix before closing the case
✅ Use a switch opener for bad switches
✅ Consider a smaller layout (60%) for first build

## Cost Summary:

| Item            | Cost      |
|-----------------|-----------|
| Electronics     | $40-60   |
| Switches        | $20-40   |
| Keycaps         | $15-50   |
| 3D printing     | $5-15    |
| **Total**       | **$80-165** |

Compare to pre-built custom: $200-400

## Related Projects

[**Custom 60% Mechanical Keyboard** \ Generate complete build specs in minutes\ Intermediate$80-120](/content/projects/custom-mechanical-keyboard/index.html)
