# SamiOS GRUB Theme

Cobalt blue (#1424CE) themed GRUB bootloader with pyramid branding.

## Structure

```
grub-theme/
├── theme.txt                    # GRUB theme definition
├── background.png               # 1024×768 dark navy gradient + pyramid
├── build_theme.py               # Regenerate all assets
├── README.md                    # This file
├── fonts/
│   ├── SamiOS-Regular-12.pf2
│   ├── SamiOS-Regular-16.pf2
│   ├── SamiOS-Bold-14.pf2
│   └── SamiOS-Bold-16.pf2
├── icons/
│   ├── samios_16.png
│   ├── samios_24.png
│   ├── samios_32.png
│   └── samios_48.png
├── samios_select_*.png          # Selected menu item 9-patch
├── scrollbar_thumb_*.png        # Scrollbar thumb 9-patch
└── terminal_box_*.png           # Terminal console box 9-patch
```

## Brand Colors

| Token   | Hex       | Usage |
|---------|-----------|-------|
| Primary | `#1424CE` | Cobalt blue — pyramid shadow face, progress bar, selection |
| Secondary | `#3B4ED8` | Lighter blue — pyramid lit face, borders |
| Dark BG | `#050A1F` | Very dark navy background base |
| Text    | `#CCD4F5` | Lavender-white — titles, selected items |

## Installation

The theme is referenced by `packaging/archiso/grub/grub.cfg`:
```
set theme=/boot/grub/themes/samios/theme.txt
```

During ISO build, this directory should be copied to:
```
<iso-root>/boot/grub/themes/samios/
```

## Regenerating Assets

```bash
cd branding/grub-theme
python3 build_theme.py
```

Requires: PIL/Pillow, grub-mkfont, DejaVu Sans fonts.