# Burrow Brand Source

`burrow-owl-icon-master.png` is the current generated master for the Burrow app
icon. The mark centers a leg-forward burrowing owl in a dark brown/black field
with minimal warm brown and gold accents.

The editable source is split by intent:

- `burrowing-owl-icon-source.svg` is the human-readable vector source.
- `icon-layers/*.svg` are the transparent source layers used to regenerate the
  Icon Composer package.
- `Burrow.icon` is the Icon Composer document. Keep it to three broad raster
  layers: `burrow-ground`, `owl-figure`, and `owl-legs`.
- `burrowing-owl-concept-v2.png` is reference art only; do not use it directly
  as an app icon.

That layer count is intentional. The identifying cue is the long Burrowing Owl
leg silhouette, so Icon Composer should receive broad shape planes instead of
small decorative SVG layers. Face and spot details are flattened into
`owl-figure.png`; the legs stay in the front layer so they survive small sizes.

Regenerate the Icon Composer layer assets and Apple app icon PNGs with:

```bash
for src in design/brand/icon-layers/*.svg; do
  name="$(basename "$src" .svg)"
  sips -s format png "$src" --out "design/brand/Burrow.icon/Assets/${name}.png" >/dev/null
done
magick \
  design/brand/Burrow.icon/Assets/owl-body.png \
  design/brand/Burrow.icon/Assets/owl-face.png \
  design/brand/Burrow.icon/Assets/owl-spots.png \
  -background none -layers merge -strip \
  PNG32:design/brand/Burrow.icon/Assets/owl-figure.png
"/Applications/Xcode/Xcode.app/Contents/Applications/Icon Composer.app/Contents/Executables/ictool" \
  design/brand/Burrow.icon \
  --export-image \
  --output-file design/brand/burrow-owl-icon-master.png \
  --platform iOS \
  --rendition Default \
  --width 1024 \
  --height 1024 \
  --scale 1
for f in Apple/UI/Assets.xcassets/AppIcon.appiconset/*.png; do
  size="$(basename "$f" .png)"
  magick design/brand/burrow-owl-icon-master.png -colorspace sRGB -resize "${size}x${size}!" -strip "PNG24:$f"
done
```

Run low-resolution export QA with:

```bash
Scripts/check-brand-icon-lowres.sh
```

The script writes `design/brand/low-res/`, including:

- `burrow-icon-{16,20,24,29,32,40,48,64,80,128,256}.png`
- `preview-strip.png`, a 256-to-16px visual strip scaled up for inspection
- `pixel-preview-strip.png`, a nearest-neighbor strip for 32px and below
- `report.csv`, with color-count and grayscale-contrast checks

Sizes that overlap `Apple/UI/Assets.xcassets/AppIcon.appiconset/` should remain
pixel-identical to the generated app catalog assets.