# 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