01 / 03

Cafe

适合咖啡馆、烘焙店、餐饮菜单和预约页，暖白与咖啡棕配柔和圆体和整洁留白，舒适松弛而有生活感。

通用设计极简主义

设计语言预览

Warm Foundation

Coffee Brown

#5d4432

主行动、品牌标记和高对比深色表面。

Warm Gray

#e9e3dd

柔和分区、选中项和次级功能表面。

Cafe Surface

#f9f7f5

页面画布与低层级卡片，营造轻暖环境。

White

#ffffff

主要内容卡片和需要清晰分离的阅读区域。

Cocoa Text

#3e2b1e

标题、正文、边框和浅色表面上的控件文字。

Semantic Status

Success

#16a34a

仅表达完成、可用和确认状态，并同时显示文字。

Warning

#d97706

仅表达待确认、临近和注意状态。

Danger

#dc2626

仅表达错误、阻断和破坏性操作。

字体层级

display-calm

Poppins · 64 / 600 / -4%

慢下来，读完这一章。

heading-section

Poppins · 40 / 600 / -3%

温暖而清楚的浏览节奏

body-relaxed

Poppins · 16 / 400 / 1.6

文案简洁、自信、有帮助，给内容留下舒适呼吸空间。

label-caps

JetBrains Mono · 12 / 600 / +8%

OPEN DAILY · 08:00–20:00 · 6 SEATS OPEN

间距、层级与形状

2xs 2px

xs 4px

sm 8px

md 12px

lg 16px

xl 24px

2xl 32px

3xl 48px

形状

full

按钮和小控件使用 4px，卡片与主要容器使用 8px；用细边框和色面区分层级，避免 pill 与厚阴影。

层级

Level 0 · #f9f7f5 暖白画布Level 1 · 白色或暖灰功能表面Level 2 · 1px 暖灰边框，最多极轻阴影

组件样张

button-primary

咖啡棕填充、白色文字、4px 圆角和至少 44px 高度，承担主行动。

button-secondary

透明或白底、1px 咖啡棕边框，用于次级浏览。

button-icon

预约状态同时使用文字和柔和色面，并覆盖 default、hover、focus-visible、active、disabled、loading 与 error。

text-input 搜索内容

content-row

一行核心内容保持清晰标题。

元信息 · 状态 · 更新时间

布局与响应式

用留白和温暖表面降低认知压力，不用装饰制造氛围。

桌面端使用舒展双栏与清晰卡片分组；平板减少并列卡片；移动端按标题、说明、行动、内容顺序折叠为单列，并保留舒适触控间距。

断点	宽度	关键变化
移动端	< 768 px	标题缩放至 40-44px，卡片与操作单列，触控目标至少 44px。
平板	768 - 1099 px	使用双栏内容分组，主要模块可跨两栏，辅助导航收起。
桌面端	>= 1100 px	使用 48px 主要区间距、双栏首屏和 64px 表现型标题。

使用边界

应该

以 #f9f7f5 暖白画布、#e9e3dd 柔和分区和 #5d4432 主行动建立舒适层级。
Poppins 承担标题与正文，JetBrains Mono 只用于时间、状态和短标签。
使用 2/4/8/12/16/24/32/48 间距级差，保持整洁而放松的节奏。
按钮使用 4px，卡片和主要容器使用 8px，边界轻而明确。
让标签、时间、可用数量和操作名称保持具体且易理解。
所有交互提供可见 focus-visible 状态，并保证文字满足 WCAG AA。

不要

不要用大量功能、密集表格或复杂装饰破坏放松浏览体验。
不要使用冷灰、霓虹、高饱和多色或规范之外的强调色。
不要使用过大的 pill、玻璃拟态、发光或厚重阴影。
不要用过轻或过小的暖灰文字造成低对比。
不要让 Poppins 标题挤压正文；桌面优先字号在移动端必须平稳缩放。
不要只用颜色表示预约或库存状态，必须同步显示文字。

---
name: Cafe
colors:
  primary: "#5D4432"
  secondary: "#E9E3DD"
  success: "#16A34A"
  warning: "#D97706"
  danger: "#DC2626"
  surface: "#F9F7F5"
  text: "#3E2B1E"
  neutral: "#F9F7F5"
typography:
  h1:
    fontFamily: "Poppins"
    fontSize: 3rem
  body-md:
    fontFamily: "Poppins"
    fontSize: 1rem
  label-caps:
    fontFamily: "JetBrains Mono"
    fontSize: 0.75rem
  sourceScale: "desktop-first expressive scale"
  weights: "100, 200, 300, 400, 500, 600, 700, 800, 900"
