README.md

ZSA Moonlander layout, builds with the ZSA QMK fork:

• https://github.com/zsa/qmk_firmware/

Initial layout version:

• https://configure.zsa.io/moonlander/layouts/jXKZa/mDJvX/0

Build

• Clone the QMK fork above, and set branch to firmware21 if it is not the default branch
• Follow the installation instructions given here:
  • https://docs.qmk.fm/
  • https://docs.qmk.fm/#/newbs_getting_started?id=set-up-your-environment
• Make a link or copy the keymap from this repo to the corresponding directory in the qmk_firmware cloned above.
  • E.g. to keyboards/moonlander/keymaps/sroccaserra
• From the root of the qmk_firmware directory, make moonlander:sroccaserra to build the firmware.
• make moonlander:sroccaserra:flash to flash the firmware.

Example (check docs above):

$ git clone git@github.com:zsa/qmk_firmware.git
$ git submodule init
$ git submodule update
$ ln -s ~/Developer/github/keyboard/moonlander/keymaps/sroccaserra keyboards/moonlander/keymaps/
$ make moonlander:sroccaserra:flash

Git submodule problems

I have had to qmk doctor (see cli scripts)

Combos

• https://docs.qmk.fm/#/keycodes
• https://github.com/qmk/qmk_firmware/blob/master/docs/feature_combo.md
• qmk/qmk_firmware#8591
• https://blog.gboards.ca/2020/02/adventures-in-obscure-c-features-2020.html

Colors

• RGB Matrix Lighting ~ https://github.com/qmk/qmk_firmware/blob/master/docs/feature_rgb_matrix.md
• RGB Lighting ~ https://github.com/qmk/qmk_firmware/blob/master/docs/feature_rgblight.md

Tap Dance

• https://docs.qmk.fm/#/feature_tap_dance?id=example-5