Whaleal 品牌资产库（Brand Assets）

所有 Whaleal 对外物料只从这里取图。本 README 只讲「哪个文件用在哪儿」； 命名与措辞的权威规则见内部品牌白皮书（WHALEAL_BRAND_WHITEPAPER）。 在线预览：https://whaleal-dev.github.io/logo/

品牌层级（先分清再用）

Whaleal（母品牌 / 公司）          → master/
└── Whaleal Cart（子产品）        → cart/
    全称：Whaleal Cart: AI Cart Recovery（App Store Display Name，正好 30 字符）

master = 通用 logo（鲸跃海浪）	cart = 电商专用（鲸 + 购物车）

• 🔴 App 名称禁止出现完整单词 Shopify（如 Whaleal Shopify Cart）→ 直接拒审。
• 🔴 新物料禁止再写 CartRescue / cartrescue（已弃用 handle）。

---

master/ — 母品牌「Whaleal」（公司级，通用 logo）

用于：官网导航/页脚、GCP/GitHub 组织头像、邮件签名、简历/物料、不属于单一产品的所有场合。

文件	用途
svg/whaleal-vector-color.svg	首选矢量源：网页、印刷等一切可缩放场合
svg/whaleal-lossless.svg	无损归档源（不直接对外用）
svg/whaleal-vector-horizontal.svg	横版组合（图标+字标）：导航栏、文档页眉
svg/whaleal-vector-mono.svg	单色版：水印、深色底、盖章/传真类场景

文件	用途
logos/whaleal-logo-horizontal-1600x400.png	横版位图：邮件、PPT、第三方后台头像栏
logos/whaleal-logo-horizontal-dark.png	深色调横版（页面 footer、暗色 hero）
logos/whaleal-logo-horizontal-white.png	白色横版（纯色深底、视频角标）
logos/whaleal-logo-stacked-800x800.png	方版（图标上、字标下）：头像、社媒主页图
icons/whaleal-icon-{1024,2048}.png	方形大图：组织头像、应用图标源
icons/favicon-* / icon-* / apple-touch-* / android-chrome-*	www.whaleal.com 主站用（favicon 全套、PWA、iOS 主屏）

cart/ — 子产品「Whaleal Cart」（产品级，电商专用）

用于：Shopify App Store listing、cart 应用内 UI、cart 相关邮件与营销页。不要用在公司级场合。

文件	用途
svg/whaleal-cart-logo.svg	产品 logo 矢量源（4096 viewBox）
svg/whaleal-nav-icon.svg	应用内导航小图标源
icons/ 全套	App Store listing 与 cart 控制台用（结构同母品牌；whaleal-icon-1024 亦用于 Partner Dashboard 方图）
runtime/	cart-rescue-ui 前端在用的快照，由 npm run generate:brand 从 ../icons/ 生成，不要手改

⚠️ 改 cart 图标顺序：改 icons/ → 到 cart-rescue-ui 跑 npm run generate:brand → runtime/ 自动同步。

---

cards/ — 官网产品卡片图（1600×900）

whaleal-cart-card{0-4}-*-1600x900-{en,zh}.png：首页/产品页轮播卡，五张依次为 hero → dashboard → orders → timing → email；-en/-zh 按页面语言取用。

⚠️ 官网已改用 AVIF+JPEG 三档优化版（home/static/images/cards/），此处是原图存档。

videos/ — 产品演示视频

• *-30s-teaser.webm：30 秒概览（社媒、页面内嵌短播）
• *-3m-pitch.webm：3 分钟完整走查（销售、评审、App Store 演示）

官网播放用的是 home-site/static/videos/ 的运行时拷贝；本目录为源。

---

目录结构

logo/
├── master/    母品牌 Whaleal（svg / logos / icons）
├── cart/      子产品 Whaleal Cart（svg / logos / icons / runtime）
├── cards/     官网产品卡片原图
├── videos/    产品演示视频
└── index.html Pages 预览页（https://whaleal-dev.github.io/logo/）

快速决策

是公司/多产品通用的场合？      → master（鲸跃海浪）
是 Whaleal Cart 单产品的？    → cart（鲸+购物车）
要矢量/要缩放？              → svg/
深色背景？                   → *-dark / *-white / mono
浏览器标签/手机主屏/PWA？      → 对应 icons/（cart 侧改图标走 generate:brand）