Move module to own repository (#18)

* refactor: move corax keyboard module to own repository

* feat: update readme to mention that this is only a configuration
This commit is contained in:
Daniel Bauer
2025-05-25 16:55:21 +02:00
committed by GitHub
parent 998f29ceb6
commit d2e6054d72
12 changed files with 237 additions and 501 deletions

View File

@@ -1,16 +1,48 @@
[![.github/workflows/build.yaml](https://github.com/dnlbauer/corax-zmk-config/actions/workflows/build.yaml/badge.svg)](https://github.com/dnlbauer/corax-zmk-config/actions/workflows/build.yaml)
# Firmware for the Corax keyboard
# Firmware configuration for the Corax keyboard
This is the [ZMK](https://zmk.dev/) firmware for the [Corax](https://github.com/dnlbauer/corax-keyboard).
This is my personal [ZMK](https://zmk.dev/) firmware configuration for the [Corax](https://github.com/dnlbauer/corax-keyboard).
Keymap optimised for US international.
The keymap optimised for US international.
## Using this Config as a template
You can use this configuration on your own Corax keyboard
or use it as a base to create your own configuration with a custom
keymap:
1. Fork this repository
2. Make sure the `config/west.yaml` contains a reference to the [zmk-keyboards-corax](https://github.com/dnlbauer/zmk-keyboards-corax) module
```yaml
manifest:
remotes:
- name: zmkfirmware
url-base: https://github.com/zmkfirmware
- name: dnlbauer
url-base: https://github.com/dnlbauer
projects:
- name: zmk
import: app/west.yml
remote: zmkfirmware
revision: main
- name: zmk-keyboards-corax
remote: dnlbauer
revision: main
self:
path: config
```
3. Customize the keymap in `config/corax.keymap`
4. Commit and push. Github Actions will build the firmware for you
5. Download the firmware artifact and copy it onto your keyboard (see [zmk user setup](https://zmk.dev/docs/user-setup)).
## Corax56 vs Corax54
The Corax56 and Corax54 use the same shield.
The hardware of both keyboards is identical except the Corax54 is missing one key.
Therefore, you can use this ZMK config for both keyboards.
The hardware of both keyboards is identical except the Corax54 is missing one hardware key.
Therefore, you can use the same ZMK firmware for both versions of the corax.
If you have a Corax54, just set the outer pinky key to `&none`
(basically, you can set it to whatever you want. It will be ignored).