awesome-design-md案例:PostHog刺猬品牌与开发者友好暗色UI设计
awesome-design-md案例:PostHog刺猬品牌与开发者友好暗色UI设计
【免费下载链接】awesome-design-mdA collection of DESIGN.md files analysis by popular brand design systems. Drop one into your project and let coding agents generate a matching UI.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-md
本文带你逐层拆解 awesome-design-md 精选集中的 PostHog 案例:知名开源产品分析工具 PostHog 如何用刺猬吉祥物、奶油色画布与暗色代码块构建出"友好工程手绘本"风格,以及你如何把这份 DESIGN.md 丢进项目,让 AI 编码 Agent 一键生成同款 UI。🦔
30秒了解 awesome-design-md 与 DESIGN.md 文件
- awesome-design-md是一个精选开源仓库,收录了 73 个流行网站的 DESIGN.md 设计系统分析文件,覆盖 PostHog、Stripe、Vercel 等知名品牌
- DESIGN.md是由 Google Stitch 提出的纯文本设计系统文档概念:它只记录颜色、字体、圆角、间距、组件规则等设计事实,任何 AI Agent 都能直接读懂
- 用法极简:把一份
DESIGN.md拷到你的项目根目录,告诉 AI"按这个风格帮我做页面",即可生成视觉一致的界面,无需 Figma 导出或特殊工具
在仓库的站点列表中,PostHog 的定位是:Playful hedgehog branding, developer-friendly dark UI(俏皮的刺猬品牌 + 开发者友好暗色 UI),这正是本文要拆解的两条主线。
刺猬品牌解析:奶油画布上的"教科书插画"
打开 design-md/posthog/DESIGN.md,你会发现这套设计最反直觉的一点:它主动拒绝了开发者工具常见的"冷峻暗黑科技风",转而走暖色手绘路线。
三大品牌支柱
| 支柱 | 关键做法 | 对应 Token |
|---|---|---|
| 奶油色画布 | 页面背景不是纯白,而是全程贯穿的暖奶油色,无任何阴影,卡片靠 1px 橄榄色细边框"平贴"在画布上 | canvas→#eeefe9 |
| 唯一高饱和色 | 全站只有一个黄橙色 CTA 胶囊按钮,深橄榄色文字,出现在导航"Get started"、定价按钮等所有主操作上 | primary→#f7a501 |
| 手绘刺猬吉祥物 | 穿白大褂的刺猬、终端前的刺猬、躺椅上的刺猬,像教科书页边涂鸦一样散布在布局中——装饰系统全靠它,没有渐变、没有氛围背景 | hedgehog-mascot-card |
字体策略同样克制:全站只用IBM Plex Sans Variable一款字体,用 400/500/600/700/800 五档字重制造层级——层级靠字重对比而非颜色,这正是"工程博客"气质的来源(详见 DESIGN.md 排版章节)。
开发者友好暗色UI的三个关键细节
PostHog 的暗色 UI 不是整站暗色,而是在暖色画布中精准放置暗色"岛屿",专为开发者阅读代码而生:
暗色代码块是系统里唯一的"高亮表面"代码块使用深橄榄炭黑
#23251d(与标题文字同色号,文字与暗面共用一个色),白色代码文字置于白底文档卡片内部,形成"暗色浮岛"——这是整个系统最有画面感的视觉时刻。规格见 code-block 组件定义。文档页专用 240px 粘性侧边栏文档页面在左侧固定 240px 边栏,顶部是"Ask PostHog AI"搜索框,每个产品板块配圆角线性小图标,正文列宽约 720px——典型为开发者优化的阅读布局。
四色柔和提示横幅管理信息层级长文档中用蓝(💡 Tip)、绿(✅ Success)、红(⚠️ Warning)、紫(📘 Info)四种柔和底色横幅做内联注解,且规则明确:它们只允许出现在文档正文,不能当营销卡片背景。
配套的"不要做"清单同样有参考价值:Do's and Don'ts 章节 直接写明"卡片禁止加投影""黄色 CTA 每屏最多一个""不要用通用图标集替换刺猬插画"——这些护栏正是 AI 生成 UI 时保持品牌一致性的关键。
一键上手:3步把 PostHog 风格用进你的项目
第 1 步:获取仓库
git clone https://gitcode.com/GitHub_Trending/aw/awesome-design-md第 2 步:拷贝设计文件
将design-md/posthog/DESIGN.md复制到你的项目根目录(与AGENTS.md平级)。这个文件同时包含 YAML 形式的 Token 数据(颜色/字体/圆角/间距/组件)和自然语言规则,Agent 两种读法都兼容。
第 3 步:对 AI 说一句指令
例如:"阅读项目根目录的 DESIGN.md,按它的颜色、字体和组件规则,帮我搭一个产品定价页。"
💡 小贴士:修改设计文件后,可用
npx @google/design.md lint DESIGN.md自动检查悬空引用和对比度问题(方法来自 迭代指南章节)。
相关资料与延伸阅读
- 📄 PostHog 设计系统全文:design-md/posthog/DESIGN.md(含完整颜色表、字阶层级表、组件规格)
- 📋 PostHog 案例说明页:design-md/posthog/README.md
- 📚 仓库总览与 73 个品牌清单:README.md
- 🤝 贡献指南(如何修正 Token 错误):CONTRIBUTING.md
- 📜 开源许可:LICENSE(MIT 协议)
如果你想在其他暗色风格之间做对比,仓库里的 Sentry 案例(粉色紫色强调的数据密集型仪表盘)和 Warp 案例(块状命令式终端 UI)都是不错的对照组——而 PostHog 证明了:开发者友好的暗色 UI,完全可以长着一只温柔刺猬的样子。
【免费下载链接】awesome-design-mdA collection of DESIGN.md files analysis by popular brand design systems. Drop one into your project and let coding agents generate a matching UI.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-md
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
