# 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`