Files
scadaproj/components/ui-theme/README.md
T

43 lines
2.3 KiB
Markdown

# Shared Technical-Light UI theme
`ZB.MOM.WW.Theme` is the implemented .NET 10 Razor Class Library for the SCADA
family. It owns canonical tokens, IBM Plex fonts, shell, common controls, shared CSS
and optional nav-state persistence. Applications retain domain pages and behavior.
Current published release: **0.5.3**. Accessible coordinated candidate: **1.0.0**, not
published yet. [Release decision](RELEASE-DECISION.md) records version policy, actual
consumer pins and accent families. [GB acceptance](validation/bunit-2.7.2/ACCEPTANCE.md)
records all seven bUnit migrations. Historical current-state reports describe their
original snapshots; they are not current rollout records.
- [Specification](spec/SPEC.md)
- [Canonical tokens](spec/DESIGN-TOKENS.md)
- [Interaction recipes](spec/INTERACTION-RECIPES.md)
- [Component contract](shared-contract/ZB.MOM.WW.Theme.md)
- [Library usage](../../ZB.MOM.WW.Theme/README.md)
- [Execution ledger](../../docs/plans/2026-11-12-scada-ui-consistency/EXECUTION.md)
- [Historical adoption notes](GAPS.md)
| Consumer | Baseline Theme | Accessible adoption |
|---|---|---|
| ScadaBridge Host/CentralUI | 0.5.3 | Pending exact candidate canary/release |
| OtOpcUa AdminUI | 0.5.0 | Pending G1 |
| MxAccessGateway Server | 0.5.0 | Pending G1 |
| HistorianGateway Server | 0.5.0 | Pending G1 |
| BTDB Manager | 0.4.1 | Pending G1 |
| Overview | 0.5.0 | Pending exact candidate canary/release |
| ignitionoee router | 0.5.0 | Pending G1 |
| ignitionoee registry/Perspective | Native/public-feed graph | Package-derived export/native mapping pending |
Keep one CSS/font authority per application. Use ThemeHead after host Bootstrap and
ThemeScripts once near the end of the body. Preserve compact sizing, rail behavior
and current brand accents; use semantic inks for readable state text. Complete accent
families, labeled field IDs and persistent operation outcomes are documented in the
contracts. Status/info meaning is shared across products. Explicit supported dark
schemes require their own readable aliases and verification.
The 1.0.0 static exporter takes exact validated package bytes and produces CSS/fonts,
raw tokens and provenance hashes for hosts that cannot use a private RCL package.
No registry private-feed dependency is introduced. Domain editors, authentication,
authorization, data loading and protocols remain host responsibilities.