Glassmorphism

# Glassmorphism## 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 **Glassmorphism** design language. 通过毛玻璃模糊、低透明白、环境色阴影和背景参与制造层叠玻璃片，重点是轻盈、漂浮和空间纵深。Treat surface, depth, light, and texture as the main carrier of brand expression.## Aliases- 玻璃拟态- frosted glass## Category- 材质与表面## Target Platforms- 移动端- PC 端## Summary通过毛玻璃模糊、低透明白、环境色阴影和背景参与制造层叠玻璃片，重点是轻盈、漂浮和空间纵深。## Visual DNA- backdrop blur- 透明白- 环境色投影- 背景参与## Best Use Cases- 登录页- 天气组件- 音乐卡片- 浮层导航## Avoid When背景很杂、文本很多、需要强对比阅读或低端设备渲染压力大。## Anatomy玻璃本身不是重点，背景渐变和元素层级才决定质感；优先依靠透明度、blur 与环境色投影分层，只有相邻层级不清时才使用低对比同色边界，避免白色描边和内高光围成塑料封边；文字必须额外加深。## Color SystemUse a Seed → Map → Semantic → Alias token architecture. Components must consume named tokens instead of hard-coded colors.### Reference Palette- **reference-1** `#ffffff`- **reference-2** `#e0f2fe`- **reference-3** `#bae6fd`- **reference-4** `#7dd3fc`- **reference-5** `#0f172a`### Seed Tokens- **colorBgBase** `#ffffff` - 页面基础背景.- **colorBgContainer** `#f7f7f8` - 卡片、面板与容器.- **colorFillSecondary** `#ececee` - 次级填充与弱状态.- **colorPrimary** `#7dd3fc` - 品牌主操作与选中态.- **colorTextBase** `#0f172a` - 正文、图标与高对比轮廓.### Primary Scale- **primary-1** `#f2fbff`- **primary-2** `#e2f5fe`- **primary-3** `#d0effe`- **primary-4** `#bbe8fd`- **primary-5** `#a1dffd`- **primary-6** `#7dd3fc`- **primary-7** `#70bce3`- **primary-8** `#63a6ca`- **primary-9** `#558fb0`- **primary-10** `#467593`### Neutral Scale- **neutral-1** `#ffffff`- **neutral-2** `#f5f6f6`- **neutral-3** `#ececee`- **neutral-4** `#d9dadd`- **neutral-5** `#bcbec3`- **neutral-6** `#9a9ea6`- **neutral-7** `#747883`- **neutral-8** `#525866`- **neutral-9** `#313748`- **neutral-10** `#0f172a`### Semantic Tokens- **colorSuccess** `#16a34a` - 成功、在线、已完成.- **colorSuccessBg** `#e3f4e9` - 成功状态浅背景.- **colorWarning** `#d97706` - 警告、待确认、需关注.- **colorWarningBg** `#faefe1` - 警告状态浅背景.- **colorError** `#dc2626` - 错误、危险、阻断.- **colorErrorBg** `#fce9e9` - 错误状态浅背景.- **colorInfo** `#7dd3fc` - 信息、链接、进行中.- **colorInfoBg** `#effaff` - 信息状态浅背景.### Alias Tokens- **colorBgLayout** `#fafafb` - 应用整体画布.- **colorBgElevated** `#f8f8f9` - 弹层、浮层与菜单.- **colorBgSpotlight** `#313748` - Tooltip 与强提示.- **colorBorder** `#d9dadd` - 控件与容器边框.- **colorBorderSecondary** `#ececee` - 轻分隔线.- **colorText** `#0f172a` - 一级文本.- **colorTextSecondary** `#5c616e` - 二级文本.- **colorTextTertiary** `#878b95` - 辅助说明.- **colorTextDisabled** `#adb0b7` - 禁用文本.- **colorPrimaryHover** `#a1dffd` - 主操作 Hover.- **colorPrimaryActive** `#70bce3` - 主操作 Active.- **colorPrimaryBorder** `#bbe8fd` - 主色边框.- **colorPrimaryBg** `#f2fbff` - 主色浅背景.- **colorLink** `#7dd3fc` - 链接与可跳转文本.- **colorFocus** `#bbe8fd` - 键盘焦点环.- **colorMask** `#0b111e` - 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 modern system sans-serif stack by default; only introduce a custom font when the brand direction requires it.- Headings should be confident but not ornamental; body text must remain readable across mobile and desktop.- Keep labels short, high-contrast, and aligned to the component structure.## Layout And Spacing- Use an 8px spacing base; reserve 4px for micro-gaps and 32px+ for major layout separation.- Keep cards, panels, controls, and lists dimensionally stable across responsive breakpoints.- On mobile, reduce column count before reducing legibility.- Recommended radius: 16-32px radius for major surfaces; use pill shapes only where they improve touch targets or softness.- Elevation and shadow: Use environment-tinted outer shadows and backdrop blur for elevation. Avoid closed white perimeter borders and full inset highlights that make glass look plastic; add a low-contrast same-color edge only when adjacent layers cannot separate. Contrast must come from text and component state, not blur alone.## 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 slow, soft transitions for surface changes, highlights, and overlays.- Avoid constant background motion behind readable text.- Respect reduced-motion preferences and provide a static equivalent.## 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 backdrop blur, 透明白, 环境色投影 without relying on a single color or effect.## Quality Checklist- The screen is immediately recognizable as **Glassmorphism**, 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- glass- frosted- blur- transparent## Agent Prompt SnippetImplement the UI in the **Glassmorphism** design language. Prioritize backdrop blur, 透明白, 环境色投影. 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: 背景很杂、文本很多、需要强对比阅读或低端设备渲染压力大。