Wesk

WESK — Wireless Ergonomic Splitted Keyboard

A fully custom, open-source wireless split keyboard built from scratch — custom PCB, hand-picked components, 3D-printed case, and a bespoke AZERTY layout.

[screenshot — hero photo of both halves side by side]

Table of Contents

• Overview
• Features
• Layout
• Bill of Materials
• PCB
• 3D-Printed Case
• Build Guide
• Firmware (ZMK)
• Repository Structure
• License

Overview

WESK (Wireless Ergonomic Splitted Keyboard) is a handcrafted 56-key wireless split keyboard designed for ergonomics and daily productivity. Every part of it was chosen or made intentionally: the PCB was designed in KiCad and manufactured at JLCPCB, the case is 3D-printed in PETG, and the firmware runs on ZMK. Both halves communicate over Bluetooth and are completely cable-free during use.

[screenshot — both halves on a desk, keycaps on]

Features

• 56 keys — 28 per half, fully symmetric split layout
• Wireless — Bluetooth via ZMK, no cable between halves
• Low-profile — Kailh Choc v2 Red switches + NuPhy COAST Twilight keycaps
• Custom PCB — designed in KiCad, manufactured by JLCPCB
• 1 rotary encoder per half — for volume, scroll, or any mapped action
• 500 mAh LiPo battery per half — integrated into the 3D-printed case
• PETG case — fully 3D-printed, designed to house all components
• Custom AZERTY layout — tailored key positions and layers

Layout

The layout is a custom AZERTY split, inspired by ergonomic principles (staggered columns, thumb cluster). Each half has 28 keys + 1 rotary encoder.

Left Half — Base Layer

[screenshot — your layout diagram, left half]

Right Half — Base Layer

[screenshot — your layout diagram, right half]

Additional Layers

WESK uses multiple ZMK layers accessible via the FN, OPT, and CMD thumb keys:

[screenshot — layer map / ZMK keymap diagram]

Bill of Materials

Per Half (× 2 for full keyboard)

Note: Order PCBs in batches of 5 (JLCPCB minimum). The Gerber files are in the GRB/ folder.

PCB

The PCB was designed in KiCad and ordered from JLCPCB.

[screenshot — KiCad PCB layout top view] [screenshot — KiCad schematic] [screenshot — received PCBs from JLCPCB]

Key design choices

• Matrix wiring — standard row/column matrix with SOD-123 diodes for n-key rollover
• Choc v2 footprints — low-profile switch footprints with proper spacing
• Rotary encoder footprint — EC11 compatible, placed at thumb cluster corner
• Battery connector — JST PH 2.0 connector for the LiPo
• Power switch footprint — MSK-12C02 slide switch inline on the battery positive rail

Ordering from JLCPCB

1. Export Gerbers from KiCad: File → Fabrication Outputs → Gerbers
2. Zip the GRB/ folder
3. Upload to jlcpcb.com
4. Recommended settings:
   • Layers: 2
   • PCB thickness: 1.6 mm
   • Surface finish: HASL (lead-free)
   • Color: your choice

3D-Printed Case

The case is designed to snugly fit the PCB, microcontroller, battery, and power switch. It consists of a bottom shell and a top plate per half.

[screenshot — CAD render or photo of printed case, top view] [screenshot — case bottom showing battery compartment]

Print settings (recommended)

PETG is recommended for its durability and slight flex — avoid PLA for keyboard cases as it can crack under screw pressure.

Assembly

• The battery sits in a recessed pocket in the bottom shell
• M2 heat-set inserts are pressed into the bottom shell pillars
• The PCB sits on top of the standoffs and is secured with M2 screws
• The top plate snaps or screws over the PCB

[screenshot — exploded view or assembly photo]

Build Guide

Follow these steps for one half. Repeat identically for the second half.

Step 1 — Prepare your PCB

