Skip to content

Home

Jump to bottom
Vincent Franco edited this page Jun 29, 2026 · 1 revision

Welcome to the Crosses/Bridges V2 Wiki

This wiki covers everything you need to build and customize your Crosses/Bridges V2 split keyboard, powered by ZMK firmware.

Need help? Join the Discord!

Getting Started

1. Build Your Keyboard

New to the build? Follow these guides in order:

  1. Soldering Guide — solder a few connectors, and hotswap sockets
  2. Final Assembly Guide — install heat-set inserts, route cables, and close up the case

2. Flash the Firmware

For the default experience with ZMK Studio support, you will need to flash the firmware to both halves of the keyboard. To proceed, you will need a:

  • USB-C cable
  • Computer
  • The .uf2 files for your Crosses/Bridges V2 variant

Find the latest release for pre-built firmware on the releases page.

  1. Plug in the right side of the keyboard into your computer via USB.
  2. Double-tap the reset button to enter bootloader mode. A storage drive named CROSSES_V2 should appear.
  3. Drag and drop crosses_v2_<size>_right.uf2 onto the root of the CROSSES_V2 drive.
  4. Once the copying has completed, the CROSSES_V2drive will disconnect. The keyboard half will reboot automatically (sometimes with a benign error).
  5. Repeat steps 1–4 for the left side of the keyboard. using the corresponding .uf2 file.

Caution

Flash the correct .uf2 file to each side—they are not interchangeable.

3. Connect Your Keyboard

Now that your keyboard is assembled and flashed, it's time to connect it to your computer. The right side of the keyboard is the primary (listener) side and is how the left side of the keyboard communicates with your computer - a direct connection to only the left side is not supported.

Wired Connection

  1. Connect the right side of the keyboard to your computer using a USB cable.
  2. Flip the power switch on the left side of the keyboard to power on the keyboard. The left side should automatically be detected by the right side.
  3. Start typing!

Bluetooth Connection

  1. Flip both power switches on both sides of the keyboard to power on the keyboard. Bluetooth should automatically be enabled.
  2. On your computer, open your Bluetooth management and add a new device.
  3. Connect to the Crosses V2 device that appears.
  4. Start typing!

Tip

You're able to connect to multiple Bluetooth devices. The default firmware has Bluetooth device selection in the lower layer.

Customizing Your Keymap

Option A: ZMK Studio (Easiest)

ZMK Studio lets you remap keys in real-time without reflashing—perfect for quick tweaks and experimentation. The pre-built firmware is already ZMK Studio compatible.

Platform How to Connect
Web app USB only (Chrome or Edge)
Desktop app USB or Bluetooth (Linux, macOS, Windows)

Option B: Custom Firmware (Advanced)

For deeper customization — combos, macros, behaviors, and more - set up your computer to use the ZMK CLI and GitHub Actions to build your own custom firmware! Follow the ZMK User Setup Guide to set up your computer and use the appropriate firmware template for your Crosses/Bridges V2 variant in the ZMK CLI instructions to get started.

Build Process

  1. Click Use this template on the appropriate repository to create your own copy.
  2. Edit config/crosses.keymap. Refer to the ZMK keymap documentation or use the visual keymap editor.
  3. Commit and push your changes—GitHub Actions builds the firmware automatically.
  4. Go to the Actions tab, select the latest workflow run, and download the firmware artifact.
  5. Flash the new .uf2 files using the steps above.

Reference

Firmware Templates

Model Template Repository
36 Key crosses-v2-36-zmk-template
42 Key crosses-v2-42-zmk-template
54 Key crosses-v2-54-zmk-template

Clone this wiki locally