docs: register ui-theme component in indexes

README.md

@@ -17,8 +17,10 @@ it produces.
 | [`CLAUDE.md`](CLAUDE.md) | High-level index of the sister projects + working guidance |
 | [`components/`](components/) | Component-normalization framework (per concern: target spec, current state, gaps) |
 | [`components/auth/`](components/auth/) | First normalized component — login / identity / authorization |
-| [`docs/plans/`](docs/plans/) | Implementation plans (e.g. the ZB.MOM.WW.Auth build) |
+| [`components/ui-theme/`](components/ui-theme/) | Second normalized component — UI theme / design tokens / layout |
+| [`docs/plans/`](docs/plans/) | Implementation plans (e.g. the ZB.MOM.WW.Auth and ZB.MOM.WW.Theme builds) |
 | [`ZB.MOM.WW.Auth/`](ZB.MOM.WW.Auth/) | **Built shared library** (.NET 10) — the realized output of the auth normalization |
+| [`ZB.MOM.WW.Theme/`](ZB.MOM.WW.Theme/) | **Built shared RCL** (.NET 10) — the realized output of the UI-theme normalization |
 
 ## The sister projects
 
@@ -52,6 +54,42 @@ The sister repos kept re-implementing the same cross-cutting concerns and drifti
 | Component | Status | Folder |
 |---|---|---|
 | Auth (login / identity / authz) | Built (library 0.1.0); apps not yet adopted | [`components/auth/`](components/auth/) |
+| UI Theme (layout / tokens / components) | Built (RCL 0.1.0); apps not yet adopted | [`components/ui-theme/`](components/ui-theme/) |
+
+## `ZB.MOM.WW.Theme` — the shared UI kit
+
+The UI-theme component, realized as a single-package .NET 10 Razor Class Library the three
+apps can adopt to stop copy-pasting the Technical-Light design system. **Built and tested at
+0.1.0; adoption by the apps is the follow-on** (tracked in
+[`components/ui-theme/GAPS.md`](components/ui-theme/GAPS.md)).
+
+| Asset / Component | Purpose | Used by |
+|---|---|---|
+| `_content/ZB.MOM.WW.Theme/css/theme.css` | Design tokens, IBM Plex typography, Bootstrap overrides | all |
+| `_content/ZB.MOM.WW.Theme/css/layout.css` | Side-rail shell layout, nav CSS, chip/card helpers | all |
+| `_content/ZB.MOM.WW.Theme/fonts/*.woff2` | IBM Plex Sans 400/600 + Mono 500, vendored | all |
+| `ThemeHead`, `ThemeShell`, `BrandBar` | Shell entry point and chassis components | all |
+| `NavRailItem`, `NavRailSection` | Rail nav components | all |
+| `StatusPill` (`StatusState`) | Inline status chip — replaces per-app `StatusBadge` | all |
+| `LoginCard` | Static form-POST sign-in card | OtOpcUa, ScadaBridge (MxGateway when login page added) |
+| `TechButton`, `TechCard`, `TechField` | Common controls (Bootstrap 5 wrappers) | all |
+
+**Consumer matrix:** all three apps consume the single `ZB.MOM.WW.Theme` package —
+OtOpcUa `AdminUI`, MxAccessGateway `Server`, ScadaBridge `Host` + `CentralUI`.
+
+### Build & test
+
+```bash
+cd ZB.MOM.WW.Theme
+dotnet build -c Release   # 0 warnings (TreatWarningsAsErrors)
+dotnet test               # 32 bUnit tests
+./build/pack.sh           # → ./artifacts/ZB.MOM.WW.Theme.0.1.0.nupkg
+```
+
+Stack: .NET 10 · Razor Class Library · bUnit · xUnit · central package management.
+More detail: [`ZB.MOM.WW.Theme/README.md`](ZB.MOM.WW.Theme/README.md).
+
+---
 
 ## `ZB.MOM.WW.Auth` — the shared library
 
@@ -98,4 +136,7 @@ ZB_LDAP_IT=1 dotnet test   # requires a reachable GLAuth (e.g. a sister repo's i
 - ✅ Auth component normalized (spec + canonical roles + current-state + gaps).
 - ✅ `ZB.MOM.WW.Auth` shared library built and tested (0.1.0).
 - ⬜ Adopt `ZB.MOM.WW.Auth` in OtOpcUa, MxAccessGateway, ScadaBridge — [`components/auth/GAPS.md`](components/auth/GAPS.md) (#8).
+- ✅ UI-theme component normalized (spec + design tokens + current-state + gaps).
+- ✅ `ZB.MOM.WW.Theme` shared UI kit built and tested (0.1.0); apps not yet adopted.
+- ⬜ Adopt `ZB.MOM.WW.Theme` in OtOpcUa [low risk], ScadaBridge [med], MxAccessGateway [high risk] — [`components/ui-theme/GAPS.md`](components/ui-theme/GAPS.md).
 - ⬜ Normalize the next cross-cutting component.