$ show rafaelromao/keyboards
This repository is a personal keyboard firmware configuration and build system for multiple ergonomic split keyboards (ZMK-based wireless and QMK-based wired). It provides a unified 36-key layout with advanced features including smart layers (caps word, num word, sentence case), adaptive keys (repeat/alternate), Vim mode with host sync, OS detection, MEHS layer for IDE shortcuts, and Portuguese/English accent support. The architecture consists of ZMK and QMK firmware definitions, build scripts (Containerfile, shell scripts), editor integrations (VSCode, IntelliJ, Neovim), documentation site, and 3D printable models. The codebase demonstrates strong modularity with feature files separated by concern, consistent timing constants across platforms, and reusable patterns for editor keymap installation and diagram generation. While tightly coupled to the author's specific layout, the feature implementations (adaptive keys, smart layers, Vim mode) are self-contained and could be extracted as reusable ZMK modules or QMK userspace features.
The LLM identified 4 files worth highlighting for reuse:
Implements adaptive key behavior (repeat/alternate) with configurable timeout and activation conditions. Demonstrates deep understanding of ZMK's behavior system and can be extracted as a standalone ZMK module for any keyboard project.
Implements smart layers (caps word, num word, sentence case) with a state machine. Reusable as a QMK userspace feature for any layout requiring context-sensitive layer activation.
A shell script that handles backup, symlink creation, and platform detection for installing editor keymaps. Can be reused for any editor configuration deployment with minimal adaptation.
Automates generation of keymap diagrams from YAML definitions using keymap-drawer and Inkscape. Reusable for any keymap project to produce visual layer diagrams.