diff --git a/Images-GUI/00-user-current-downloads/Generated image 1.png b/Images-GUI/00-user-current-downloads/Generated image 1.png new file mode 100644 index 00000000..72f6a192 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 1.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 2.png b/Images-GUI/00-user-current-downloads/Generated image 2.png new file mode 100644 index 00000000..64ce268c Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 2.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 3.png b/Images-GUI/00-user-current-downloads/Generated image 3.png new file mode 100644 index 00000000..d87c91b4 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 3.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 4.png b/Images-GUI/00-user-current-downloads/Generated image 4.png new file mode 100644 index 00000000..31f895f7 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 4.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 5.png b/Images-GUI/00-user-current-downloads/Generated image 5.png new file mode 100644 index 00000000..91aa889f Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 5.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 6.png b/Images-GUI/00-user-current-downloads/Generated image 6.png new file mode 100644 index 00000000..096ff008 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 6.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 7.png b/Images-GUI/00-user-current-downloads/Generated image 7.png new file mode 100644 index 00000000..93837079 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 7.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 8.png b/Images-GUI/00-user-current-downloads/Generated image 8.png new file mode 100644 index 00000000..4bb667a9 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 8.png differ diff --git a/Images-GUI/00-user-current-downloads/Generated image 9.png b/Images-GUI/00-user-current-downloads/Generated image 9.png new file mode 100644 index 00000000..c4932e41 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Generated image 9.png differ diff --git a/Images-GUI/00-user-current-downloads/Hermes3D.png b/Images-GUI/00-user-current-downloads/Hermes3D.png new file mode 100644 index 00000000..50eb8467 Binary files /dev/null and b/Images-GUI/00-user-current-downloads/Hermes3D.png differ diff --git a/Images-GUI/01-dashboard-modes/advanced-dashboard-a.png b/Images-GUI/01-dashboard-modes/advanced-dashboard-a.png new file mode 100644 index 00000000..d87c91b4 Binary files /dev/null and b/Images-GUI/01-dashboard-modes/advanced-dashboard-a.png differ diff --git a/Images-GUI/01-dashboard-modes/advanced-dashboard-b.png b/Images-GUI/01-dashboard-modes/advanced-dashboard-b.png new file mode 100644 index 00000000..31f895f7 Binary files /dev/null and b/Images-GUI/01-dashboard-modes/advanced-dashboard-b.png differ diff --git a/Images-GUI/01-dashboard-modes/custom-dashboard-a.png b/Images-GUI/01-dashboard-modes/custom-dashboard-a.png new file mode 100644 index 00000000..91aa889f Binary files /dev/null and b/Images-GUI/01-dashboard-modes/custom-dashboard-a.png differ diff --git a/Images-GUI/01-dashboard-modes/custom-dashboard-b.png b/Images-GUI/01-dashboard-modes/custom-dashboard-b.png new file mode 100644 index 00000000..096ff008 Binary files /dev/null and b/Images-GUI/01-dashboard-modes/custom-dashboard-b.png differ diff --git a/Images-GUI/01-dashboard-modes/simple-dashboard-a.png b/Images-GUI/01-dashboard-modes/simple-dashboard-a.png new file mode 100644 index 00000000..72f6a192 Binary files /dev/null and b/Images-GUI/01-dashboard-modes/simple-dashboard-a.png differ diff --git a/Images-GUI/01-dashboard-modes/simple-dashboard-b.png b/Images-GUI/01-dashboard-modes/simple-dashboard-b.png new file mode 100644 index 00000000..64ce268c Binary files /dev/null and b/Images-GUI/01-dashboard-modes/simple-dashboard-b.png differ diff --git a/Images-GUI/02-primary-pages/primary-tabs-artifacts-approvals-plugins-roadmap.png b/Images-GUI/02-primary-pages/primary-tabs-artifacts-approvals-plugins-roadmap.png new file mode 100644 index 00000000..c4932e41 Binary files /dev/null and b/Images-GUI/02-primary-pages/primary-tabs-artifacts-approvals-plugins-roadmap.png differ diff --git a/Images-GUI/02-primary-pages/primary-tabs-autopilot-design-gen3d-jobs.png b/Images-GUI/02-primary-pages/primary-tabs-autopilot-design-gen3d-jobs.png new file mode 100644 index 00000000..93837079 Binary files /dev/null and b/Images-GUI/02-primary-pages/primary-tabs-autopilot-design-gen3d-jobs.png differ diff --git a/Images-GUI/02-primary-pages/primary-tabs-printers-observe-agents-learning.png b/Images-GUI/02-primary-pages/primary-tabs-printers-observe-agents-learning.png new file mode 100644 index 00000000..4bb667a9 Binary files /dev/null and b/Images-GUI/02-primary-pages/primary-tabs-printers-observe-agents-learning.png differ diff --git a/Images-GUI/03-settings-voice/settings-subtabs-all.png b/Images-GUI/03-settings-voice/settings-subtabs-all.png new file mode 100644 index 00000000..880c07a7 Binary files /dev/null and b/Images-GUI/03-settings-voice/settings-subtabs-all.png differ diff --git a/Images-GUI/03-settings-voice/voice-communication-subtabs.png b/Images-GUI/03-settings-voice/voice-communication-subtabs.png new file mode 100644 index 00000000..39b0074a Binary files /dev/null and b/Images-GUI/03-settings-voice/voice-communication-subtabs.png differ diff --git a/Images-GUI/04-source-os/source-os-60-app-coverage-matrix.png b/Images-GUI/04-source-os/source-os-60-app-coverage-matrix.png new file mode 100644 index 00000000..988625b1 Binary files /dev/null and b/Images-GUI/04-source-os/source-os-60-app-coverage-matrix.png differ diff --git a/Images-GUI/04-source-os/source-os-core-categories.png b/Images-GUI/04-source-os/source-os-core-categories.png new file mode 100644 index 00000000..1eece122 Binary files /dev/null and b/Images-GUI/04-source-os/source-os-core-categories.png differ diff --git a/Images-GUI/04-source-os/source-os-remaining-categories.png b/Images-GUI/04-source-os/source-os-remaining-categories.png new file mode 100644 index 00000000..393659c9 Binary files /dev/null and b/Images-GUI/04-source-os/source-os-remaining-categories.png differ diff --git a/Images-GUI/05-action-windows/action-window-advanced-tools.png b/Images-GUI/05-action-windows/action-window-advanced-tools.png new file mode 100644 index 00000000..9d170d17 Binary files /dev/null and b/Images-GUI/05-action-windows/action-window-advanced-tools.png differ diff --git a/Images-GUI/05-action-windows/action-window-core-apps.png b/Images-GUI/05-action-windows/action-window-core-apps.png new file mode 100644 index 00000000..e735e92d Binary files /dev/null and b/Images-GUI/05-action-windows/action-window-core-apps.png differ diff --git a/Images-GUI/06-states-responsive/states-responsive-reference.png b/Images-GUI/06-states-responsive/states-responsive-reference.png new file mode 100644 index 00000000..e9ba2442 Binary files /dev/null and b/Images-GUI/06-states-responsive/states-responsive-reference.png differ diff --git a/Images-GUI/07-plugins-skills-mcp/plugins-skills-mcp-app-connectors.png b/Images-GUI/07-plugins-skills-mcp/plugins-skills-mcp-app-connectors.png new file mode 100644 index 00000000..9663f48c Binary files /dev/null and b/Images-GUI/07-plugins-skills-mcp/plugins-skills-mcp-app-connectors.png differ diff --git a/Images-GUI/08-app-utility-pages/proof-health-notifications-safety.png b/Images-GUI/08-app-utility-pages/proof-health-notifications-safety.png new file mode 100644 index 00000000..d2215cb9 Binary files /dev/null and b/Images-GUI/08-app-utility-pages/proof-health-notifications-safety.png differ diff --git a/Images-GUI/08-app-utility-pages/workflow-printqueue-files-logs.png b/Images-GUI/08-app-utility-pages/workflow-printqueue-files-logs.png new file mode 100644 index 00000000..a0bddd55 Binary files /dev/null and b/Images-GUI/08-app-utility-pages/workflow-printqueue-files-logs.png differ diff --git a/Images-GUI/09-themes/theme-variants-reference.png b/Images-GUI/09-themes/theme-variants-reference.png new file mode 100644 index 00000000..4db2ff24 Binary files /dev/null and b/Images-GUI/09-themes/theme-variants-reference.png differ diff --git a/Images-GUI/GUI_REFERENCE_MANIFEST.json b/Images-GUI/GUI_REFERENCE_MANIFEST.json new file mode 100644 index 00000000..db5b95eb --- /dev/null +++ b/Images-GUI/GUI_REFERENCE_MANIFEST.json @@ -0,0 +1,116 @@ +{ + "created": "2026-05-08", + "purpose": "Hermes3D OS GUI visual direction and page coverage reference pack", + "total_png_references": 31, + "remaining_images_needed_for_current_scope": 0, + "coverage": { + "primary_tabs": { + "covered": 16, + "total": 16, + "items": [ + "source_os", + "dashboard", + "autopilot", + "design", + "gen3d", + "jobs", + "printers", + "observe", + "voice", + "agents", + "learning", + "artifacts", + "approvals", + "plugins", + "settings", + "roadmap" + ] + }, + "settings_subtabs": { + "covered": 6, + "total": 6, + "items": ["providers", "agents", "printers", "environment", "updates", "about"] + }, + "voice_subtabs": { + "covered": 3, + "total": 3, + "items": ["voice_browser", "transcript_history", "proof_review"] + }, + "source_os_categories": { + "covered": 11, + "total": 11, + "items": { + "modelers": 13, + "slicers": 11, + "print_farm": 10, + "agents": 7, + "firmware": 6, + "three_d_generation": 6, + "hardware": 3, + "library": 1, + "materials": 1, + "research": 1, + "utilities": 1 + } + }, + "themes": [ + "default_hermes_dark", + "cyberpunk", + "matrix", + "tron", + "industrial_forge", + "aurora_operator" + ] + }, + "reference_groups": [ + { + "folder": "00-user-current-downloads", + "description": "User-provided/current approved references kept for comparison." + }, + { + "folder": "01-dashboard-modes", + "description": "Simple, Advanced, and Custom dashboard mode references." + }, + { + "folder": "02-primary-pages", + "description": "Primary tab references." + }, + { + "folder": "03-settings-voice", + "description": "Settings and voice/communication subtabs." + }, + { + "folder": "04-source-os", + "description": "Source OS categories and 60-app coverage matrix." + }, + { + "folder": "05-action-windows", + "description": "Resizable Action Window templates." + }, + { + "folder": "06-states-responsive", + "description": "Responsive layouts and state screens." + }, + { + "folder": "07-plugins-skills-mcp", + "description": "Plugins, skills, MCP servers, app connectors." + }, + { + "folder": "08-app-utility-pages", + "description": "Workflows, print queue, files, logs, proof, health, notifications, safety." + }, + { + "folder": "09-themes", + "description": "Theme variants." + } + ], + "implementation_rules": [ + "Use these images as visual targets, not runtime proof.", + "Use Playwright screenshots as runtime proof after implementation.", + "No fake data, no unsupported readiness claims, no secret values.", + "All primary tabs and current features must remain accessible.", + "All 60 Source OS apps must open through shared app/action-window patterns.", + "Dashboards must support Simple, Advanced, and Custom modes.", + "Themes must be user-changeable." + ] +} diff --git a/Images-GUI/README.md b/Images-GUI/README.md new file mode 100644 index 00000000..4319025f --- /dev/null +++ b/Images-GUI/README.md @@ -0,0 +1,182 @@ +# Hermes3D OS GUI Reference Pack + +Created: 2026-05-08 + +This folder is the visual direction pack for the next Hermes3D OS GUI pass. It is a source-of-truth reference collection for the desired look, density, layout behavior, dashboard modes, themes, and app/action-window surfaces. + +Important: these images are visual references, not runtime proof. Runtime truth must come from Playwright screenshots, console checks, no-fake scans, and backend evidence after implementation. + +## Current Count + +- Total PNG references: 31 +- Remaining images needed for this reference-pack scope: 0 +- Primary tabs covered: 16 of 16 +- Settings subtabs covered: 6 of 6 +- Voice subtabs covered: 3 of 3 +- Source OS categories covered: 11 of 11 +- 60-app workbench covered: yes, by category and coverage matrix +- Themes covered: default, cyberpunk, matrix, tron, industrial forge, aurora operator + +## Required Visual Direction + +All future Hermes3D OS GUI work should follow this direction: + +- Even darker background than the current app. +- Multi-color accents, not a one-note blue dashboard. +- Sharp operational panels, about 6px radius. +- Dense but usable command-center layout. +- Resizable central Action Window for slicer, modeling, camera, proof, logs, agents, and all 60 apps. +- Simple, Advanced, and Custom dashboard modes. +- Custom dashboards must allow draggable/resizable widgets. +- Theme selection must be user-changeable. +- Existing backend truth must be preserved: no fake data, no invented readiness, no exposed secrets. +- Every visible feature must map to a real backend route, app state, proof artifact, or honest blocked state. + +## Folder Map + +| Folder | Purpose | +|---|---| +| `00-user-current-downloads/` | User-provided/current approved references kept for comparison. | +| `01-dashboard-modes/` | Simple, Advanced, and Custom dashboard mode references. | +| `02-primary-pages/` | Primary tab references covering Autopilot, Design, 3D Generation, Jobs, Printers, Observe, Agents, Learning, Artifacts, Approvals, Plugins, and Roadmap. | +| `03-settings-voice/` | Settings subtabs and Voice/communication subtabs. | +| `04-source-os/` | Source OS categories plus the 60-app coverage matrix. | +| `05-action-windows/` | Resizable Action Window templates for core apps and advanced tools. | +| `06-states-responsive/` | Loading, empty, blocked, recovering, compact desktop, and fullscreen action states. | +| `07-plugins-skills-mcp/` | Plugins, skills, MCP servers, app connectors, and integration center. | +| `08-app-utility-pages/` | Workflows, Print Queue, Files & Projects, System Logs, Proof & Reports, Service Health, Notifications, Safety/Security. | +| `09-themes/` | Theme variants: default, cyberpunk, matrix, tron, industrial forge, aurora operator. | + +## Page Coverage + +Primary Hermes3D tabs covered: + +- Source OS +- Dashboard +- Autopilot +- Design +- 3D Generation +- Jobs +- Printers +- Observe +- Voice +- Agents +- Learning +- Artifacts +- Approvals +- Plugins +- Settings +- Roadmap + +Additional app/utility surfaces covered: + +- Workflows +- Print Queue +- Files & Projects +- Proof & Reports +- System Logs +- Service Health +- Notifications Center +- Safety/Security +- Blender MCP +- Slicing +- OpenCode/OpenHands terminal workspace +- MCP Hub +- Skills Registry +- Plugin Marketplace +- App Connector Center +- Agent Recovery Controller + +Source OS app coverage: + +- Modelers: 13 +- Slicers: 11 +- Print Farm: 10 +- Agents: 7 +- Firmware: 6 +- 3D Generation: 6 +- Hardware: 3 +- Library: 1 +- Materials: 1 +- Research: 1 +- Utilities: 1 + +## Implementation Contract + +Claude/Codex implementation must not copy these by vibes. It must convert them into a measured visual system: + +1. Define design tokens: + - backgrounds + - panel colors + - accent palette + - status colors + - border radius + - shadow/glow rules + - typography scale + - grid gaps + - card heights + - sidebar/topbar dimensions + +2. Build one shared shell: + - sidebar + - top bar + - mode selector + - theme selector + - resizable Action Window + - task/proof drawer + - widget grid + - app launcher + +3. Build three dashboard modes: + - Simple + - Advanced + - Custom + +4. Make every app open inside the Action Window: + - slicers + - modelers + - cameras + - proof viewer + - logs + - agents + - OpenCode/OpenHands + - MCP Hub + - 60-app detail views + +5. Preserve all current features: + - no route removals + - no hidden tabs + - no fake data + - no secret values in UI + - no unsupported production claims + +## Playwright Visual Oracle + +Implementation is not accepted until Playwright captures and verifies: + +- Every primary tab at desktop size. +- Simple, Advanced, and Custom dashboards. +- All settings subtabs. +- All voice subtabs. +- Source OS home plus every category. +- Action Window normal, expanded, and fullscreen. +- Compact desktop layout. +- Loading, empty, blocked, recovering, completed states. +- Theme switching. +- Console clean: no runtime errors. +- No network 404s for expected app routes. +- `scan_active_ui_no_fake.py` passes. + +Suggested screenshot matrix: + +- `1920x1080` +- `1600x900` +- `1366x768` +- compact desktop with collapsed sidebar + +## Non-Negotiables + +- Keep the user-approved references always accessible. +- Do not overwrite this folder with generated runtime screenshots. +- Store future Playwright proofs under proof/artifact folders, then link them back here. +- Treat this folder as the visual target, and Playwright evidence as the runtime proof.