# One modular skin and one Appearance settings dialog

Approved 2026-10-29, including publication after verification.

- Only `skin.milionar` is bundled, installed and updated. The original Modern
  body layout and cinematic background are shared by every combination.
- Independent menu position (sidebar / horizontal) and material (Normal / Glass).
  One functional XML tree, small menu modules, two foreground material modules;
  composition uses the existing atomic installer and rollback.
- The former picker is now **Appearance settings**. Its Home menu shortcut sits
  below updates. Kodi SkinSettings redirects here; there is no duplicate shortcut.
- The dialog contains appearance, accent, background/UI preferences, section
  switches and entry points to the existing widget/menu/context editors.
- `skin_unified_v2=1` marks a successful mandatory transition, once per profile,
  also for users who skip this release and update later. Until then idle startup
  installs the canonical skin, activates it, confirms Kodi's Keep Skin prompt,
  sets sidebar + Glass + the existing `gold.xml` (#C49A45). It never opens settings.
- Existing section/menu/widget preferences follow the previously active managed
  skin, including live unsaved values. Otherwise use the most recently saved
  managed profile. Appearance defaults alone are overwritten.
- After successful confirmation, remove only identified managed legacy addon
  folders. Retain all userdata profiles, skip symlinks and foreign manifests.
- Later updates/restarts keep the user's new choices. Only the canonical skin
  receives bundled updates; no legacy skins are rebuilt or installed.
- Addon updates are always manual, initiated from the existing update dialog.
  Kodi's per-addon exclusion also covers the canonical skin; global update
  preferences and unrelated addons remain unchanged. See `250-update.md`.

Verification: `scripts/skin_harness/test_modular.py`, installer/performance,
service, command and update tests. Real Kodi evidence in `docs/design/modular/`:
mandatory transition from the legacy Modern skin, all 3,073 section/widget
preferences preserved without a difference, category navigation, child widget
editor and return focus, all four combinations and native Normal buttons.

Final acceptance 2026-10-29: 158 targeted offline tests passed. The runtime ZIP
has exactly one skin manifest, four real previews and all four compositions parse
with no missing module texture (package-verification.json). Kodi native addon
information confirms automatic updates OFF while the global mode remains 0
(auto-updates allowed for other addons). Check/install/open-update paths are
blocked for checkout, Git worktree and agent workspace markers. No release
package was installed over the development addon.

After a real restart, horizontal + Glass remained selected and no settings dialog
opened; the one-time marker did not reset it. Final developer UI was returned to
sidebar + Glass + original gold. All initial 3,073 captured skin values still
matched, including all 925 persistent widget/section values. Native screenshots
also cover films, series, detail, Normal confirmation and Appearance preview.