1. Inspect the PCB for any manufacturing defects
2. Clean with isopropyl alcohol if needed

[screenshot — bare PCB]

Step 2 — Solder the diodes

1. Orient all SOD-123 diodes correctly — the cathode line must match the PCB silkscreen
2. Solder all 28 diodes using a fine-tip iron and no-clean flux

[screenshot — diodes soldered, close-up]

Step 3 — Solder the rotary encoder

1. Place the EC11 encoder in its footprint
2. Solder the 5 pins; the mechanical legs can be soldered or clipped flush

[screenshot — encoder soldered]

Step 4 — Solder the power switch

1. Place the MSK-12C02 switch in its footprint
2. Solder carefully — pads are small

Step 5 — Flash and test the microcontroller

1. Flash ZMK firmware to the Nice!Nano clone before soldering it in (easier to re-flash)
2. See the Firmware section for instructions
3. Test USB connection and BLE pairing

Step 6 — Solder the microcontroller

1. Use low-profile machine pin sockets if you want the MCU to be removable (recommended)
2. Solder the sockets to the PCB, then seat the MCU

[screenshot — MCU seated on PCB]

Step 7 — Connect the battery

1. Solder or plug the JST connector from the LiPo battery
2. Double-check polarity before connecting — reversed polarity will destroy the MCU

Step 8 — Install switches

1. Snap the Kailh Choc v2 switches into the PCB from the top
2. Solder all 28 switch pins on the bottom

[screenshot — switches installed]

Step 9 — Install keycaps

1. Press the NuPhy COAST Twilight keycaps onto the switches

[screenshot — keycaps installed, half complete]

Step 10 — Assemble the case

1. Press M2 heat-set inserts into the bottom shell with a soldering iron
2. Place the battery into the battery pocket
3. Lower the PCB assembly onto the standoffs
4. Secure with M2 screws
5. Route cables neatly and close the case

[screenshot — finished half, side view]

Firmware (ZMK)

WESK runs ZMK Firmware — open-source, BLE-native, and designed for wireless split keyboards.

Prerequisites

• Install the ZMK development environment
• Or use ZMK's GitHub Actions build (no local toolchain needed)

Repository structure (ZMK)

Sources/
└── config/
    ├── wesk.keymap       # Key bindings and layers
    ├── wesk.conf         # Bluetooth, battery, sleep settings
    └── west.yml          # ZMK module dependencies

Building the firmware

Using GitHub Actions (recommended):

1. Fork the ZMK repo and add your config files
2. Push — GitHub Actions builds the .uf2 files automatically
3. Download the artifacts from the Actions tab

Flashing

1. Put the Nice!Nano clone into bootloader mode: double-tap the reset button
2. It appears as a USB drive (NICENANO)
3. Drag and drop the .uf2 file onto the drive
4. Repeat for the second half with the right-side firmware

Bluetooth pairing

• The left half is the central and connects to your computer
• The right half connects to the left half
• Hold the Bluetooth profile key to switch between up to 5 paired devices

[screenshot — ZMK keymap editor or keymap diagram]

Repository Structure

Wesk/
├── GRB/                  # Gerber files for PCB manufacturing (JLCPCB)
├── Sources/              # ZMK firmware config files
├── Wesk.kicad_pcb        # KiCad PCB layout
├── Wesk.kicad_sch        # KiCad schematic
├── Wesk.kicad_pro        # KiCad project file
├── PCB.step              # 3D STEP export of the PCB
├── .step                 # 3D STEP file (case or assembly)
├── LOGO.kicad_mod        # Custom logo footprint
├── LOGO.kicad_sym        # Custom logo symbol
├── DRC.rpt               # KiCad Design Rule Check report
└── README.md

License

This project is open-source. Hardware design files (KiCad, Gerbers, STEP) and firmware configuration are released under the MIT License.

Feel free to build your own WESK, modify the design, and share your builds!

Built with ❤️ and too much solder.