wehub-resource-sync
9740bc64c9
Firmware QEMU Tests (ADR-061) / QEMU Test (edge-tier1) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (full-adr060) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (tdm-3node) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / Swarm Test (ADR-062) (push) Has been skipped
npm packages / tools/ruview-mcp (node 22) (push) Failing after 1s
nvsim-server → ghcr.io / build-and-publish (push) Failing after 1s
ruview-swarm CI guard / tests (full+train) (push) Failing after 2s
Bench Regression Guard / bench compile-verify (--no-run) (push) Failing after 0s
Bench Regression Guard / bench fast-run (informational, non-gating) (push) Has been skipped
Firmware CI / Verify version.txt matches release tag (push) Has been skipped
Dashboard a11y + cross-browser / a11y (push) Failing after 0s
nvsim Dashboard → GitHub Pages / build-and-deploy (push) Failing after 2s
Firmware CI / Build firmware (esp32s3 / 4mb) (push) Failing after 15s
Firmware QEMU Tests (ADR-061) / Build Espressif QEMU (push) Failing after 1s
Firmware QEMU Tests (ADR-061) / Fuzz Testing (ADR-061 Layer 6) (push) Failing after 1s
Continuous Deployment / Pre-deployment Checks (push) Has been skipped
Firmware CI / Build firmware (esp32c6 / c6-4mb) (push) Failing after 15s
Firmware CI / Build firmware (esp32s3 / 8mb) (push) Failing after 15s
Firmware QEMU Tests (ADR-061) / QEMU Test (boundary-max) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (boundary-min) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (default) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (edge-tier0) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / NVS Matrix Generation (push) Failing after 1s
Security Scanning / Security Policy Compliance (push) Failing after 0s
Security Scanning / Dependency Vulnerability Scan (push) Failing after 0s
Security Scanning / Static Application Security Testing (push) Failing after 1s
Security Scanning / Infrastructure Security Scan (push) Failing after 1s
Security Scanning / Secret Scanning (push) Failing after 1s
npm packages / harness/ruview (node 22) (push) Failing after 17s
Security Scanning / License Compliance Scan (push) Failing after 1s
Security Scanning / Container Security Scan (push) Failing after 4s
three.js demos → GitHub Pages / build-and-deploy (push) Failing after 1s
Verify Pipeline Determinism / Verify Pipeline Determinism (3.11) (push) Failing after 1s
Fix-Marker Regression Guard / Verify fix markers (push) Failing after 1s
ADR-115 MQTT integration tests / mqtt-integration (push) Failing after 1s
npm packages / harness/ruview (node 20) (push) Failing after 1s
npm packages / tools/ruview-mcp (node 20) (push) Failing after 1s
npm packages / tools/ruview-cli (node 20) (push) Failing after 1s
npm packages / tools/ruview-cli (node 22) (push) Failing after 1s
BFLD MQTT Integration / cargo test --features mqtt (live mosquitto) (push) Failing after 29s
ruview-swarm CI guard / build train_marl bin (push) Failing after 2s
ruview-swarm CI guard / clippy (-D warnings, --no-deps) (push) Failing after 3s
ruview-swarm CI guard / tests (ruflo) (push) Failing after 1s
ruview-swarm CI guard / tests (train) (push) Failing after 2s
ruview-swarm CI guard / tests (default) (push) Failing after 2s
Point Cloud Viewer → GitHub Pages / build-and-deploy (push) Failing after 8s
ruview-swarm CI guard / ITAR / publish guard (push) Failing after 0s
wifi-densepose sensing-server → Docker Hub + ghcr.io / build · push · smoke-test (push) Failing after 1s
Continuous Deployment / Deploy to Production (push) Has been cancelled
Continuous Deployment / Rollback Deployment (push) Has been cancelled
Continuous Deployment / Post-deployment Monitoring (push) Has been cancelled
Continuous Deployment / Notify Deployment Status (push) Has been cancelled
Continuous Deployment / Deploy to Staging (push) Has been cancelled
Security Scanning / Security Report (push) Has been cancelled
70 lines
2.4 KiB
Markdown
70 lines
2.4 KiB
Markdown
# @ruvnet/homecore-frontend
|
|
|
|
HOMECORE web UI — built with Lit 3, TypeScript, and Vite.
|
|
Design system mirrors the cognitum-v0 / v0-appliance dashboard (ADR-131).
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
cd frontend
|
|
npm install
|
|
npm run dev # http://localhost:5173
|
|
```
|
|
|
|
The Vite dev server proxies `/api` → `http://localhost:8123`, so you need a
|
|
`homecore-api-server` (or the `wifi-densepose-sensing-server` crate) running on `:8123`.
|
|
|
|
## Scripts
|
|
|
|
| Script | Description |
|
|
|--------|-------------|
|
|
| `npm run dev` | Start Vite dev server on port 5173 |
|
|
| `npm run build` | TypeScript compile + Vite production bundle → `dist/` |
|
|
| `npm run lint` | ESLint on `src/` |
|
|
| `npm test` | Vitest unit tests (3 suites, jsdom) |
|
|
|
|
## Package layout
|
|
|
|
```
|
|
frontend/
|
|
src/
|
|
api/
|
|
client.ts # fetch + WebSocket client (REST + WS)
|
|
types.ts # TypeScript types matching homecore-api JSON shapes
|
|
components/
|
|
AppShell.ts # <hc-app-shell> — header + nav + content slot
|
|
StateCard.ts # <hc-state-card> — single entity state card
|
|
icons/
|
|
lucide.ts # Tree-shaken Lucide icon wrapper
|
|
styles/
|
|
tokens.css # 16 CSS custom properties (--hc-*)
|
|
base.css # Typography reset, page shell, nav layout
|
|
__tests__/ # Vitest unit tests
|
|
index.html # Shell loading src/main.ts
|
|
vite.config.ts
|
|
tsconfig.json
|
|
vitest.config.ts
|
|
```
|
|
|
|
## Design system
|
|
|
|
Colors, typography, and components mirror the cognitum-v0 dashboard
|
|
(`http://cognitum-v0:9000/`). Dark-only; no light-mode. Key tokens:
|
|
|
|
- `--hc-primary` `#19d4e5` — teal (active nav, focus ring, CTA borders)
|
|
- `--hc-accent` `#26d867` — green (success, secondary CTA)
|
|
- `--hc-bg` `#0b0e13` — near-black navy page root
|
|
- Font: Outfit (display) + JetBrains Mono (mono)
|
|
- Icons: Lucide (SVG, `stroke: currentColor`, no icon font)
|
|
|
|
See `docs/design/HOMECORE-FRONTEND-design-recon.md` for the full recon.
|
|
|
|
## Architecture notes
|
|
|
|
- Components are standard Lit `LitElement` custom elements — compatible with
|
|
any HTML page and with Home Assistant's Lit-based frontend.
|
|
- The REST client uses `fetch`; the WS client uses `WebSocket`. Both accept a
|
|
bearer token and are fully typed against the Rust `homecore-api` JSON shapes.
|
|
- WASM: `vite.config.ts` enables `.wasm` asset import. Hook up via dynamic
|
|
`import('/path/to/module.wasm?init')` when WASM bindings are ready.
|