适合人群
- 使用 AI 编码代理(Cursor、Claude Code、Copilot)生成 UI 的开发者
- 没有专职设计师的创业团队或独立开发者
- 想让 AI 生成的界面保持统一风格的前端工程师
- 对设计系统感兴趣,想学习知名品牌视觉规范的产品经理
准备清单
- 一个 AI 编码代理(推荐 Cursor、Claude Code 或 VS Code + Copilot)
- Node.js 18+ 环境(使用 npx CLI 工具时需要)
- 基本的前端开发知识(HTML/CSS)
- 一个需要开发 UI 的项目
Awesome DESIGN.md 是什么
Awesome DESIGN.md 是由 VoltAgent 团队维护的开源设计系统文档库,目前收录了 69 个知名品牌的完整设计规范,包括 Apple、Stripe、Vercel、Figma、Notion、Airbnb、Tesla 等。
项目已获得 63,900+ Stars,是 GitHub 上最受关注的 AI 设计资源之一。
核心理念很简单:把一个 DESIGN.md 文件放到项目根目录,然后告诉 AI 代理"按这个风格构建页面",就能获得风格一致、像素级精准的 UI。不需要 Figma 导出、不需要 JSON Schema、不需要额外工具。
一个 DESIGN.md 包含什么
每个设计文档遵循 9 大标准章节:
- Visual Theme & Atmosphere — 视觉主题与氛围,定义整体设计哲学
- Color Palette & Roles — 色彩系统,含语义名称 + 十六进制值 + 功能角色
- Typography Rules — 排版规则,字体族与完整层级表
- Component Stylings — 组件样式,按钮、卡片、输入框、导航及各状态
- Layout Principles — 布局原则,间距标尺、网格、留白哲学
- Depth & Elevation — 深度与层次,阴影系统、表面层级
- Do's and Don'ts — 设计守则,护栏与反模式
- Responsive Behavior — 响应式行为,断点、触摸目标、折叠策略
- Agent Prompt Guide — 代理提示指南,快速颜色参考、现成提示词
每个品牌的设计包还包含 preview.html(亮色模式预览)和 preview-dark.html(暗色模式预览)。
覆盖的品牌类别
| 类别 | 代表品牌 |
|---|---|
| AI/LLM | Claude、Mistral AI、xAI、ElevenLabs、RunwayML |
| 开发者工具 | Cursor、Vercel、Raycast、Warp、Expo |
| 后端/DevOps | Supabase、Sentry、PostHog、MongoDB、HashiCorp |
| 生产力/SaaS | Notion、Linear、Cal.com、Intercom、Zapier |
| 设计/创意 | Figma、Framer、Miro、Webflow、Airtable |
| 金融/加密 | Stripe、Coinbase、Binance、Revolut、Wise |
| 电商/零售 | Shopify、Airbnb、Nike、Starbucks |
| 媒体/消费 | Apple、Spotify、NVIDIA、SpaceX、Uber |
| 汽车 | Tesla、BMW、Ferrari、Lamborghini、Bugatti |
操作步骤
1. 选择目标风格
首先确定你想在项目中使用哪个品牌的设计风格。你可以访问 getdesign.md 在线浏览所有可用的设计系统,或者直接在 GitHub 仓库 的 design-md/ 目录下查看。
提示:选择与你项目调性接近的品牌。比如极简风选 Vercel,专业金融风选 Stripe,活力消费风选 Spotify。
2. 一键安装 DESIGN.md(推荐方式)
在你的项目根目录运行以下命令:
# 安装 Vercel 风格的设计系统
npx getdesign@latest add vercel
# 或者安装 Stripe 风格
npx getdesign@latest add stripe
# 或者安装 Notion 风格
npx getdesign@latest add notion
这条命令会自动下载 DESIGN.md 文件到你的项目根目录。
3. 手动复制(备选方式)
如果不想用 CLI,也可以手动操作:
- 访问 getdesign.md 网站
- 搜索目标品牌(如 "apple")
- 点击下载
DESIGN.md文件 - 将文件放到项目根目录
4. 让 AI 代理使用设计系统
在 Cursor、Claude Code 或其他 AI 编码代理中,直接提示:
请按照项目根目录的 DESIGN.md 文件中定义的设计系统,为我构建一个用户登录页面。
AI 代理会自动读取 DESIGN.md 中的色彩、字体、组件样式、布局规范,并生成完全符合该品牌风格的 UI 代码。
5. 预览与调色
每个设计包还附带 HTML 预览文件,可以直接在浏览器中打开查看:
preview.html— 亮色模式下的色板、字体、按钮、卡片效果preview-dark.html— 暗色模式效果
这些预览文件可以帮助你在开发前确认视觉效果。
6. 混合多个设计系统(进阶)
你可以组合不同品牌的设计元素。比如:
请使用 DESIGN.md 中的 Stripe 配色方案,但采用 Notion 的排版层级和布局间距。
手动合并多个 DESIGN.md 的章节内容即可实现。
实际效果对比
不使用 DESIGN.md
用户:给我做一个产品页面
AI:(随机选择颜色和字体,每次生成风格不一致)
使用 DESIGN.md
用户:按照 DESIGN.md 的 Apple 风格,给我做一个产品页面
AI:(严格遵循 Apple 的色彩、字体、组件规范,输出一致且专业的 UI)
常见问题
Q: DESIGN.md 和 Figma 有什么区别?
A: DESIGN.md 是纯文本(Markdown 格式),AI 编码代理可以直接读取并理解。Figma 是可视化设计工具,AI 代理无法直接读取 Figma 文件。DESIGN.md 的优势在于与 AI 工作流无缝集成,不需要导出或转换。
Q: 可以商用吗?会不会有版权问题?
A: 项目使用 MIT 许可证开源。DESIGN.md 是设计系统的文字描述,不是品牌素材本身。在项目中使用某个品牌的设计规范(如配色方案、间距规则)通常不构成版权问题,但建议不要直接复制品牌 Logo 或商标。
Q: 支持 Tailwind CSS 吗?
A: DESIGN.md 中定义的颜色、字体、间距等规范可以直接映射到 Tailwind 的配置中。AI 代理在生成代码时会自动适配你项目使用的 CSS 框架。你也可以参考 AI 编程基础教程 了解如何在 AI 编程工作流中更好地利用设计系统。
Q: 我想为某个不在列表中的网站生成 DESIGN.md,怎么做?
A: 项目提供定制请求服务。你可以在 GitHub 上开 Issue,请求为特定网站生成 DESIGN.md。也可以访问 getdesign.md 提交定制需求,包括私有网站在内。
Q: 每次换风格都需要重新下载吗?
A: 是的,每个项目只需要一个 DESIGN.md。如果你想切换风格,重新运行 npx getdesign@latest add <新品牌> 即可覆盖。你也可以在项目中保留多个设计文件,按需引用。
参考来源
下一步建议
- 了解如何用 AI 代理自动化更多工作流,推荐阅读 CLI-Anything:让所有软件支持 AI 代理
- 想用 AI 自动生成专业 PPT?查看 PPT Master:AI 自动生成原生 PPT
- 对 AI 开发工具生态感兴趣?阅读 Claude Code 完整配置教程
