My ultimate Corne keymap

Latest firmware: firmware.uf2

Build

Initialize the pinned QMK submodule after cloning:

git submodule update --init --recursive

Build with Podman (the default):

./build.sh

Use Docker explicitly when needed:

./build.sh --runtime docker

The result is written to firmware.uf2. The build uses the Corne v4.1 mini target crkbd/rev4_1/mini and the QMK commit and container image pinned by this repository.

Formatting

The repository uses clang-format 23.1.2, managed by mise:

mise install
mise run format

CI runs mise run format and fails if it leaves any formatting diff.

Run the dependency-free smoke tests with:

./tests/test_build.sh

Enter bootloader mode and use:

./deploy_uf2.sh

Updating QMK

QMK is tracked as a submodule. Update it deliberately, build with both Podman and Docker, and verify the GitHub Actions build before committing the new submodule pointer. Keep the container image digest in build.conf fixed as well.

Actions

gh run download -n firmware
gh run list
gh run watch