# SamiOS Branding

Official visual identity assets for **SamiOS** — the Arch-based custom Linux distribution.

## Brand Mark

The SamiOS mark is a stylized blue pyramid (hex `#1424CE`, cobalt blue with slight violet tint)
combined with a Simpsons-style cartoon face. The pyramid represents the foundational geometric
base of the OS; the face is the personal signature of the project's creator.

## Directory Layout

```
branding/
├── README.md            ← this file
├── icons/               ← square and launcher icons (no face — pyramid only)
├── logos/               ← full lockups (face + pyramid, with and without text)
├── themes/              ← GTK / Qt / display-manager themes (TBD)
└── wallpapers/          ← desktop wallpapers (TBD)
```

## Assets

### Icons (`icons/`)

Square pyramid-only icons, used for window decoration, file-type associations, and anywhere
the face is too detailed at small sizes.

| File                              | Size      | Use                                                  |
| --------------------------------- | --------- | ---------------------------------------------------- |
| `samios-icon-256.png`             | 256×256   | Small UI icons, favicons                             |
| `samios-icon-512.png`             | 512×512   | Standard app icon size                               |
| `samios-icon-1024.png`            | 1024×1024 | High-DPI / source master                             |
| `samios-icon-launcher-256.png`    | 256×256   | Mobile / desktop launcher (rounded square)           |
| `samios-icon-launcher-512.png`    | 512×512   | Standard launcher size                               |
| `samios-icon-launcher-1024.png`   | 1024×1024 | High-DPI launcher source                             |
| `samios-icon.svg`                 | vector    | Scalable source — renders at any size, no quality loss |

**Launcher icons** use a 22.3% corner-radius ratio (matches Apple iOS/macOS Big Sur+ aesthetic).

### Logos (`logos/`)

Full lockups with the cartoon face. Use these on websites, documentation, and splash screens.

| File                          | Size      | Description                                  |
| ----------------------------- | --------- | -------------------------------------------- |
| `samios-logo.png`             | 500×500   | Face on pyramid, no text                     |
| `samios-logo-text.png`        | 500×500   | Face on pyramid, with "SamiOS" wordmark      |

## Color Palette

| Role                | Hex       | Usage                            |
| ------------------- | --------- | -------------------------------- |
| **Primary Blue**    | `#1424CE` | Pyramid fill (shadow face)       |
| **Primary Lit**     | `#3B4ED8` | Pyramid lit face (light side)    |
| **Face Yellow**     | `#FFD90F` | Cartoon skin tone                |
| **Hair / Outlines** | `#3A3A3A` | Cartoon outlines                 |

## Typography

The "SamiOS" wordmark uses the **samiahmed7777** font family. This font is part of the creator's
personal brand and is intentionally **not** bundled with the OS — only the rendered wordmark
image is distributed as a logo asset. (See project font policy.)

## Usage Guidelines

- **Do** keep the cobalt blue (`#1424CE`) consistent across all derivatives.
- **Do** preserve the lit/shadow face split on the pyramid — it gives the mark dimensionality.
- **Don't** add drop shadows, gradients, or filters on top of the mark.
- **Don't** stretch the pyramid non-uniformly; always preserve its aspect ratio.
- **Don't** use the face-only or pyramid-only marks as separate brand identities — they are
  companion assets, not standalone logos.

## Source / Provenance

- Pyramid geometry: AI-generated from text prompt, then refined to `#1424CE` color spec.
- Face illustration: creator's hand-authored Simpsons-style portrait.
- SVG (`samios-icon.svg`): hand-traced from the rasterized pyramid using detected peak
  coordinates (peak at `x=518, y=244`; base from `x=144` to `x=874`; base center at `y=668`,
  in a 1024×1024 reference canvas).

## File Manifest

```
icons/samios-icon.svg                     756 B
icons/samios-icon-256.png             43,643 B
icons/samios-icon-512.png            129,757 B
icons/samios-icon-1024.png           303,023 B
icons/samios-icon-launcher-256.png    47,229 B
icons/samios-icon-launcher-512.png   136,239 B
icons/samios-icon-launcher-1024.png  300,798 B
logos/samios-logo.png                 70,137 B
logos/samios-logo-text.png            73,959 B
```