theme-asset-pack-integration-workflow

name	theme-asset-pack-integration-workflow
description	Operational workflow for integrating UI asset packs through Godot Theme resources, type variations, and container-first layouts.
tier	operational
godot_version	4.6+
doc_anchors	["godot-docs/tutorials/ui/gui_skinning.rst","godot-docs/tutorials/ui/gui_using_theme_editor.rst","godot-docs/tutorials/ui/gui_using_fonts.rst","godot-docs/tutorials/ui/gui_containers.rst","godot-docs/tutorials/rendering/multiple_resolutions.rst","godot-docs/classes/class_theme.rst","godot-docs/classes/class_control.rst"]
tags	["ui","themes","asset-packs"]
depends_on	["godot-skills/godot-secondary/domain-ui-input-accessibility/SKILL.md","godot-skills/godot-operational/ui-localization-accessibility-workflow/SKILL.md"]

Theme Asset Pack Integration Workflow

Use When

• Integrating purchased/free UI packs into project-wide UI.
• UI styling is drifting through per-control overrides.
• Controller focus/scale behavior breaks across screens.

Outcomes

• One coherent project Theme drives UI style consistently.
• Theme type variations cover common variants without node-level styling sprawl.
• Layout and focus behavior remain robust across resolution/scale changes.

Required Rules

• Apply UI pack styling through Theme resources, not per-node manual overrides.
• Define compact type variations for semantic variants (primary/danger/card/header, etc.).
• Use container-first layout strategy for scalable UI.
• Ensure decorative overlay controls do not block interaction hit-testing.

Workflow

1. Import UI pack assets and create/assign a project Theme resource.
2. Define core design tokens (colors/fonts/styleboxes/constants) in Theme.
3. Create type variations and map UI controls to variation roles.
4. Convert brittle manual-positioned UI surfaces to container-driven layout.
5. Validate controller focus visuals, resolution scaling, and localization resilience.

Validation

• UI scenes render consistently with minimal local overrides.
• Controller-only navigation shows clear focus states on interactive controls.
• Multi-resolution and larger-font runs preserve usability.

Failure Modes

• Asset pack is applied via local overrides and diverges between scenes.
• Fixed pixel layout breaks on localization or scale changes.
• Decorative overlay nodes intercept input due to incorrect mouse filter settings.

Local Doc Anchors

• godot-docs/tutorials/ui/gui_skinning.rst
• godot-docs/tutorials/ui/gui_using_theme_editor.rst
• godot-docs/tutorials/ui/gui_using_fonts.rst
• godot-docs/tutorials/ui/gui_containers.rst
• godot-docs/tutorials/rendering/multiple_resolutions.rst
• godot-docs/classes/class_theme.rst
• godot-docs/classes/class_control.rst