Add comprehensive platform logo assets

assets/branding/README.md

@@ -14,6 +14,36 @@ Use the transparent original by default. If a derivative needs an opaque
 background, the background must be black. Do not use another background
 color.
 
+## Generated derivatives
+
+`generated/` contains reproducible derivatives for common application and
+distribution targets. The canonical source above remains the only master
+artwork.
+
+- `png/transparent/`: full-bleed transparent PNGs from 16 to 1024 pixels
+- `png/on-black/`: opaque black-background PNGs
+- `png/safe-zone/`: transparent icons with padding for UI and app chrome
+- `png/monochrome-{black,white}/`: single-color notification/tray variants
+- `web/`: favicons, Apple touch icon, PWA icons, and maskable PWA icons
+- `windows/`: multi-resolution ICO and Microsoft Store square assets
+- `macos/`: ICNS and an Xcode-compatible `AppIcon.iconset`
+- `ios/`: a ready-to-copy `AppIcon.appiconset` with `Contents.json`
+- `android/`: legacy launcher and adaptive foreground assets by density
+- `linux/`: freedesktop `hicolor` application icon hierarchy
+- `social/`: square profile and 1200 x 630 Open Graph images
+
+Use the safe-zone or maskable versions anywhere the operating system may crop
+an icon to a circle, squircle, or other shape. Android adaptive foreground
+assets are transparent and are intended for a black (`#000000`) adaptive-icon
+background.
+
+`generated/manifest.json` records every derivative's dimensions and SHA-256.
+Regenerate the complete set from the repository root with:
+
+```powershell
+uv run --with pillow python scripts/generate_brand_assets.py
+```
+
 The repository does not yet have a project license. This directory records
 the asset's provenance and approved presentation; it does not independently
 grant broader rights or select a license.

assets/branding/generated/android/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

assets/branding/generated/android/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

assets/branding/generated/android/values/ic_launcher_background.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="ic_launcher_background">#000000</color>
+</resources>

assets/branding/generated/ios/AppIcon.appiconset/Contents.json

@@ -0,0 +1,116 @@
+{
+  "images": [
+    {
+      "filename": "icon-20@2x.png",
+      "idiom": "iphone",
+      "scale": "2x",
+      "size": "20x20"
+    },
+    {
+      "filename": "icon-20@3x.png",
+      "idiom": "iphone",
+      "scale": "3x",
+      "size": "20x20"
+    },
+    {
+      "filename": "icon-29@2x.png",
+      "idiom": "iphone",
+      "scale": "2x",
+      "size": "29x29"
+    },
+    {
+      "filename": "icon-29@3x.png",
+      "idiom": "iphone",
+      "scale": "3x",
+      "size": "29x29"
+    },
+    {
+      "filename": "icon-40@2x.png",
+      "idiom": "iphone",
+      "scale": "2x",
+      "size": "40x40"
+    },
+    {
+      "filename": "icon-40@3x.png",
+      "idiom": "iphone",
+      "scale": "3x",
+      "size": "40x40"
+    },
+    {
+      "filename": "icon-60@2x.png",
+      "idiom": "iphone",
+      "scale": "2x",
+      "size": "60x60"
+    },
+    {
+      "filename": "icon-60@3x.png",
+      "idiom": "iphone",
+      "scale": "3x",
+      "size": "60x60"
+    },
+    {
+      "filename": "icon-20@1x.png",
+      "idiom": "ipad",
+      "scale": "1x",
+      "size": "20x20"
+    },
+    {
+      "filename": "icon-20@2x.png",
+      "idiom": "ipad",
+      "scale": "2x",
+      "size": "20x20"
+    },
+    {
+      "filename": "icon-29@1x.png",
+      "idiom": "ipad",
+      "scale": "1x",
+      "size": "29x29"
+    },
+    {
+      "filename": "icon-29@2x.png",
+      "idiom": "ipad",
+      "scale": "2x",
+      "size": "29x29"
+    },
+    {
+      "filename": "icon-40@1x.png",
+      "idiom": "ipad",
+      "scale": "1x",
+      "size": "40x40"
+    },
+    {
+      "filename": "icon-40@2x.png",
+      "idiom": "ipad",
+      "scale": "2x",
+      "size": "40x40"
+    },
+    {
+      "filename": "icon-76@1x.png",
+      "idiom": "ipad",
+      "scale": "1x",
+      "size": "76x76"
+    },
+    {
+      "filename": "icon-76@2x.png",
+      "idiom": "ipad",
+      "scale": "2x",
+      "size": "76x76"
+    },
+    {
+      "filename": "icon-83.5@2x.png",
+      "idiom": "ipad",
+      "scale": "2x",
+      "size": "83.5x83.5"
+    },
+    {
+      "filename": "icon-1024.png",
+      "idiom": "ios-marketing",
+      "scale": "1x",
+      "size": "1024x1024"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}