lfg2025/archy
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases 44 Wiki Activity
archy/.claude/skills/build-iso/references/branding.md
Dorian 1e283daf13 fix: overhaul container lifecycle — recovery, health, uninstall, UI state 
Container recovery:
- Health monitor: MAX_RESTART_ATTEMPTS 3→10, interval 60s→120s
- Dependency-aware restarts: won't restart services before their deps
- Reset dependent counters when a dependency recovers
- Handle "created" state containers (were invisible to health monitor)
- Added IndeedHub, mempool-api, mysql to tier system
- Crash recovery: podman start timeout 30s→120s with retry
- Podman client: socket timeout 5s→30s, added restart policy

UI state representation:
- Exit code 0 shows "stopped" (gray), not "crashed" (red)
- Exit code 137 shows "killed (OOM)"
- Non-zero exit shows "crashed" (red)
- Added exit_code field to PackageDataEntry

Install/uninstall fixes:
- Install returns error when container doesn't start (was silent success)
- Post-install hooks awaited instead of fire-and-forget tokio::spawn
- Uninstall: graceful rm before force, volume prune, network cleanup
- Uninstall returns error on partial failure (was 200 OK)

Config consistency:
- DB passwords read from /var/lib/archipelago/secrets/ (was hardcoded)
- Bitcoin: added ZMQ ports 28332/28333 for LND block notifications
- IndeedHub port 7777→8190 (was conflicting with strfry)
- Marketplace versions: LND 0.17.4→0.18.4, Mempool 2.5.0→3.0.0

Performance:
- Metrics collector interval 60s→300s (was duplicating health monitor)
- Podman client: proper error propagation instead of unwrap_or_default

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-31 07:03:57 +01:00

3.1 KiB
Raw Blame History

ISO Boot Branding — Archipelago

Design and build the visual boot experience from USB power-on to web UI.

Brand Identity

Archipelago = self-sovereign Bitcoin node OS. Floating islands in the sky.

Element Value
Primary accent #fb923c (Bitcoin orange)
Secondary accent #f7931a (deeper orange)
Success #4ade80 (green)
Background #0a0a0a -> #050505 (near-black)
Text #ffffff (white), #aaaaaa (dim), #555555 (subtle)
Glass rgba(255,255,255,0.06) frost overlay
Style Pixel art cyberpunk, dark glass morphism, CRT scanlines
Logo Pixel-art lowercase "a" (from SVG favicon)

Boot Stages & What's Customizable

1. GRUB Menu (UEFI boot)

  • Background: branding/grub-theme/background.png — any PNG, GRUB scales it
  • Theme: branding/grub-theme/theme.txt — colors, layout, labels
  • Fonts: Generated with grub-mkfont during build, .pf2 format
  • Config: Written by build script in Step 5 (grub.cfg heredoc)

GRUB theme.txt properties that work:

desktop-color: "#rrggbb"
desktop-image: "background.png"
title-text: ""

+ boot_menu { left/top/width/height = N%; item_color/selected_item_color = "#rrggbb" }
+ label { left/top/width = N%; text = "string"; color = "#rrggbb"; align = "center" }

IMPORTANT: Do NOT reference font names in theme.txt unless you know the exact internal name from grub-mkfont output.

2. ISOLINUX Menu (BIOS boot)

  • Text-only ANSI-style MENU COLOR directives
  • Use vesamenu.c32 for graphical, menu.c32 for compatibility

3. Plymouth Splash (kernel boot -> login)

  • Theme: branding/plymouth-theme/archipelago.script
  • Logo: branding/plymouth-theme/logo.png (PNG with transparency)
  • Config: branding/plymouth-theme/archipelago.plymouth
  • Kernel param splash must be present

4. Console Banner (TTY login)

  • ASCII art in /etc/profile.d/archipelago.sh
  • Uses ANSI escape codes for color

5. Installer Prompt

  • In systemd service wrapper: /usr/local/bin/archipelago-start-installer

Image Specs

Asset Format Size Notes
GRUB background PNG 1024x768 recommended Large images slow boot
Plymouth logo PNG (RGBA) 256x256 recommended Transparent background
GRUB fonts .pf2 Generated grub-mkfont -s SIZE -o out.pf2 input.ttf

Build Integration

GRUB theme: Step 2 (copied from branding/grub-theme/, fonts generated with grub-mkfont) Plymouth theme: Step 3 (component copy) + Step 4 (auto-install.sh copies to target) GRUB on target: auto-install.sh copies to /mnt/target/boot/grub/themes/archipelago/

What to Edit

File Affects
branding/grub-theme/background.png GRUB boot screen image
branding/grub-theme/theme.txt GRUB menu colors, layout
branding/plymouth-theme/logo.png Plymouth boot logo
branding/plymouth-theme/archipelago.script Plymouth animation/progress
branding/generate-grub-background.py Procedural background generator
branding/generate-plymouth-logo.py Procedural logo generator