docs: add ui design guide

This commit is contained in:
2026-07-19 18:49:20 +08:00
parent d538627272
commit 8f2b8c9585
2 changed files with 239 additions and 0 deletions

View File

@@ -241,6 +241,18 @@ MVP 限制:
- 状态徽标不能只依赖颜色表达。
- 表单错误需要文本说明,并通过 `aria-live` 或等价方式通知。
## 视觉风格
UI 视觉风格参考 shadcn/ui 的克制、清晰、组件化表达,但前端仍只使用 Svelte不引入 React 或 shadcn/ui 依赖。视觉统一规则以仓库根目录 `design.md` 为准。
后续页面和组件应遵循:
- 中性色为主,少量品牌色用于选中态、主按钮和关键状态。
- 卡片、输入框、列表、tabs、菜单、弹窗等控件保持一致的边框、圆角、间距和焦点状态。
- 工作台页面优先信息密度和可扫描性,避免营销页式大 hero、装饰性渐变和过度卡片化。
- 图标优先使用语义明确的按钮图标,文字仅用于清晰命令或需要解释的动作。
- 每个频道页面可以有不同布局,但基础控件和状态表达必须一致。
## 技术落点
前端仍使用 Svelte 和 TypeScript不引入 React。