AI UI Atlas
Mapping interface systems
给 coding agent 时可以直接复制下面这段,作为 UI 风格约束。
# Ink and Paper## UsageUse this DESIGN.md as a reusable design brief for an AI coding agent. Apply it when building a new page, restyling an existing interface, or keeping multiple screens visually consistent.## Design IntentYou are implementing an interface using the **Ink and Paper** design language. 用墨色文字、纸面留白、手写线条和轻微晕染建立文化、阅读和创作产品的安静气质。Treat surface, depth, light, and texture as the main carrier of brand expression.## Aliases- 墨水纸面- ink wash UI## Category- 材质与表面## Target Platforms- 移动端- PC 端## Summary用墨色文字、纸面留白、手写线条和轻微晕染建立文化、阅读和创作产品的安静气质。## Visual DNA- 墨色对比- 手写线条- 纸面留白- 轻微晕染## Best Use Cases- 写作工具- 文化内容- 诗歌阅读- 艺术作品集## Avoid When交易转化、密集表格、强按钮操作或年轻潮流营销页。## Anatomy核心是黑白灰层次和线条节奏;如果加入东方元素,要保持克制,避免变成表面符号堆叠。## Color SystemUse a Seed → Map → Semantic → Alias token architecture. Components must consume named tokens instead of hard-coded colors.### Reference Palette- **reference-1** `#fbfaf6`- **reference-2** `#e7e5df`- **reference-3** `#9ca3af`- **reference-4** `#111827`- **reference-5** `#475569`### Seed Tokens- **colorBgBase** `#fbfaf6` - 页面基础背景.- **colorBgContainer** `#f3f2ef` - 卡片、面板与容器.- **colorFillSecondary** `#e8e8e5` - 次级填充与弱状态.- **colorPrimary** `#475569` - 品牌主操作与选中态.- **colorTextBase** `#111827` - 正文、图标与高对比轮廓.### Primary Scale- **primary-1** `#e9eae8`- **primary-2** `#d3d6d7`- **primary-3** `#babfc3`- **primary-4** `#9da4ad`- **primary-5** `#798390`- **primary-6** `#475569`- **primary-7** `#414e61`- **primary-8** `#3a4659`- **primary-9** `#343f51`- **primary-10** `#2c3748`### Neutral Scale- **neutral-1** `#fbfaf6`- **neutral-2** `#f2f1ee`- **neutral-3** `#e8e8e5`- **neutral-4** `#d6d6d5`- **neutral-5** `#b9bbbc`- **neutral-6** `#999b9f`- **neutral-7** `#73777e`- **neutral-8** `#535761`- **neutral-9** `#323844`- **neutral-10** `#111827`### Semantic Tokens- **colorSuccess** `#16a34a` - 成功、在线、已完成.- **colorSuccessBg** `#e0f0e1` - 成功状态浅背景.- **colorWarning** `#d97706` - 警告、待确认、需关注.- **colorWarningBg** `#f7ead9` - 警告状态浅背景.- **colorError** `#dc2626` - 错误、危险、阻断.- **colorErrorBg** `#f8e5e1` - 错误状态浅背景.- **colorInfo** `#475569` - 信息、链接、进行中.- **colorInfoBg** `#e5e6e5` - 信息状态浅背景.### Alias Tokens- **colorBgLayout** `#f6f6f2` - 应用整体画布.- **colorBgElevated** `#f4f3f0` - 弹层、浮层与菜单.- **colorBgSpotlight** `#323844` - Tooltip 与强提示.- **colorBorder** `#d6d6d5` - 控件与容器边框.- **colorBorderSecondary** `#e8e8e5` - 轻分隔线.- **colorText** `#111827` - 一级文本.- **colorTextSecondary** `#5c6069` - 二级文本.- **colorTextTertiary** `#86898f` - 辅助说明.- **colorTextDisabled** `#abadb0` - 禁用文本.- **colorPrimaryHover** `#798390` - 主操作 Hover.- **colorPrimaryActive** `#414e61` - 主操作 Active.- **colorPrimaryBorder** `#9da4ad` - 主色边框.- **colorPrimaryBg** `#e9eae8` - 主色浅背景.- **colorLink** `#475569` - 链接与可跳转文本.- **colorFocus** `#9da4ad` - 键盘焦点环.- **colorMask** `#0c111c` - Modal 遮罩基础色.Color rules:- Use the palette as design tokens, not random decorative swatches.- Keep primary text and primary actions at accessible contrast.- Use primary-1 through primary-10 for interaction states instead of inventing new brand colors.- Use semantic tokens consistently for success, warning, error, and info; pair color with iconography or text.- Map component styles to Alias Tokens so theme changes do not require component-level color edits.## Typography- Use a restrained system sans or editorial serif/sans pairing only when the product explicitly benefits from publication-like rhythm.- Headlines can be large, but body copy must stay calm: 16-18px on desktop, 15-17px on mobile, line-height around 1.55-1.75.- Use weight changes sparingly; rely on size, spacing, and alignment before adding decoration.## Layout And Spacing- Use generous whitespace: 24-32px section gaps on mobile, 48-96px on desktop depending on content density.- Keep reading widths controlled; avoid full-width paragraphs.- Let spacing create hierarchy before adding borders, shadows, or accent blocks.- Recommended radius: 6-12px radius by default; increase only for expressive or highly tactile components.- Elevation and shadow: Use shadows to separate interactive or elevated surfaces only; avoid stacking many shadow styles.## Component Rules- Components should make the surface logic visible: panels, buttons, inputs, and overlays need consistent material treatment.- Primary actions must be visually obvious and reachable; secondary actions should be quieter but still discoverable.- Cards need a clear title, supporting text or metric, state, and one obvious next action when action is expected.- Forms and filters should use familiar controls, stable dimensions, clear labels, and visible focus states.- Empty, loading, error, and success states must use the same visual language, not generic placeholders.## Interaction And Motion- Use subtle 120-220ms transitions for hover, focus, open, close, and selection states.- Motion should clarify state changes rather than decorate the page.- Respect reduced-motion preferences.## Implementation Recipe1. Start with the real user workflow and page structure; do not make a generic landing page unless explicitly requested.2. Establish layout zones first: navigation, content, controls, feedback, and primary action.3. Apply the color tokens to semantic roles: canvas, surface, text, border, accent, danger, and success.4. Build reusable components that express this style: buttons, cards, inputs, tabs, filters, modals, empty states, and status badges.5. Verify mobile and desktop breakpoints before adding decorative polish.6. Check that the final screen still communicates 墨色对比, 手写线条, 纸面留白 without relying on a single color or effect.## Quality Checklist- The screen is immediately recognizable as **Ink and Paper**, not a generic Tailwind layout.- The design uses surface, spacing, typography, and component shape together; it does not rely only on colors.- Primary actions and navigation are clear on both mobile and desktop.- Text is readable, controls are stable, and content does not overlap or shift unexpectedly.- Empty, loading, hover, focus, selected, disabled, success, and error states are styled in the same language.- The implementation avoids the known failure mode: 交易转化、密集表格、强按钮操作或年轻潮流营销页。## Anti-Patterns- Do not paste this palette onto an unrelated layout and call it finished.- Do not overuse decorative effects where the user needs to read, compare, or act quickly.- Do not mix this style with unrelated visual languages unless the product explicitly requires a hybrid.- Do not hide important state behind low contrast, blur, tiny text, or animation.## Keywords- ink- paper- writing- culture- minimal## Agent Prompt SnippetImplement the UI in the **Ink and Paper** design language. Prioritize 墨色对比, 手写线条, 纸面留白. Use the color roles, typography guidance, spacing rules, component rules, and anti-patterns from this DESIGN.md as hard constraints. The result should feel purpose-built for 写作工具, 文化内容, 诗歌阅读, while avoiding: 交易转化、密集表格、强按钮操作或年轻潮流营销页。