mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-16 12:15:57 +00:00
Tam Nhu Tran
e64060fe0d
PR-Agent flagged two more real regressions vs the original health page: 1. Stale timestamp (HealthStatusRibbon): formatRelativeTime reads Date.now() during render, but nothing forces a re-render after mount so the 'last scan' label froze and never advanced to '1 minute ago', '2 hours ago', etc. Restore the per-second tick (matching the original health.tsx behavior) so the label behaves like a real relative timestamp. 2. Hidden copy action (HealthPriorityCard): the fix-copy button was gated by group-hover, making it invisible to keyboard users and unreachable on mobile (no hover state). Make it always visible with an aria-label so screen-reader and touch users can copy the fix command.
CCS Dashboard UI
React + TypeScript + Vite frontend for the CCS local dashboard.
This UI is served by the CCS web server and is accessed via:
ccs config
Development
From project root:
bun run dev
This starts the CCS server, opens a local browser URL, and prints bind/network details for the dashboard. If the runtime bind is reachable beyond loopback, CCS also prints an auth reminder.
For remote device access during development, run:
bun run dev -- --host 0.0.0.0
For local-only development, run:
bun run dev -- --host 127.0.0.1
From ui/ only (frontend dev server):
cd ui
bun run dev
Quality Commands
cd ui
bun run typecheck
bun run lint
bun run validate
bun run test:run
i18n
Dashboard localization uses react-i18next.
- Main setup:
ui/src/lib/i18n.ts - Locale helpers:
ui/src/lib/locales.ts - Language switcher:
ui/src/components/layout/language-switcher.tsx
For full architecture, conventions, and locale onboarding, see:
Notes
- UI locale persistence uses browser localStorage key
ccs-ui-locale. - Current supported locales are managed in
ui/src/lib/locales.ts. - Current locales:
en,zh-CN,vi. - Fallback locale is English (
en).