ccs/ui/README.md

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 and serves the dashboard at http://localhost:3000.

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:

• ../docs/i18n-dashboard.md

---

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).