42 lines
2.0 KiB
Markdown
42 lines
2.0 KiB
Markdown
# 啡跃 Endoleap 品牌包
|
|
|
|
本包把已选定的「摩卡奶霜」配色、四套正式主题和固定轮廓 Logo 放在同一个 workspace 包中。它提供 Tailwind CSS v4 / shadcn/ui 的主题接口及静态图片，不安装组件，也不自动重设应用页面。
|
|
|
|
## 文档入口
|
|
|
|
- [品牌与包边界](docs/overview.md)
|
|
- [配色、组件状态与深色主题](docs/colors.md)
|
|
- [Tailwind CSS、shadcn/ui 与包导入](docs/integration.md)
|
|
- [Logo、平台图片与修改流程](docs/logo.md)
|
|
|
|
`tokens/palette.json` 是色值来源；四份主题 JSON 引用色板键；`tokens/geometry.json` 是唯一 Logo 路径来源。`src/themes.css` 是可直接导入的源样式，一致性由测试核对；`dist/` 仅在远程 CI 构建，不提交。
|
|
|
|
```css
|
|
@import "tailwindcss";
|
|
@import "@endoleap/brand/themes.css";
|
|
@import "@endoleap/brand/tailwind.css";
|
|
```
|
|
|
|
```tsx
|
|
// 在主题根节点选择正式主题；应用负责持久化和切换。
|
|
<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 文件头，不编译和输出产物。
|
|
|
|
完整验证在已确认的 ces-control Docker runner 执行：
|
|
|
|
```sh
|
|
docker build -f packages/brand/Dockerfile -t endoleap-brand-check .
|
|
```
|
|
|
|
包含真实 Tailwind 编译、TypeScript 导入检查、品牌导出和 72 个 PNG 与 SVG 逐像素比较。不要在本机运行该 Docker 构建或 `build` / `test:tailwind` / `test:types` / `test:assets`。
|