Files
samios/branding/README.md
T
Sami Ahmed 658a8541e9
SamiOS CI / lint-and-test (push) Successful in 14s
v0.2.0: WSL desktop, branding, GRUB theme, CI, installer, fonts, voice architecture
Major update adding full desktop environment support, complete branding suite,
and project infrastructure:

Desktop (WSL):
- KDE Plasma + SDDM + Dolphin/Konsole/Kate/Firefox setup script
- Windows 11 dark/light color schemes
- PipeWire audio stack
- WSLg-compatible launch script
- SamiOS CLI tool (v0.2.0) with desktop command

Branding:
- Logos: face-on-pyramid with and without text (500px)
- Icons: square + launcher (256/512/1024px) + SVG vector
- Wallpapers: 1920x1080, 4K, clean variant (PIL-generated)
- GRUB theme: full cobalt blue (#1424CE) theme with pyramid background
- SDDM theme: SamiOS login screen configuration
- Branding README with palette, typography, usage guidelines

Fonts:
- Sami Grotesk (Helvetica-like) as default system/UI font
- Sami Sans as secondary
- Full Sami font family support (excluding 7777 personal branding)
- fontconfig rules mapping Helvetica/Arial → Sami Grotesk
- Font policy enforcement in samios CLI

Infrastructure:
- Automated installer (samios-installer.sh): partition, format, pacstrap, bootloader
- PKGBUILD for samios-branding package
- Test suite: shell tests for profiledef, packages, pacman.conf, CLI, font policy
- Makefile: test, lint, check, build, clean targets
- Gitea Actions CI workflow
- Voice integration architecture document (SamiType × SamiOS)
- Updated roadmap reflecting completed phases
2026-08-11 03:39:47 -07:00

95 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```