Makelore 2.0 initial clean snapshot

resources/icons/README.md

@@ -0,0 +1,77 @@
+# Makelore Application Icons
+
+This directory contains the application icons for all supported platforms.
+
+## Required Files
+
+| File | Platform | Description |
+|------|----------|-------------|
+| `icon-source.png` | Generated source | 1024px raster generated from the vector master |
+| `icon.svg` | Source | Vector app-icon master |
+| `icon-plain.svg` | Source | Transparent full-color mark used for the tray mask |
+| `icon.icns` | macOS | Apple Icon Image format |
+| `icon.ico` | Windows | Windows ICO format |
+| `icon.png` | All | 512x512 PNG fallback |
+| `16x16.png` - `512x512.png` | Linux | PNG set for Linux |
+| `tray-icon-template.svg` | Source | macOS tray icon template source |
+| `tray-icon-Template.png` | macOS | 22x22 status bar icon (note: "Template" suffix required) |
+
+## Generating Icons
+
+### Using the Script
+
+```bash
+# Run icon generation
+npm run icons
+```
+
+### Prerequisites
+
+**macOS:**
+```bash
+brew install imagemagick librsvg
+```
+
+**Linux:**
+```bash
+apt install imagemagick librsvg2-bin
+```
+
+**Windows:**
+Install ImageMagick from https://imagemagick.org/
+
+### Manual Generation
+
+If you prefer to generate icons manually:
+
+1. **macOS (.icns)**
+   - Create a `.iconset` folder with properly named PNGs
+   - Run: `iconutil -c icns -o icon.icns Makelore.iconset`
+
+2. **Windows (.ico)**
+   - Use ImageMagick: `convert icon_16.png icon_32.png icon_64.png icon_128.png icon_256.png icon.ico`
+
+3. **Linux (PNGs)**
+   - Generate PNGs at: 16, 32, 48, 64, 128, 256, 512 pixels
+
+## Design Guidelines
+
+### Application Icon
+- **Source**: `icon-source.png`
+- **Canvas**: Square PNG with transparent background where possible
+- **Safe Area**: Keep the visible mark comfortably inside the canvas
+
+### macOS Tray Icon
+- **Format**: Single-color (black) on transparent background
+- **Size**: 22x22 pixels (system automatically handles @2x retina)
+- **Naming**: Must end with "Template.png" for automatic template mode
+- **Design**: Monochrome alpha mask generated from the main icon
+- **Source**: Generated from `icon-source.png`
+- **Important**: Must be pure black (#000000) on transparent background - no gradients or colors
+
+## Updating the Icon
+
+1. Update `icon.svg`, `icon-plain.svg`, and the masters in `resources/brand/`
+2. Run `npm run icons`
+4. Verify generated icons look correct
+5. Commit all generated files