feat: enhance menu theming with comprehensive documentation and testing support

scripts/README.md

@@ -1,6 +1,6 @@
 # TheChart Scripts Directory
 
-This directory contains testing and utility scripts for TheChart application.
+This directory contains interactive demonstrations and utility scripts for TheChart application.
 
 ## Scripts Overview
 
@@ -36,15 +36,62 @@ Tests entry update functionality.
 - Validates data modification operations
 - Tests date validation and duplicate handling
 
-## Usage
+#### `test_keyboard_shortcuts.py`
+Tests keyboard shortcut functionality.
+- Validates keyboard event handling
+- Tests shortcut combinations and responses
 
-All scripts should be run from the project root directory:
+### Interactive Demonstrations
+
+#### `test_menu_theming.py`
+Interactive demonstration of menu theming functionality.
+- Live theme switching demonstration
+- Visual display of theme colors
+- Real-time menu color updates
 
 ```bash
 cd /home/will/Code/thechart
-.venv/bin/python scripts/<script_name>.py
+.venv/bin/python scripts/test_menu_theming.py
 ```
 
+## Usage
+
+All scripts should be run from the project root directory using the virtual environment:
+
+```bash
+cd /home/will/Code/thechart
+source .venv/bin/activate.fish  # For fish shell
+# OR
+source .venv/bin/activate       # For bash/zsh
+
+python scripts/<script_name>.py
+```
+
+## Test Organization
+
+### Unit Tests
+Located in `/tests/` directory:
+- `test_theme_manager.py` - Theme manager functionality tests
+- `test_data_manager.py` - Data management tests
+- `test_ui_manager.py` - UI component tests
+- `test_graph_manager.py` - Graph functionality tests
+- And more...
+
+Run unit tests with:
+```bash
+cd /home/will/Code/thechart
+.venv/bin/python -m pytest tests/
+```
+
+### Integration Tests
+Located in `/scripts/` directory:
+- `integration_test.py` - Export system integration test
+- Feature-specific test scripts
+
+### Interactive Demos
+Located in `/scripts/` directory:
+- `test_menu_theming.py` - Menu theming demonstration
+
 ## Test Data
 
 - Integration tests create temporary export files in `integration_test_exports/` (auto-cleaned)
@@ -59,3 +106,5 @@ When adding new scripts:
 3. Add proper docstrings and error handling
 4. Update this README with script documentation
 5. Follow the project's linting and formatting standards
+6. For unit tests, place them in `/tests/` directory
+7. For integration tests or demos, place them in `/scripts/` directory