Build or buy a full assembly of custom keyboard

Instructions for configuring firmware on wireless keyboards using ZMK.dev The instructions are based on ErgoDash, but select your keyboard from the list. Guide Source: ZMK Docs. In this guide is used the ErgoDash split keyboard as an example. • Nice!Nano Documentation: https://tiny.pl/3mt_q75f • ZMK.dev Documentation • Nice!Nano Discord community: https://tiny.pl/h-ky15zx • ZMK Discord community: https://tiny.pl/z7bgk7yc

Prerequisites: • Windows machine / terminal • GitHub account: https://github.com/ • Locally configured git to access your GitHub account • QMK MSYS: https://msys.qmk.fm/ • Installed and configured the • 2x nice!nano controllers git version control tool

1. Create a new public or private GitHub repo. For example name: zmk-config-ergodash-w. (Do not check any of the options to initialize the repository with a README or other files)

2. Create a github passkey (https://github.com/settings/tokens) token and save it. We will need it later. It will look like "ghp_Q927asd8970asdjh2g3jh12354kjh12Kjhg3"

3. After configuring locally your GitHub account and made sure it is accessible – Open QMK MSYS and paste the command line: code: bash -c "$(curl -fsSL https://zmk.dev/setup.sh)"

4. Choose your shield (keyboard). In this example it will be a firmware for the Ergodash which corresponds the number 24) Ergodash.

5. Select the controller you want to create the firmware. In this guide it is used Nice!Nano v2. Number 10).

6. Copy in the stock keymap for customization? [Yn]: y 7. Github Username (leave empty to skip github repo creation): ‘press enter’ 8. GitHub Repo Name [zmk-config]: zmk-config-ergodash-w 9. GitHub Repo [https://github.com/falbatech/zmk-config-ergodash-w.git]: ‘press enter’ 10. Preparing a user config for: • MCU Board: nice_nano_v2 • Shield(s): cradio_left cradio_right • Copy Keymap?: ✓ • GitHub Repo To Push (please create this in GH first!): https://github.com/falbatech/zmk-config-ergodash-w.git Continue? [Yn]: y

11. Username for ‘https://github.com’: ‘enter your github username’ 12. Password for ‘https://yourGHUsername@github.com’: ‘do not enter your GH password, but enter your github passkey you created on step 2′ 13. Your firmware should be available from GitHub Actions shortly: https://github.com/ yourGHUsername/zmk-config-ergodash-w/actions 14. Go to your GitHub repo at Actions https://github.com/yourGHUsername/zmk-config-ergodash-w/actions and click the top build from the list: Initial User Config.

16. Connect Nice!Nano to the PC with a reliable cable. Normally, if it’s the first time being connected it will open automatically the folder and appear in your OS as a new USB storage device. If it is not the first time or for some reason doesn’t appear as a storage device, then short with metallic tweezers 2x the pins GND and RST on the controller. It should appear as a new USB storage device now. Copy and paste the respective controller the uf2 file. For the nice!nano on the left keyboard half copy/paste the keyboard_left_nice_nano_v2-zmk.uf2 file, for the right – keyboard_right_nice_nano_v2-zmk.uf2 file. After pasting the folder will automatically close, the storage device disappear and in the Bluetooth & other devices you’ll see the keyboard’s name, if everything was executed successfully