﻿# KERNL Assets

Official logos, icons, and branding assets.

## Quick Reference

| File | Size | Use Case |
|------|------|----------|
| `favicon.png` | 32x32 | Browser favicon |
| `icon-16.png` | 16x16 | Small UI elements |
| `icon-32.png` | 32x32 | Taskbar, favicon |
| `icon-48.png` | 48x48 | Desktop icon |
| `icon-64.png` | 64x64 | Medium icon |
| `icon-128.png` | 128x128 | Large icon |
| `icon-256.png` | 256x256 | High-res icon |
| `icon-512.png` | 512x512 | App store, splash |
| `logo-original.png` | Source | Full resolution source |

## Dark Mode Variants

| File | Size | Use Case |
|------|------|----------|
| `icon-128-dark.png` | 128x128 | Dark theme icon |
| `icon-256-dark.png` | 256x256 | Dark theme icon |
| `icon-512-dark.png` | 512x512 | Dark theme icon |

## Rounded Variants

| File | Size | Use Case |
|------|------|----------|
| `icon-128-rounded.png` | 128x128 | App icon (iOS style) |
| `icon-256-rounded.png` | 256x256 | App icon |
| `icon-512-rounded.png` | 512x512 | App icon |

## Social/Marketing

| File | Size | Use Case |
|------|------|----------|
| `og-image.png` | 1200x630 | OpenGraph (Facebook, LinkedIn) |
| `twitter-card.png` | 1200x600 | Twitter card |
| `social-square.png` | 800x800 | Instagram, general |
| `social-banner.png` | 1200x630 | Social with gradient + text |
| `github-social.png` | 1280x640 | GitHub repository preview |
| `banner.png` | 1200x300 | README header, npm |

## Brand Colors

```css
/* Primary */
--brand-blue: #1E88E5;
--brand-dark-blue: #1565C0;
--brand-orange: #FF8F00;
--brand-red: #E64A19;

/* Neutral */
--brand-white: #FFFFFF;
--brand-dark: #1E1E1E;

/* Gradient */
background: linear-gradient(135deg, #1E88E5 0%, #FF8F00 100%);
```

## Regenerating Assets

If you modify the source logo, regenerate all assets:

```bash
node scripts/generate-icons.js
node scripts/generate-branded.js
```

## Usage Guidelines

1. **Don't stretch** - Always maintain aspect ratio
2. **Clear space** - Leave padding equal to 10% of icon size
3. **Backgrounds** - Use dark variants on dark backgrounds
4. **Minimum size** - Don't use below 16x16

## Source Files

Original logos are in `D:/KERNL/`:
- `pm.png` - Primary logo (tight crop)
- `pm 1.png` - Logo with whitespace
- `pm 2.png` - Alternative crop
