burrow/design/brand/README.md
Conrad Kramer 60cc48a4b7
Some checks failed
Build: Android / Android Rust Core Stub (push) Failing after 25s
Build Rust / Cargo Test (push) Successful in 4m2s
Build Site / Next.js Build (push) Failing after 4s
Lint Governance / BEP Metadata (push) Successful in 2s
Add raster panel icon family
2026-06-08 00:20:25 -07:00

57 lines
1.9 KiB
Markdown

# Burrow Brand Source
`design/brand/panel-variants/source-sheet.png` is the locked icon style sheet.
The six cropped PNG masters in `design/brand/panel-variants/` are the canonical
app icon source. Do not redraw these as SVG; regenerate platform outputs from
the raster panel masters.
`Scripts/generate-brand-icons.py` owns all generated outputs:
- `Apple/UI/Assets.xcassets/AppIcon.appiconset`: primary iOS and macOS app
icons at exact asset-catalog dimensions.
- `Apple/UI/Assets.xcassets/BurrowPanel*.appiconset`: iOS alternate app icons.
- `Apple/UI/Assets.xcassets/BurrowPanel*Preview.imageset`: in-app selector
previews.
- `design/brand/watchos/AppIcon.appiconset`: watchOS reference app icon catalog
using the selected watchOS panel.
- `Android/app/src/main/res/mipmap-*`: Android launcher PNGs.
- `store-metadata/android/icon.png`: Google Play icon.
- `burrow-gtk/data/icons/hicolor/{16,24,32,48,64,128,256,512}/apps`: Linux
hicolor PNGs.
- `design/brand/low-res`: low-resolution QA exports and preview strips.
Platform picks:
- iOS primary: `panel-01-guardian`
- iOS alternates: `panel-02-field`, `panel-03-burrow`, `panel-04-sentinel`,
`panel-05-stride`, `panel-06-post`
- macOS primary: `panel-05-stride`
- watchOS primary: `panel-03-burrow`
- Android primary: `panel-01-guardian`
- Linux primary: `panel-01-guardian`
Regenerate all package assets from existing masters with:
```bash
Scripts/generate-brand-icons.py
```
If the locked source sheet changes, extract fresh 1024px masters and regenerate
with:
```bash
Scripts/generate-brand-icons.py --extract-from /path/to/source-sheet.png
```
Run low-resolution export QA with:
```bash
Scripts/check-brand-icon-lowres.sh
```
Review these after every icon change:
- `design/brand/panel-variants/preview-strip.png`
- `design/brand/low-res/preview-strip.png`
- `design/brand/low-res/pixel-preview-strip.png`
- `design/brand/low-res/report.csv`