DYA Studio

A modern web-based configuration tool for the DYA keyboard — a split, trackball-embedded mechanical keyboard running ZMK firmware.

Features

• 🔋 Battery monitoring for both keyboard halves
• 📶 Bluetooth profile management
• 🩺 Hardware diagnostics
• ⌨️ Keymap editor
• 🎯 Trackball settings (CPI, scroll speed)
• ⚙️ Device settings (power, display, timing)
• 🌙 Dark/Light mode

Quick Start

git clone https://github.com/cormoran/dya-studio.git
cd dya-studio
npm install
npm run dev

Open http://localhost:5173 and connect your keyboard via USB.

Requirements: Node.js 18+, Chromium-based browser (Chrome, Edge)

Development

Stack: React 19, TypeScript, Vite, Tailwind CSS v4, Radix UI

Commands:

npm run dev            # Start dev server
npm run build          # Production build
npm run lint           # Lint code
npm test               # Run tests
npm run test:coverage  # Test coverage

For Coding Agents: See Development Guide for design system, component patterns, and implementation guidelines.

For Testing: See Testing Guide for testing patterns and examples.

Project Structure

src/
├── components/       # UI components
├── pages/            # Feature pages
├── hooks/            # React hooks
├── contexts/         # React contexts
└── layouts/          # Page layouts

Acknowledgments

ZMK Firmware • ZMK Studio • Radix UI • Tabler Icons