From 5f015e0f5087a7563ed6fc20c75f18d3886d0005 Mon Sep 17 00:00:00 2001
From: omigamedev <omarator@gmail.com>
Date: Fri, 16 Jan 2026 12:50:38 +0100
Subject: [PATCH] update docs

---
 CLAUDE.md | 119 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index a0ce3b6..43c5a46 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -275,3 +275,122 @@ Back buttons use `app-bar-nav` class for automated GoHome:
     <img src="../../icons/back.tga"/>
 </div>
 ```
+
+## Material Design Resources
+
+Material Design icons and components are available in the MosisDesigner repository:
+
+### Material Design Icons
+
+**Location**: `D:\Dev\Mosis\MosisDesigner\material-design-icons`
+
+A comprehensive icon library from Google with 2000+ icons across 20 categories:
+
+| Category | Examples |
+|----------|----------|
+| action | home, search, settings, delete, info |
+| alert | error, warning, notification |
+| av | play, pause, volume, mic |
+| communication | phone, message, email, contacts |
+| content | add, remove, copy, paste |
+| device | battery, wifi, bluetooth, gps |
+| editor | format, text, color, brush |
+| file | folder, attachment, download, upload |
+| hardware | keyboard, mouse, phone, tablet |
+| home | lightbulb, thermostat, security |
+| image | camera, photo, filter, tune |
+| maps | location, directions, navigation |
+| navigation | arrow, chevron, menu, close |
+| notification | sync, update, event |
+| places | hotel, restaurant, airport |
+| search | search variants |
+| social | share, person, group, notifications |
+| toggle | star, checkbox, radio |
+
+**Available Formats**:
+- `src/` - SVG source files organized by category
+- `png/` - PNG files at multiple DPIs (24dp, 36dp, 48dp)
+- `font/` - Icon fonts (WOFF, TTF)
+- `symbols/` - Material Symbols variable font (newer)
+- `variablefont/` - Variable font files
+
+**Icon Styles**:
+- Outlined (default)
+- Filled
+- Rounded
+- Sharp
+- Two-tone (Material Icons only)
+
+### Material Design Lite
+
+**Location**: `D:\Dev\Mosis\MosisDesigner\material-design-lite`
+
+CSS/JS component library implementing Material Design (reference implementation):
+
+| Directory | Contents |
+|-----------|----------|
+| `src/` | SASS source for components |
+| `docs/` | Component documentation |
+| `templates/` | Page templates |
+
+**Key Components** (for design reference):
+- Buttons (raised, flat, FAB)
+- Cards
+- Dialogs
+- Lists
+- Menus
+- Navigation drawers
+- Progress indicators
+- Sliders
+- Snackbars
+- Tables
+- Tabs
+- Text fields
+- Tooltips
+
+### Using Icons in Mosis
+
+1. **Find icon** at https://fonts.google.com/icons
+2. **Export SVG** from `material-design-icons/src/<category>/<name>/`
+3. **Convert to TGA** using image tool (24x24 or 32x32, RGBA)
+4. **Place in** `src/main/assets/icons/`
+5. **Reference in RML**: `<img src="../../icons/<name>.tga"/>`
+
+## Android Device Testing
+
+### Event Injection via ADB
+
+Inject touch events for automated testing:
+
+```bash
+# Click at normalized coordinates (0.0-1.0)
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.5 --ef y 0.5
+
+# Touch down
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "down" --ef x 0.2 --ef y 0.9
+
+# Touch up
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "up" --ef x 0.2 --ef y 0.9
+```
+
+### Dock Element Coordinates (Normalized)
+
+| Element | X | Y |
+|---------|---|---|
+| dock-phone | 0.16 | 0.97 |
+| dock-messages | 0.39 | 0.97 |
+| dock-contacts | 0.61 | 0.97 |
+| dock-browser | 0.84 | 0.97 |
+
+### Reading Logs
+
+```bash
+# Filter for Mosis logs
+adb logcat -s MosisTest ServiceTester RMLUI
+
+# Save to file
+adb logcat -s MosisTest > mosis-log.txt
+```