Chapter 3
Write in the margin. Never shout.
inspired
暖白纸与衬线标题,像一间安静的书房。
什么是 DESIGN.md适合: 笔记、知识库、协作文档
不适合: 电竞、交易终端
在仓库根目录执行。npm 上的 driftless 是别人的计时库。带 --skill 会同时写入 Cursor 和 Claude 的技能目录。
npx driftless-styles add warm-desk
npx driftless-styles add warm-desk --skill
{
"mcpServers": {
"driftless": {
"command": "npx",
"args": ["-y", "driftless-mcp"]
}
}
}书桌文库
Specimen
The quick brown fox
---
version: alpha
name: 暖白书桌 Warm Desk
description: 暖白纸与衬线标题,像一间安静的书房。
colors:
primary: "#EB5757"
secondary: "#78716C"
tertiary: "#2F3437"
background: "#F7F6F3"
surface: "#FFFFFF"
onPrimary: "#F4F4F5"
onSecondary: "#F4F4F5"
onTertiary: "#F4F4F5"
onBackground: "#18181B"
onSurface: "#18181B"
outline: "#E8E4DC"
muted: "#78716C"
success: "#0F7B6C"
warning: "#B45309"
error: "#EB5757"
typography:
h1:
fontFamily: Fraunces
fontSize: 40px
fontWeight: 600
lineHeight: 1.12
letterSpacing: -0.03em
h2:
fontFamily: Fraunces
fontSize: 28px
fontWeight: 600
lineHeight: 1.2
letterSpacing: -0.02em
h3:
fontFamily: Fraunces
fontSize: 20px
fontWeight: 600
lineHeight: 1.3
letterSpacing: -0.01em
body:
fontFamily: Geist
fontSize: 16px
fontWeight: 400
lineHeight: 1.55
letterSpacing: 0em
label:
fontFamily: Geist
fontSize: 13px
fontWeight: 500
lineHeight: 1.3
letterSpacing: 0.02em
caption:
fontFamily: Geist
fontSize: 12px
fontWeight: 400
lineHeight: 1.4
letterSpacing: 0em
mono:
fontFamily: JetBrains Mono
fontSize: 13px
fontWeight: 500
lineHeight: 1.45
letterSpacing: 0em
rounded:
sm: 4px
md: 8px
lg: 12px
xl: 20px
full: 999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
2xl: 48px
3xl: 64px
components:
navbar:
backgroundColor: "{colors.background}"
textColor: "{colors.onBackground}"
hero:
backgroundColor: "{colors.background}"
textColor: "{colors.onBackground}"
search:
backgroundColor: "{colors.surface}"
textColor: "{colors.muted}"
rounded: "{rounded.full}"
height: 44px
list-item:
backgroundColor: "{colors.surface}"
textColor: "{colors.onSurface}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.onSurface}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
footer:
backgroundColor: "{colors.background}"
textColor: "{colors.muted}"
---
# 暖白书桌 Warm Desk
## Overview
暖白纸与衬线标题,像一间安静的书房。 整体气质是 日常应用适中、错落不对称、动效 克制静止。品牌语气:warm / literary / calm。密度 5/10,变化 4/10,动效 3/10。 材质:书桌暖白、衬线标题、文档栏,像打开的笔记本。
How to use: 把本文件放到仓库根目录。在 Cursor / Claude Code / Codex 提示词中写:请阅读 DESIGN.md 并严格遵守其中的 tokens 与 Do/Don't。
## Colors
Semantic roles for the light theme. Keep a single accent; do not introduce a second brand hue.
- **primary** (`#EB5757`)
- **secondary** (`#78716C`)
- **tertiary** (`#2F3437`)
- **background** (`#F7F6F3`)
- **surface** (`#FFFFFF`)
- **outline** (`#E8E4DC`)
- **muted** (`#78716C`)
- **success** (`#0F7B6C`)
- **warning** (`#B45309`)
- **error** (`#EB5757`)
- **onPrimary** (`#F4F4F5`)
- **onSecondary** (`#F4F4F5`)
- **onTertiary** (`#F4F4F5`)
- **onBackground** (`#18181B`)
- **onSurface** (`#18181B`)
## Typography
Hierarchy comes from weight and size, not from shouting. Body line length stays near 65 characters.
- **h1**: Fraunces 600 / 40px / 1.12 / -0.03em
- **h2**: Fraunces 600 / 28px / 1.2 / -0.02em
- **h3**: Fraunces 600 / 20px / 1.3 / -0.01em
- **body**: Geist 400 / 16px / 1.55 / 0em
- **label**: Geist 500 / 13px / 1.3 / 0.02em
- **caption**: Geist 400 / 12px / 1.4 / 0em
- **mono**: "JetBrains Mono" 500 / 13px / 1.45 / 0em
## Layout
Spacing scale: xs=4px, sm=8px, md=16px, lg=24px, xl=32px, 2xl=48px, 3xl=64px.
iOS:触控目标 ≥ 44pt,尊重 Safe Area 与 Dynamic Type,图标用 SF Symbols,导航使用 Large Title / 分组列表。
Web:移动优先,<768px 单列,正文 ≥ 16px,标题用 clamp(),容器 max-width 约 1120–1400px,全高区块用 min-h-[100dvh]。
Every element occupies its own spatial zone. No overlapping hero text. Collapse multi-column layouts below 768px.
## Elevation & Depth
- sm: `0 1px 2px rgba(24,24,27,0.06)`
- md: `0 8px 24px rgba(24,24,27,0.08)`
- lg: `0 18px 48px rgba(24,24,27,0.12)`
- surface: `paper`
- recipe: 书桌暖白、衬线标题、文档栏,像打开的笔记本。
阴影带背景色相。高密度布局可用细分隔线代替卡片。
动效已接线:按钮按下、开关、滑杆和画布明暗使用 200ms / cubic-bezier(0.22, 1, 0.36, 1),弹簧 stiffness 100 / damping 20。液态/黏土按压用弹性;野兽按下吃掉硬偏移;新拟态按下变内凹。
没有额外的氛围循环。循环氛围在 prefers-reduced-motion 时停止;按下仍可以一次到位。
## Shapes
Radius scale: sm=4px, md=8px, lg=12px, xl=20px, full=999px.
## Components
- **导航栏** (`web.navbar` / default / md): 桌面横导航含 logo、带图标的链接和一个主 CTA。
- **Hero** (`web.hero` / left / lg): Hero 使用 left 布局,最多一个主 CTA,禁止「Scroll to explore」。
- **搜索栏** (`search` / default / md): 圆角搜索框,高度 44,占位符用 muted。
- **列表行** (`list-item` / chevron / md): 行高至少 44pt,标题 + 说明,右侧可放 chevron。
- **列表行** (`list-item` / chevron / md): 行高至少 44pt,标题 + 说明,右侧可放 chevron。
- **列表行** (`list-item` / chevron / md): 行高至少 44pt,标题 + 说明,右侧可放 chevron。
- **卡片** (`card` / outline / md): 卡片只在需要层级时使用,阴影带背景色相。
- **页脚** (`web.footer` / default / md): 页脚克制,链接分组清晰。
## Do's and Don'ts
### Do
- 组件里用语义色 token,不要写死 hex。
- 只留一个强调色;层级靠字重和留白。
- 写清默认、悬停、焦点、按下、禁用和加载状态。
- 正文和可交互标签达到 WCAG 2.2 AA 对比度。
- 触控区域在 iOS 至少 44×44pt,在网页至少 44px。
### Don't
- 高级感的展示标题不要用 Inter。
- 大面积不要用纯黑 #000000。
- 不要加霓虹外发光,也不要自定义鼠标光标。
- 不要把三张等宽功能卡当成默认布局。
- 不要藏掉焦点环,也不要低于 AA 对比度。