ui-localization-accessibility-workflow

name	ui-localization-accessibility-workflow
description	Operational workflow for building controller-usable, localization-safe, and accessibility-aware UI using Godot integrated UI and i18n systems.
tier	operational
godot_version	4.6+
doc_anchors	["godot-docs/tutorials/ui/gui_containers.rst","godot-docs/tutorials/rendering/multiple_resolutions.rst","godot-docs/tutorials/inputs/controllers_gamepads_joysticks.rst","godot-docs/tutorials/i18n/internationalizing_games.rst","godot-docs/tutorials/i18n/localization_using_spreadsheets.rst"]
tags	["ui","accessibility","localization"]
depends_on	["godot-skills/godot-secondary/domain-ui-input-accessibility/SKILL.md","godot-skills/godot-tertiary/input-debounce-repeat-contract/SKILL.md"]

UI Localization Accessibility Workflow

Use When

• UI screens must support controller-first navigation and localization.
• Layouts break under longer translations or alternate scripts.
• Accessibility hardening is needed before release.

Outcomes

• Interactive screens are fully navigable without mouse dependency.
• Localized text does not break critical layout structure.
• Accessibility signals (focus visibility, readable scale, non-color-only states) are enforced.

Required Rules

• Define initial focus and deterministic focus traversal on every interactive screen.
• Use container-based layouts for text-heavy UI surfaces.
• Test pseudo-localization and at least one long-string locale before signoff.
• Keep dynamic non-localized text surfaces explicit (no accidental auto-translation).

Workflow

1. Define screen focus entry, navigation map, and confirm/cancel consistency.
2. Convert brittle fixed-size layout surfaces to container-driven structure.
3. Wire localization keys and plural/context forms through i18n workflow.
4. Apply font fallback strategy for non-Latin target locales.
5. Run controller-only and pseudo-localization validation passes.

Validation

• Controller-only pass can complete each core UI flow.
• Pseudo-localization run shows no critical text clipping/overlap.
• Translation and dynamic-text nodes exhibit intended auto-translate behavior.

Failure Modes

• UI depends on mouse hover and cannot be completed with controller focus.
• Fixed-size controls clip localized strings.
• Font fallback is missing and target scripts render as tofu boxes.

Local Doc Anchors

• godot-docs/tutorials/ui/gui_containers.rst
• godot-docs/tutorials/rendering/multiple_resolutions.rst
• godot-docs/tutorials/inputs/controllers_gamepads_joysticks.rst
• godot-docs/tutorials/i18n/internationalizing_games.rst
• godot-docs/tutorials/i18n/localization_using_spreadsheets.rst