Godot UI Design Excellence
Produce a coherent, playable interface with an authored visual identity. "AAA" is an ambition for craft, not an aesthetic preset or a quality guarantee. Preserve the project's identity; never substitute a generic dashboard, fantasy skin, or unrequested redesign.
Start with the right amount of context
Inspect the current screen, project instructions, engine version, renderer, target devices, existing UI scenes/themes, and available tools. Read discovery for new work; skip repeated discovery for a small established task. Ask about genuinely unresolved design requirements rather than inventing the user's game. Do not ask questions already answered by the repo.
Read only the relevant rows below. Usually load 2–4 modules for the current stage, not the entire library. Source and example files are optional lookups. Finish a stage, persist decisions, then load the next stage's references. For a small fix, choose the narrow repair route without restarting art direction.
| Task / symptom | Read |
|---|---|
| New visual identity, references, "make it modern" | Reference analysis, art direction |
| Generic layout, weak hierarchy | Composition, critique and repair |
| Fonts, numbers, readability | Typography, Godot text |
| Colors, texture, ornaments, icons | Color and materials, iconography |
| State language and reusable components | Component states, Godot themes |
| Information architecture and decisions | Interaction |
| Cinematic / painterly RPG | RPG direction, worked RPG example |
| Dense management / strategy | Strategy direction, worked strategy example |
| Expressive or tactical identity | Other visual directions |
| Inventory, equipment, build comparison | Inventory and buildcraft |
| Maps, research trees, spatial navigation | Maps and trees |
| Tooltips, alerts, notifications | Tooltips and notifications |
| Settings, confirmation, dialogue | Settings and dialogue |
| Motion / transitions / sound | Motion design, audio feedback |
| Art production / generated assets | Asset production |
| Layout, scaling, safe areas | Godot layout |
| Input leak, focus, modal, device switching | Godot input |
| Interrupted animations, layout fighting tweens | Godot animation |
| Shader, blur, masks, custom drawing | Godot rendering |
| Portraits, 3D previews, world-space UI | Godot spatial UI |
| Data binding, loading, large lists, performance | Godot data and performance |
| Accessibility or localization acceptance | Accessibility, Godot text |
| Verify or review a delivered screen | Visual validation, critique and repair |
| Permissions, tools, external references | Evidence and safety |
| Primary sources / changing APIs | Source register |
Production loop
- Frame the decision. Who is acting, what must they notice, what can they do, and what is the cost of a mistake? Capture constraints in the design brief, proportionate to the request.
- Observe references. Inspect actual screenshots and, for motion claims, recordings. Distinguish shipped screens, concepts, and original proposals. Extract a visual grammar, not a bag of decorative motifs.
- Choose a direction. Define composition, typography, shape/material roles, information hierarchy, and motion character. Explore meaningfully different options only when direction is open. Respect explicit delegation of choices.
- Build one representative screen. Use real or labeled fixture data, real background variation, and normal/focused/disabled/error states. Use the screen contract. Do not scale out an unproven skin.
- Implement natively. Use semantic Controls and reusable scenes, Themes and variants, authored assets, and bounded decorative effects. Detect the installed Godot version before using version-sensitive APIs; never upgrade it implicitly.
- Inspect and revise. Run the real scene, capture it at target sizes, exercise input and animation interruptions, then correct the most consequential visual or interaction failure. Use the visual review.
- Generalize after acceptance. Extract components and tokens from the accepted screen, apply to sibling screens, and record exceptions. Hand off evidence and remaining limits with the handoff.
Non-negotiable distinctions
- Functional correctness, visual fidelity, usability, and accessibility are separate acceptance axes. A polished screenshot cannot compensate for a trapped user; a passing build cannot prove visual quality.
- "Modern" does not require glass, neon, huge cards, tiny text, or springy buttons. Use texture and motion for a stated purpose, not to conceal weak hierarchy.
- Keep functional text and interaction native. Do not ship a flattened generated screenshot as an interface. Inspect actual alpha, scale, and asset provenance.
- Focus, hover, selection, equipped, locked, disabled, and busy are not synonyms. Decorative transitions must not silently delay input or commit an action.
- No blanket ban on manual coordinates, continuous updates, or linear motion. Choose the appropriate coordinate space, update cadence, and semantic behavior.
- No invented runtime tests, fabricated screenshots, invisible tool capabilities, or claims of accessibility certification. Label unavailable checks explicitly.
Persist decisions and evidence in the project rather than repeating long reference text in chat. For delegation, send the relevant module names, screen contract, asset paths, and acceptance checks—not the whole skill. For installation, tools, validation scripts, and evaluation cases, see README.