rounded:
  sm: 4px
  md: 8px
spacing:
  sm: 2px
  md: 4px
  sourceScale: "2/4/8/12/16/24/32/48"
---

## 概览

咖啡馆氛围的舒适界面：暖色调、柔和字体与整洁版式，营造放松的浏览体验。

## 风格基础

- **视觉风格：** 极简、干净
- **字号级差：** 桌面优先的富表现字号级差
- **字体：** primary=Poppins, display=Poppins, mono=JetBrains Mono
- **字重：** 100, 200, 300, 400, 500, 600, 700, 800, 900
- **色板：** 主色、中性、成功、警告、危险
- **间距级差：** 2/4/8/12/16/24/32/48

## 色板

- **Primary (#5D4432)：** 来自"风格基础"的 Token。
- **Secondary (#E9E3DD)：** 来自"风格基础"的 Token。
- **Success (#16A34A)：** 来自"风格基础"的 Token。
- **Warning (#D97706)：** 来自"风格基础"的 Token。
- **Danger (#DC2626)：** 来自"风格基础"的 Token。
- **Surface (#F9F7F5)：** 来自"风格基础"的 Token。
- **Text (#3E2B1E)：** 来自"风格基础"的 Token。
- **Neutral (#F9F7F5)：** 由 surface Token 派生，以兼容官方格式。

## 技能指引

<!-- TYPEUI_SH_MANAGED_START -->
# Cafe 设计体系技能（通用）

## 使命
你是 Cafe 的资深设计体系规范作者。
输出可直接落地、工程师和设计师都能直接用的实用规范。

## 品牌

咖啡馆式的舒适界面，融合暖色调、柔字体与整洁版式，打造放松的浏览体验。

## 风格基础
- 视觉风格：极简、干净
- 字号级差：桌面优先的富表现字号级差 | 字体：primary=Poppins, display=Poppins, mono=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
- 色板：主色、中性、成功、警告、危险 | Tokens：primary=#5D4432, secondary=#E9E3DD, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#F9F7F5, text=#3E2B1E
- 间距级差：2/4/8/12/16/24/32/48

## 无障碍
WCAG 2.2 AA、键盘优先交互、可见的焦点状态

## 文字调性
简洁、自信、有帮助

## 规则：应当
- 优先使用语义 Token 而非原始值
- 保持视觉层级
- 让交互状态明确可见

## 规则：不应
- 避免低对比度文字
- 避免不一致的间距节奏
- 避免含义模糊的标签

## 期望行为
- 先遵循风格基础，再关注组件一致性。
- 不确定时，优先无障碍与清晰度，而非追求新颖感。
- 提供具体默认值，并在存在备选方案时说明取舍。
- 保持规范鲜明、精简，且面向实现。

## 规范撰写流程
1. 在提出规则前，先用一句话复述设计意图。
2. 先定义 Token 与基础约束，再给出组件级规范。
3. 明确组件结构、状态、变体与交互行为。
4. 包含无障碍验收标准与文案撰写要求。
5. 补充反模式，以及既有不一致 UI 的迁移建议。
6. 以一份可在代码评审中执行的 QA 清单收尾。

## 输出结构要求
生成设计体系规范时，请按以下结构组织：
- 背景与目标
- 设计 Token 与基础
- 组件级规则（涵盖结构、变体、状态与响应式行为）
- 无障碍要求与可测试的验收标准
- 文案与调性规范，附具体示例
- 反模式与不允许的实现
- QA 清单

## 组件规则要求
- 定义必须实现的状态：default、hover、focus-visible、active、disabled、loading、error（视需要）。
- 描述键盘、指针与触屏下的交互行为。
- 明确说明间距、字体与色彩 Token 的使用方式。
- 覆盖响应式行为与边界场景（如长标签、空态、内容溢出）。

## 质量门禁
- 规则不应只依赖含糊形容词；必须以 Token、阈值或示例作为锚点。
- 每一条无障碍主张，在实现中都必须可测试。
- 优先保证体系一致，而非局部的一次性优化。
- 当美观与无障碍冲突时明确指出，并以无障碍为先。

## 约束语言示例
- 用"必须"表述不可协商的规则，用"应"表述建议。
- 每条"应当"规则至少配一个具体的"不应"反例。
- 引入新模式时，同步提供既有组件的迁移指引。

<!-- TYPEUI_SH_MANAGED_END -->