# ignitionoee — Impeccable UI recommendations
Reviewed 2026-11-12 · source snapshot `14780f7a` · Operate mode.
This repository has **three browser-facing surfaces**: the central router Blazor UI, the machine-registry Blazor UI, and site Perspective operator/process views. The router centrally pins Theme **0.5.0** (`router/Directory.Packages.props:85`). Registry does not reference Theme; its CSS vendors fonts from 0.4.1 and copies the visual contract. Perspective is an Ignition runtime and cannot consume a Razor Class Library. Share the design language and exported tokens there, preserving operator tasks and touch layout.
[Open proposed mockup](mockups/ignitionoee.html) · [Review index](index.html) · [Shared direction](SHARED-DESIGN-SYSTEM.md).
This is a source-backed review and design proposal. Production applications, live credentials, deployed data, browser keyboard behavior, and measured performance were not exercised. Mockups use illustrative data and demonstrate proposed patterns; they are not screenshots of the existing application. No production source was modified.
[Registry proposal](mockups/ignitionoee-Registry.html) · [Perspective operator proposal](mockups/ignitionoee-Perspective.html).
## Summary
2 P1 and 8 P2 recommendations; no proven P0. Unify component behavior and token delivery before visual decoration. The router already has strong data-integrity states and several recent mobile improvements. The registry has more complete native-dialog and responsive-table work that can serve as an implementation example. Do not overwrite these wins with a superficial restyle. Scores are withheld because no live Ignition/Blazor session or assistive-technology run was performed.
## Shared visual contract
Keep IBM Plex Sans for reading and Plex Mono for identifiers, timestamps, and aligned values; warm paper, white panels, thin neutral rules, compact navigation, and one clear page heading. Use the shared Theme package for chrome and primitives. Shared means the same spacing, field, table, notice, focus, status, and responsive rules. Preserve explicitly permitted product accents. Do not fork a theme per page or introduce a separate dark dashboard. The mockups show accessible status ink and taller touch targets as proposals for the shared library, not new app-local token copies.
## Verification and release gate
At 1440 × 900, 1024 × 768, 390 × 844 and 200% zoom, verify that only intentional table regions scroll horizontally; headings, filters, notices and footer actions remain visible. Keyboard-test navigation, search, detail disclosure and all dialogs. Confirm text names and state announcements with a screen reader; measure text contrast (4.5:1) and non-text focus/control contrast (3:1). On coarse pointers, offer 44px targets without forcing every desktop data row to become tall. Test long tag paths, empty results, unavailable dependencies, stale snapshots, denied access and a slow operation that succeeds after several seconds.
A source detector ran once across the gateway dashboard and ignitionoee router/registry component directories. It returned `[]`: see [gateways-detector.json](evidence/gateways-detector.json). This is a narrow mechanical result, not an accessibility pass; manual source findings below remain valid. CSS in separate host asset directories and Perspective JSON are outside that invocation. No detector false positives required dismissal.
### OEE-01 · P1 · Replace click-only job row expansion with a real disclosure
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Pages/Jobs.razor:100](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Pages/Jobs.razor:100).
**Owner:** router + shared table-row disclosure pattern. **Impact:** the job `
` has only `@onclick`, no tabindex or keyboard handler. Its work-order details cannot be opened with the keyboard even though the row claims button semantics. **Recommendation:** keep the table semantic and add a real “Details for [job]” button in an actions cell, with `aria-expanded`/`aria-controls`; row clicking can remain an optional accelerator. **Acceptance:** Tab + Enter/Space reveals and closes details, expanded state is announced, focus stays anchored, and the full copyable job ID remains available. WCAG 2.1.1 / 4.1.2. **Command:** `$impeccable harden`.
### OEE-02 · P1 · Complete modal keyboard behavior using the strongest existing implementation
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Shared/TechModal.razor:7](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Shared/TechModal.razor:7).
**Owner:** common dialog primitive with router consumers. **Impact:** source explicitly documents absent focus trap, initial focus, focus restore and Escape. `aria-modal` alone does not make background DOM inert or stop Tab reaching underlying controls. **Recommendation:** use a native dialog/managed-dialog contract and reuse the registry driver editor’s open/close/error-focus approach rather than retaining two patterns. Keep typed-state cancel and busy-write protection. **Acceptance:** background is truly inert, initial focus is correct, safe Escape works, Tab cycles inside, focus returns to invoking button, validation errors receive focus/announcement, no submitted state is lost. WCAG 2.4.3 / 2.1.1. **Command:** `$impeccable harden`.
### OEE-03 · P2 · Converge registry onto shared assets without deleting domain CSS
**Evidence:** [registry/src/Registry.Host/wwwroot/app.css:1](/Users/dohertj2/Desktop/ignitionoee/registry/src/Registry.Host/wwwroot/app.css:1).
**Owner:** Theme/token distribution + registry. **Evidence:** fonts and `:root` tokens are copied at lines 1–6; shell/nav/button/table rules follow at 10–49; `Components/App.razor:2` loads only local CSS. **Impact:** the registry looks related but will miss shared contrast, mobile-shell and future accessibility fixes. **Recommendation:** adopt Theme assets/shell if the host can support the package, or generate a versioned CSS/token export consumed by both hosts. Keep floorplan, identity/evidence and catalog geometry local; do not blindly delete selectors. **Acceptance:** one canonical palette/font bundle; documented source version; automated visual comparison of registry/router shell; identical focus, notices and action sizes. **Command:** `$impeccable extract`.
### OEE-04 · P2 · Export a platform-compatible Technical-Light contract to Perspective
**Evidence:** [projects/OEE_Site/com.inductiveautomation.perspective/views/KpiTile/view.json:28](/Users/dohertj2/Desktop/ignitionoee/projects/OEE_Site/com.inductiveautomation.perspective/views/KpiTile/view.json:28).
**Owner:** shared token export + site Perspective classes. **Evidence:** background and text colors are literal in KpiTile (`:28/50/87`); ReasonPicker (`:61`) and JobEntry (`:81`) repeat separate ink styling. **Impact:** adjustments to Theme never reach operator views and individual view edits can diverge. **Recommendation:** map shared surface, ink, status, typography and spacing tokens into Ignition theme/style classes. Keep site status logic and Perspective components native. Do not import Blazor CSS selectors into the gateway or force a desktop rail onto touch panels. **Acceptance:** the same color sample/text contrast passes in router, registry and site views; one documented mapping defines status semantics; visual rollout is validated in Ignition Designer/session at kiosk and phone sizes. **Command:** `$impeccable extract`.
### OEE-05 · P2 · Allow the router rail to scroll while preserving session actions
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Layout/MainLayout.razor:15](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Layout/MainLayout.razor:15).
**Owner:** shared shell usage + router. **Impact:** MainLayout does not opt into `ScrollNav`; NavMenu contains Operations, Configuration, Schedules, Rates and Administration, all expanded by default. At short desktop heights the footer can be pushed below the viewport. **Recommendation:** adopt the current shared shell scroll option once the required package version is available, preserve section keys and current policy gates, and consider initial collapse for less frequent groups. **Acceptance:** at 1024×768 and 200% zoom, every authorized link and Sign out remain reachable with independent nav scrolling; stored section state survives migration. **Command:** `$impeccable adapt`.
### OEE-06 · P2 · Reduce scheduling context-switch costs
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Layout/NavMenu.razor:54](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Layout/NavMenu.razor:54).
**Owner:** router information architecture. **Impact:** schedule definition, assignments, shift hours, calendar and resolved preview are separate destinations; the relationship is explained in source comments rather than on the task surface. **Recommendation:** retain routes and policy boundaries, but show shared scope context and a compact related-task strip: Schedule → Assignments → Calendar → Preview. Deep-link selected schedule/cell/site rather than asking users to reselect. **Acceptance:** an operator can inspect why a cell has a given planned-time denominator and reach the responsible schedule/override with scope intact; do not present this strip as mandatory linear steps. **Command:** `$impeccable clarify`.
### OEE-07 · P2 · Make issue queues a consistent investigate-and-recover workflow
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Pages/ConfigIssues.razor:27](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Pages/ConfigIssues.razor:27).
**Owner:** common notice/queue pattern + router. **Impact:** configuration and enrichment pages contain different error/empty/result containers; configuration read errors include raw exception text in the main notice. The excellent consequence and fix links should be the dominant content. **Recommendation:** normalize header count/freshness, severity + consequence + owner/scope + next action, shared loading and refresh-failed notices, and expandable safe diagnostics. Use a single polite result summary and avoid announcing each periodically updated row. **Acceptance:** no-data, no-issues and failed evaluation cannot be confused; action links preserve relevant context; prior results are explicitly stale after refresh failure. **Command:** `$impeccable harden`.
### OEE-08 · P2 · Extend responsive field and table contracts beyond one repaired page
**Evidence:** [router/src/ZB.MOM.Oee.Ui/Components/Pages/Oee.razor:20](/Users/dohertj2/Desktop/ignitionoee/router/src/ZB.MOM.Oee.Ui/Components/Pages/Oee.razor:20).
**Owner:** shared responsive primitives + router pages. **Impact:** OEE already contains a page-local container query fixing toolbar wrap and 44px controls. Similar filter/table patterns occur in Jobs, schedule previews, rates and configuration pages; these should not each need a separate fix. **Recommendation:** extract the proven wrapping toolbar behavior into shared utilities; retain page-specific column decisions. Keep totals/critical identifiers visible and expose secondary columns through row details at narrow widths. **Acceptance:** 390px/200% zoom keeps page headers, filters and notices inside the viewport; only labeled data regions scroll; long site/cell paths and translated labels remain readable. **Command:** `$impeccable adapt`.
### OEE-09 · P2 · Keep evidence and eligibility distinct from live operational health
**Evidence:** [registry/src/Registry.Host/Components/Pages/Drivers.razor:1](/Users/dohertj2/Desktop/ignitionoee/registry/src/Registry.Host/Components/Pages/Drivers.razor:1).
**Owner:** registry domain vocabulary using shared status patterns. **Impact:** “Production eligible” means mapping selection, not successful deployment or commissioning; the page already states this correctly. As styles converge, a generic green Healthy pill would erase that distinction. **Recommendation:** preserve Eligible/Not eligible labels, prerequisites, evidence and revision context; reserve runtime health labels for actual telemetry. Reuse table/action geometry while retaining domain language and native-dialog validation. **Acceptance:** mockup and production catalog never imply that eligibility proves a driver is running or that a mapping is commissioned; stale-evidence states show their reason in text. **Command:** `$impeccable clarify`.
### OEE-10 · P2 · Make touch density a documented operator-view variant
**Evidence:** [projects/OEE_Site/com.inductiveautomation.perspective/views/JobEntry/view.json:47](/Users/dohertj2/Desktop/ignitionoee/projects/OEE_Site/com.inductiveautomation.perspective/views/JobEntry/view.json:47).
**Owner:** Perspective, following shared density tokens. **Evidence:** JobEntry already has a `touch` input and font-size bindings (`:70`); NavHeader defines a 48px design height and six navigation choices; ReasonPicker does not share that touch parameter. **Impact:** route-to-route control sizing can change unexpectedly on a fixed panel. **Recommendation:** define compact desktop and operator-touch density variants, carry touch mode into reason entry and diagnostic panels, and keep cell/job identity and last-data time visible. Treat diagnostic process panels as read-only unless the source explicitly provides an operation. **Acceptance:** validate 1024px kiosk, 1280px panel and 390px handheld in a live Perspective session; tap targets are at least 44px; unknown/disconnected values never display as zero/healthy; no runtime claim is inferred from JSON defaultSize alone. **Command:** `$impeccable adapt`.
## Visual evidence and strengths
Inspected the committed `docs/recipes/evidence/registry-drivers-ui-2026-11-05/drivers-desktop.png` and `driver-editor-mobile.png`. They show an older green topbar and broad action targets. **They are stale for current chrome:** current `registry/.../MainLayout.razor` and `app.css` implement a blue Technical-Light side rail. Use them to preserve task affordances and mobile editor evidence, not as current-theme screenshots. No live screenshot proves the present source/deployed host match.
Preserve these source-verified strengths:
- Router role/policy-gated nav, busy button support, one-time API-key tokens and explicit revoke/reissue confirmation.
- OEE rejects an over-cap fact window instead of rendering misleading partial totals; unavailable values stay unknown.
- Configuration issues explain consequences and link to the fixing screen.
- Registry Driver editor uses native `dialog`, labels/hints, required evidence and optimistic-concurrency reload. Registry tables offer details and pagination rather than placing every field in a broad row.
- Floorplan markers have keyboard handlers and a parallel location list. Keep the list as an equally capable route; do not reduce the map to pointer-only navigation.
- Perspective keeps native touch and role-aware manual job entry, rather than embedding a browser admin application into an operator panel.
## Coverage
Deep inspection: router Jobs, OEE, ConfigIssues, TechModal, machine-editor action markup, API-key state patterns and full rail; registry shell/CSS, Drivers native editor, Floorplans interaction markup; Perspective JobEntry, ReasonPicker, KpiTile, NavHeader and Overview composition. Remaining routes/views were inventoried and source-scanned for layout, binding/style repetition and primary affordances. Backend handlers, every process-panel binding, live Ignition schema acceptance and all runtime authorization paths were not executed.
### Router routes
| Route | Source | Coverage |
| --- | --- | --- |
| `/admin/api-keys` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ApiKeys.razor` | Source scanned |
| `/config-issues` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ConfigIssues.razor` | Source scanned |
| `/enrichment-issues` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/EnrichmentIssues.razor` | Source scanned |
| `/erp-instances` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ErpInstances.razor` | Source scanned |
| `/jobs` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Jobs.razor` | Source scanned |
| `/login` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Login.razor` | Source scanned |
| `/machine-types` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/MachineTypes.razor` | Source scanned |
| `/machines` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Machines.razor` | Source scanned |
| `/notifications` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Notifications.razor` | Source scanned |
| `/oee` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Oee.razor` | Source scanned |
| `/piece-rates` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Rates/PieceRates.razor` | Source scanned |
| `/rate-coverage` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Rates/RateCoverage.razor` | Source scanned |
| `/rate-import` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Rates/RateImport.razor` | Source scanned |
| `/rate-preview` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Rates/RatePreview.razor` | Source scanned |
| `/reasons` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Reasons.razor` | Source scanned |
| `/schedule-assignments` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ScheduleAssignments.razor` | Source scanned |
| `/schedule-calendar` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ScheduleCalendar.razor` | Source scanned |
| `/schedules/{ScheduleId:int}` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ScheduleEditor.razor` | Source scanned |
| `/schedule-preview` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/SchedulePreview.razor` | Source scanned |
| `/schedules` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Schedules.razor` | Source scanned |
| `/admin/security` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/SecuritySettings.razor` | Source scanned |
| `/shift-hours` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/ShiftHours.razor` | Source scanned |
| `/site-reasons` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/SiteReasons.razor` | Source scanned |
| `/sites` | `router/src/ZB.MOM.Oee.Ui/Components/Pages/Sites.razor` | Source scanned |
| `/` | `router/src/ZB.MOM.Oee.Host/Components/Pages/Home.razor` | Source scanned |
### Registry routes
| Route | Source | Coverage |
| --- | --- | --- |
| `/drivers` | `registry/src/Registry.Host/Components/Pages/Drivers.razor` | Source scanned |
| `/exports` | `registry/src/Registry.Host/Components/Pages/Exports.razor` | Source scanned |
| `/floorplans, /floorplans/{Id:guid}` | `registry/src/Registry.Host/Components/Pages/Floorplans.razor` | Source scanned |
| `/identity` | `registry/src/Registry.Host/Components/Pages/IdentityReview.razor` | Source scanned |
| `/imports` | `registry/src/Registry.Host/Components/Pages/Imports.razor` | Source scanned |
| `/` | `registry/src/Registry.Host/Components/Pages/Inventory.razor` | Source scanned |
| `/investigations` | `registry/src/Registry.Host/Components/Pages/Investigations.razor` | Source scanned |
| `/machines/{Id:guid}` | `registry/src/Registry.Host/Components/Pages/MachineDetail.razor` | Source scanned |
| `/machines` | `registry/src/Registry.Host/Components/Pages/Machines.razor` | Source scanned |
| `/subjects/{Id:guid}` | `registry/src/Registry.Host/Components/Pages/SubjectDetail.razor` | Source scanned |
| `/verification` | `registry/src/Registry.Host/Components/Pages/Verification.razor` | Source scanned |
### Perspective view inventory
- `Admin/AdminNav` — inventory/source scan.
- `Admin/Terminals` — inventory/source scan.
- `CellDetail` — inventory/source scan.
- `CellTile` — inventory/source scan.
- `DowntimePareto` — inventory/source scan.
- `JobEntry` — deep inspection.
- `KpiTile` — deep inspection.
- `NavHeader` — deep inspection.
- `Overview` — deep inspection.
- `PanelCell` — inventory/source scan.
- `ProcessPanels/Elma3` — inventory/source scan.
- `ProcessPanels/Elma5` — inventory/source scan.
- `ProcessPanels/Elma7` — inventory/source scan.
- `ProcessPanels/Elma9` — inventory/source scan.
- `ProcessPanels/ElmaHeader` — inventory/source scan.
- `ProcessPanels/ElmaRobot` — inventory/source scan.
- `ProcessPanels/ElmaStation` — inventory/source scan.
- `ProcessPanels/ElmaStationRow` — inventory/source scan.
- `ProcessPanels/FocasCnc` — inventory/source scan.
- `ProcessPanels/HeidenhainCnc` — inventory/source scan.
- `ProcessPanels/HeidenhainDiagnostic` — inventory/source scan.
- `ProcessPanels/HeidenhainDiagnostics` — inventory/source scan.
- `ProcessPanels/HeidenhainMetric` — inventory/source scan.
- `ProcessPanels/MTConnectCnc` — inventory/source scan.
- `ProcessPanels/MTConnectDiagnostic` — inventory/source scan.
- `ProcessPanels/MTConnectDiagnostics` — inventory/source scan.
- `ProcessPanels/MTConnectMetric` — inventory/source scan.
- `ProcessPanels/Press` — inventory/source scan.
- `ProcessPanels/PressAlarmRow` — inventory/source scan.
- `ReasonPicker` — deep inspection.
- `ShiftReport` — inventory/source scan.
The shared `/admin/secrets` route is mounted from Secrets.Ui, not a missing local Razor route. Ignition gateway configuration, Designer tools, third-party control styling, floorplan source images and Java module management pages are outside the custom application UI recommendations here.
## Rollout and mockup scope
1. `$impeccable harden`: OEE-01/02 first; then OEE-07.
2. `$impeccable extract`: OEE-03/04, with a versioned shared contract and registry/Perspective mappings.
3. `$impeccable adapt`: OEE-05/08/10; `$impeccable clarify`: OEE-06/09.
4. `$impeccable polish`, then live `$impeccable audit` in both Blazor hosts and a live Perspective session.
The router mockup demonstrates the Jobs detail pattern; registry shows an evidence-oriented driver catalog; Perspective shows an operator Cell Detail layout with a touch-sized reason-entry disclosure. All use illustrative values. The Perspective HTML is a visual reference to implement with native Ignition components/style classes, not deployable Perspective code. No job, downtime, catalog or configuration write runs from these files.
## Rendered proposal previews
These are proposed UI artifacts with illustrative data, not screenshots of the current application. All use the same shared stylesheet. See [verification and limits](VERIFICATION.md).
### ignitionoee
[Interactive HTML](mockups/ignitionoee.html) · [Desktop PNG](evidence/ignitionoee-desktop.png) · [Mobile PNG](evidence/ignitionoee-mobile.png)

### ignitionoee-Registry
[Interactive HTML](mockups/ignitionoee-Registry.html) · [Desktop PNG](evidence/ignitionoee-Registry-desktop.png) · [Mobile PNG](evidence/ignitionoee-Registry-mobile.png)

### ignitionoee-Perspective
[Interactive HTML](mockups/ignitionoee-Perspective.html) · [Desktop PNG](evidence/ignitionoee-Perspective-desktop.png) · [Mobile PNG](evidence/ignitionoee-Perspective-mobile.png)
