TinyBrainGames

← horaciovaldes.com

UI Theme Asset Naming Plan

This file lists the stable asset names mapped from UIAssetRole and recommended sizes for future art.

Image Asset Names (Image Sets)

• ui/screen_background
  • Recommended: vector PDF preferred, or raster 2732x2048 @1x (for iPad Pro), with @2x/@3x as needed.
  • Notes: Use full-bleed art that can be scaled and cropped.
• ui/home_card_background
  • Recommended: 800x400 @1x (or vector PDF), with @2x/@3x.
  • Notes: Should tolerate corner cropping and safe padding.
• ui/home_card_icon_background
  • Recommended: 128x128 @1x (or vector PDF), with @2x/@3x.
  • Notes: Used behind SF Symbols on Home cards.
• ui/tile_hidden
  • Recommended: 128x128 @1x, with @2x/@3x.
• ui/tile_revealed
  • Recommended: 128x128 @1x, with @2x/@3x.
• ui/tile_highlight_good
  • Recommended: 128x128 @1x, with @2x/@3x.
• ui/tile_highlight_good_strong
  • Recommended: 128x128 @1x, with @2x/@3x.
• ui/tile_highlight_bad
  • Recommended: 128x128 @1x, with @2x/@3x.
• ui/button_primary_background
  • Recommended: 400x120 @1x (or vector PDF), with @2x/@3x.
• ui/button_secondary_background
  • Recommended: 400x120 @1x (or vector PDF), with @2x/@3x.

Optional per-game overrides

Use these names if you want one game to have custom art while keeping the global assets for everything else.

Naming pattern:

• ui/games/<game_id>/<role_suffix>

Recommended game IDs:

• reaction_tap
• memory_flash
• odd_one_out
• color_match
• brick_breaker
• minesweeper

Common role suffixes (match UIAssetRole names without the ui/ prefix):

• tile_hidden
• tile_revealed
• tile_highlight_good
• tile_highlight_good_strong
• tile_highlight_bad
• home_card_background
• home_card_icon_background
• button_primary_background
• button_secondary_background

Color/Material Roles

These roles are currently provided by the default theme as SwiftUI colors/materials and do not require image assets:

• ui/home_card_border
• ui/home_card_chevron_pill
• ui/text_primary
• ui/text_secondary
• ui/accent
• ui/tile_border

If you want color-only overrides, add Color Sets with the same names and implement an ArtProvider that reads them.