啡跃 Endoleap 品牌包
本包把已选定的「摩卡奶霜」配色、四套正式主题和固定轮廓 Logo 放在同一个 workspace 包中。它提供 Tailwind CSS v4 / shadcn/ui 的主题接口及静态图片,不安装组件,也不自动重设应用页面。
文档入口
tokens/palette.json 是色值来源;四份主题 JSON 引用色板键;tokens/geometry.json 是唯一 Logo 路径来源。src/themes.css 是可直接导入的源样式,一致性由测试核对;dist/ 仅在远程 CI 构建,不提交。
@import "tailwindcss";
@import "@endoleap/brand/themes.css";
@import "@endoleap/brand/tailwind.css";
// 在主题根节点选择正式主题;应用负责持久化和切换。
<main data-theme="canvas-dark" className="bg-background text-foreground">
<button className="bg-primary text-primary-foreground hover:bg-primary-hover">
开始创作
</button>
</main>
主题名:home-light、home-dark、canvas-light、canvas-dark。没有 drafts、proposed 或隐式跟随系统的规则。.dark 兼容默认首页深色;显式 data-theme 优先。使用 dark: 工具类时,一个文档根节点只选择一个明暗主题,不在 .dark 祖先下嵌套浅色 dark: 变体。
验证
可进行的本地轻量检查:node --test packages/brand/tests/brand.test.mjs。它只读取源码和资产,检查主题、对比度、SVG 路径及 PNG/ICO 文件头,不编译和输出产物。
品牌包不提供独立 Docker 镜像或常驻服务,也不再运行专用品牌 CI 工作流。Wiki 和 Studio 通过 workspace:* 使用本包,品牌资源随消费应用的 Docker 构建处理,并由应用类型检查、测试和构建验证接入。
原专用工作流中的品牌导出一致性、单独 Tailwind/TypeScript 测试和 72 个 PNG 与 SVG 逐像素比较不再自动运行;相关脚本与测试文件保留,不能将应用检查视为对这些检查的等价替代。需要这些完整检查时,仍须在已确认的远程 runner 执行,不在本机运行 build / test:tailwind / test:types / test:assets。