• Desktop creative workflows, shortcuts, macros, navigation, and media controls.
• Operates wirelessly over Bluetooth or as a wired USB HID device.
• Rechargeable portable product intended for indoor use.
• Initial target: functional prototype with a production-oriented architecture.

• Read 14 mechanical keys with configurable mappings and layers.
• Read rotary direction and encoder push switch.
• Read two analog joystick axes and joystick push switch.
• Allow firmware assignment of the joystick as mouse movement, scrolling/panning, or custom macro input.
• Connect to a computer over Bluetooth HID or either USB-C port.
• Charge and operate from either USB-C port; only one host is expected to be attached at a time.
• Operate from a removable or connected 2100 mAh single-cell Li-ion/LiPo battery.
• Automatically dim lighting and enter low-power sleep for multi-day practical use.

• 14× Kailh Choc low-profile hot-swap switches.
• 1× rotary encoder, preferably with integrated push switch.
• 1× two-axis analog thumb joystick with integrated push-click.
• Individually addressable RGB plus dedicated warm-white illumination at every key.
• Individually addressable RGB plus warm-white perimeter glow.
• Bluetooth Low Energy and USB HID connectivity.
• Two interchangeable USB-C data/charging receptacles.
• Battery charging, power-path operation, battery protection, and state monitoring.

Diagram

• Raytac MDBT50Q-1MV2 nRF52840 module selected for native USB, BLE HID, low sleep current, ADC inputs, ZMK compatibility, integrated antenna, and existing modular certifications.
• Provide SWD pads, reset access, and antenna keepout.

• 14 Kailh Choc hot-swap sockets.
• Diode-isolated key matrix sized to minimize GPIO count and prevent ghosting.
• Final row/column allocation determined during pin planning.

• Quadrature A/B inputs and integrated push-switch input.
• Hardware or firmware debounce support.

• Two ADC channels for X/Y axes and one digital input for push-click.
• Firmware-adjustable center calibration, dead zone, sensitivity, response curve, and mode.
• Power-gating or switched excitation should be considered to reduce idle battery drain.

• Per-key independently controlled RGB source plus separately controlled warm-white source.
• Perimeter independently addressable RGB plus warm-white lighting for edge glow.
• Global current limiting, battery-mode brightness caps, automatic dimming, and hard lighting shutdown during deep sleep.
• SK6812MINIRGBW-NW-P6-A selected as the baseline RGBW pixel. The provisional population is 14 per-key plus 16 perimeter pixels.

• Both receptacles provide USB 2.0 device data and 5 V charging/input capability.
• Only one host is supported at a time.
• Data paths require a two-to-one USB 2.0 switch/multiplexer or equivalent controlled selection; do not directly short the two ports’ D+/D− pairs together.
• Power inputs require reverse-current-safe ORing/power multiplexing so the ports cannot back-feed one another.
• Include USB ESD protection, USB-C CC device resistors/port controller implementation, and appropriate input protection on both connectors.

• Single-cell 2100 mAh Li-ion/LiPo input.
• Charger with power-path/load sharing so the device can operate while charging.
• Battery protection is required, either inside the pack or on the PCB.
• Battery voltage/fuel indication is desirable.
• Charge current must be selected from battery rating and thermal limits; preliminary target should not exceed the pack manufacturer’s recommendation.

• Target: several days between charges under typical intermittent desktop use.
• Lighting automatically dims after inactivity and turns off before deep sleep.
• BLE remains the preferred battery connection; USB operation may allow higher brightness.
• User-configurable brightness should be capped in battery mode to avoid excessive peak current.

Diagram

• Low-profile compact PCB, likely 4 layers for RF, USB, power integrity, and dense lighting routing.
• SMT assembly for electronics; user-installed Choc switches via hot-swap sockets.
• Provide test points for USB 5 V, battery, regulated rails, USB D+/D−, reset, and SWD.
• Prefer readily sourced, lifecycle-stable parts and a certified BLE module for prototype revision A.

• ZMK-based firmware direction with custom analog joystick behavior.
• USB and BLE HID keyboard, mouse, and consumer-control reports.
• Configurable keymaps/layers, encoder actions, joystick modes, and lighting profiles.
• Battery level reporting, inactivity timers, LED dimming, deep sleep, and wake from controls.
• Bootloader and firmware update path over USB; optional wireless update considered later.

• Compact square arrangement closely following the reference product’s visual balance.
• 14 keys, encoder, and joystick positioned similarly to the provided reference, without copying proprietary artwork or branding.
• USB-C connectors placed on accessible enclosure edges.
• Battery housed beneath or behind the PCB without violating the BLE antenna keepout.
• Perimeter LEDs should illuminate a diffuser/light pipe or translucent enclosure edge.
• Final dimensions depend on Choc spacing, encoder/joystick mechanics, battery dimensions, and enclosure wall stack-up.

• Kailh Choc low-profile hot-swap switches selected for reduced thickness.
• nRF52840/ZMK direction selected for low-power BLE and native USB.
• Both USB-C ports are equivalent for data and charging, with only one host connected at a time.
• Joystick behavior is firmware assignable.
• RGB and warm-white channels are independently available per key and around the perimeter.
• Battery life takes priority over unrestricted LED brightness.

• The battery is a protected or protectable 1-cell 3.7 V nominal LiPo pack.
• USB Power Delivery is not required; standard 5 V USB-C sink behavior is sufficient.
• The device does not need to bridge or switch live HID sessions between two simultaneous hosts.
• Rotary encoder includes a push switch unless mechanical selection dictates otherwise.
• Final joystick, encoder, keycap, battery, and enclosure geometry will be verified from manufacturer drawings before layout.

• All 14 keys, encoder actions, joystick axes, and push switches enumerate and operate over BLE and either USB-C port.
• Charging and device operation work safely from either port without back-feeding the unused port.
• Device enters low-power sleep and wakes reliably from intended controls.
• Typical use achieves multi-day runtime with automatic lighting management.
• Lighting supports independent per-key RGB/warm-white effects and RGB/warm-white perimeter glow.
• Hot-swap sockets, keycaps, joystick, encoder, battery, and enclosure fit without interference.

• Initial specification created from the August 13, 2026 requirements discussion.
• Core parts, dual-USB architecture, and LED-limited power budget selected and documented on August 13, 2026.