# Milionář Flat

Third selectable skin (`skin.milionar.flat`, addon setting `skin_variant=2`). Authorized 2026-10-27: image-generated concepts, complete implementation, live verification and publication. First iteration published as addon 2.1.91 / skins 1.3.78; a second release polishes layout and adds restrained cinematic ambient colour.

## Architecture

An overlay over `skin.milionar`, composed by the existing `wcs/skin/compose.py`. `scripts/skin_harness/gen_flat.py` reuses the shared cinematic, detail and genre generators. Content/plugin URLs, control IDs, actions, page ownership and context commands are preserved; `test_flat.py` compares them. Classic and Modern retain their own presentation. All three are recognized by `family.active()`, installed by the service, versioned and validated by the release script.

## Presentation and navigation

- Horizontal scrolling Home menu includes every enabled section, including optional items. Left/right changes section, Down enters content, Up enters utilities. Hero Up returns to menu. Utility icons remain reachable at the end of the menu.
- 56px common content inset. Header components share a 64px vertical axis. Focus is a solid lime rectangle with dark text; a small underline identifies the active section after focus moves into content.
- Hero text and artwork use separate columns. The artwork ends at y504, before the action row begins at y516. All managed buttons fit on the full-width action strip.
- No divider below resume progress. Row header is separated by whitespace. Compact poster/portrait cards keep captions and focus borders on screen. Music masks retain their rectangular crop windows.
- Carbon background, off-white text, chartreuse accent. Native Kodi stretches two cached 32x18 thumbnails for ambient colour, adds a very faint masked fanart wash and applies a dark alpha scrim. Header/footer blend to solid carbon; the text area is strongly dimmed. No-fanart disables art; low-power skips the second ambient layer. UI corners remain square and dialog animations are short fades.
- Generic lists use a dark focus fill with a lime edge to keep white text readable. Primary hero actions use lime with dark text and glyphs.

## Art and evidence

`docs/design/flat/concepts/01-design-board.png`: four original image-generator references. `docs/design/flat/prompts.json`: exact prompts and tool. Alpha artwork lives in `resources/skin.milionar.flat/media/flat/empty-art.png`. `docs/design/flat/reference/`: Modern captures; `docs/design/flat/final/`: real native Kodi frames. The original references inform the layout; user-requested changes add the cinematic background and remove the long divider.

Verification: composed XML parsing, local textures/alpha, all menu entries, identical page commands/content and IDs, manifest/dependency/picker/localizations, mask crop boundaries, no artwork/action overlap, no hero divider and focus text contrast above 7:1. Live: all six enabled Home sections, details, focus states, context/filter menus, settings, search and widget management.
