storm/thunderpad
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated Claud's instruction file.

Browse Source
This commit is contained in:
Storm Dragon
2025-06-30 15:55:05 -04:00
parent 0b6f76a2b2
commit ae0f9c16a8
1 changed files with 9 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
CLAUDE.md
View File

@ -10,7 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
- **Full keyboard navigation** - No mouse required for any configuration task - **Full keyboard navigation** - No mouse required for any configuration task
- **Screen reader compatible** - Works seamlessly with Orca and other assistive technologies - **Screen reader compatible** - Works seamlessly with Orca and other assistive technologies
- **Window mode by default** - Opens configuration window directly (use `--tray` for system tray) - **Window mode by default** - Opens configuration window directly (use `--tray` for system tray)
- **English-only interface** - Translation system removed for simplicity and better screen reader performance - **English-only interface** - Translation system removed for simplicity
- **Separate config directory** - Uses `~/.config/thunderpad/` to coexist with QJoyPad - **Separate config directory** - Uses `~/.config/thunderpad/` to coexist with QJoyPad
## Critical Development Principle ## Critical Development Principle
@ -52,7 +52,7 @@ cmake .. -DCMAKE_BUILD_TYPE=Debug
- Qt5Widgets, Qt5X11Extras - Qt5Widgets, Qt5X11Extras
- libudev (optional, for automatic device detection) - libudev (optional, for automatic device detection)
- Linux joystick driver support - Linux joystick driver support
- For accessibility testing: Orca screen reader - For accessibility testing: Orca screen reader or Cthulhu screen reader
## Code Architecture ## Code Architecture
@ -135,19 +135,19 @@ All source code has been systematically updated:
```bash ```bash
# Build and run locally (default: window mode) # Build and run locally (default: window mode)
make make
./thunderpad DISPLAY=:0 ./thunderpad
# Test with system tray mode # Test with system tray mode
./thunderpad --tray DISPLAY=:0 ./thunderpad --tray
# Test with specific layout # Test with specific layout
./thunderpad "layout-name" DISPLAY=:0 ./thunderpad "layout-name"
# Update device list in running instance # Update device list in running instance
./thunderpad --update DISPLAY=:0 ./thunderpad --update
# Test accessibility with screen reader # Test accessibility with screen reader
# Start Orca first, then launch thunderpad # Start Orca or Cthulhu first, then launch thunderpad
``` ```
### Accessibility Testing Requirements ### Accessibility Testing Requirements
@ -160,7 +160,7 @@ make
- Ensure Escape key behavior is consistent - Ensure Escape key behavior is consistent
2. **Screen Reader Test**: 2. **Screen Reader Test**:
- Launch with Orca running - Launch with Orca or Cthulhu running
- Verify all interface elements are announced properly - Verify all interface elements are announced properly
- Check that focus changes are announced - Check that focus changes are announced
- Ensure list items have descriptive labels - Ensure list items have descriptive labels
@ -191,7 +191,6 @@ make
5. **Keyboard-only operation**: Every function accessible via keyboard 5. **Keyboard-only operation**: Every function accessible via keyboard
### Removed Features (For Accessibility) ### Removed Features (For Accessibility)
- **Translation system**: English-only interface reduces complexity
- **FlashRadioArray widgets**: Replaced with standard Qt accessible widgets - **FlashRadioArray widgets**: Replaced with standard Qt accessible widgets
- **Click-to-configure interfaces**: Replaced with explicit configure buttons - **Click-to-configure interfaces**: Replaced with explicit configure buttons
- **System tray requirement**: Optional with `--tray` flag - **System tray requirement**: Optional with `--tray` flag
@ -255,7 +254,6 @@ src/
- **Interface redesign**: Complete overhaul for keyboard navigation - **Interface redesign**: Complete overhaul for keyboard navigation
- **Widget replacement**: Accessible alternatives to custom widgets - **Widget replacement**: Accessible alternatives to custom widgets
- **Default behavior**: Window mode instead of system tray - **Default behavior**: Window mode instead of system tray
- **Translation removal**: English-only for screen reader performance
- **Focus management**: Explicit tab order and focus policies - **Focus management**: Explicit tab order and focus policies
### Development Impact ### Development Impact