TinyBrainGames

← horaciovaldes.com

Tiny Brain Games

Tiny Brain Games is a SwiftUI collection of quick, single-session mini-games that focus on reflexes, memory, and attention. Each game is designed to be finished in under a minute and tracks best scores per difficulty.

Games

• Reaction Tap: wait for the signal, then tap as fast as possible. (10–20s)
• Memory Flash: watch a flashing sequence, then repeat it as it grows. (15–30s)
• Odd One Out: find the tile that differs within a timed session. (20s)
• Color Match: tap the text color (or the word during rule flips). (20s)
• Brick Breaker: classic paddle-and-ball with short rounds. (30–60s)

Features

• Three difficulty levels per game (Easy, Medium, Hard)
• Best scores saved per game and difficulty
• Haptics for feedback on iOS
• SwiftUI + MVVM structure with dedicated view models

Requirements

• Xcode with the iOS 26.2 SDK
• iOS deployment target set to 26.2 (see TinyBrainGames.xcodeproj)

Run

1. Open TinyBrainGames.xcodeproj in Xcode.
2. Select the TinyBrainGames scheme.
3. Run on a simulator or device.

Tests

• Unit and UI test targets exist but are currently scaffolds.
• Run tests with Cmd-U in Xcode.

Project Structure

• TinyBrainGames/Views: SwiftUI screens for each game and shared UI components
• TinyBrainGames/ViewModels: game logic and timers
• TinyBrainGames/Models: game state, scoring, and difficulty
• TinyBrainGames/Utilities: utilities like haptics

Adding Custom Art / Reskinning the App

This project uses a theme layer (TinyBrainGames/UITheme) so you can swap artwork without touching gameplay code.

Step-by-step

1. Open TinyBrainGames/Assets.xcassets in Xcode.
2. Add Image Sets with the exact names listed below.
3. Drop your PNGs or a single-scale PDF into each Image Set.
4. Build and run. Missing assets fall back to the current SwiftUI shapes/materials.

Exact asset names (match UIAssetRole raw values)

• ui/screen_background
• ui/home_card_background
• ui/home_card_icon_background
• ui/tile_hidden
• ui/tile_revealed
• ui/tile_highlight_good
• ui/tile_highlight_good_strong
• ui/tile_highlight_bad
• ui/button_primary_background
• ui/button_secondary_background

Recommended sizes and scaling

• Full-screen background: vector PDF preferred, or raster 2732x2048 @1x with @2x/@3x.
• Card backgrounds: 800x400 @1x (or vector PDF) with @2x/@3x.
• Icon backgrounds: 128x128 @1x with @2x/@3x.
• Tile backgrounds: 128x128 @1x with @2x/@3x.
• Button backgrounds: 400x120 @1x (or vector PDF) with @2x/@3x.
• See AssetNamingPlan.md for the full list.

How the fallback system works

• The default theme (DefaultArtProvider) uses the current SwiftUI materials and colors.
• If an image asset is missing, the UI renders exactly as it does today.
• This means you can add art incrementally without breaking the app.

How to add a new theme/provider

1. Create a new type that conforms to ArtProvider in TinyBrainGames/UITheme.
2. Return images/colors/materials for any roles you want to override.
3. Swap the theme at app launch, for example:

@StateObject private var themeStore = ThemeStore(
    theme: Theme(
        tokens: .default,
        primaryArt: AssetCatalogArtProvider(),
        fallbackArt: DefaultArtProvider()
    )
)

Global assets + per-game overrides

Use a global provider for shared art, then layer a per-game provider for a specific view.

Global provider at app launch:

@StateObject private var themeStore = ThemeStore(
    theme: Theme(
        tokens: .default,
        primaryArt: AssetCatalogArtProvider(),
        fallbackArt: DefaultArtProvider()
    )
)

Per-game override provider (example for Minesweeper):

struct MinesweeperArtProvider: ArtProvider {
    func image(for role: UIAssetRole) -> Image? {
        switch role {
        case .tileHidden:
            return AssetCatalog.imageIfExists(named: "ui/games/minesweeper/tile_hidden")
        case .tileRevealed:
            return AssetCatalog.imageIfExists(named: "ui/games/minesweeper/tile_revealed")
        case .tileHighlightGood:
            return AssetCatalog.imageIfExists(named: "ui/games/minesweeper/tile_highlight_good")
        case .tileHighlightBad:
            return AssetCatalog.imageIfExists(named: "ui/games/minesweeper/tile_highlight_bad")
        default:
            return nil
        }
    }
}

Apply the override only to that game:

MinesweeperView(highScoreStore: highScoreStore)
    .environmentObject(
        ThemeStore(theme: themeStore.theme.applying(overrideArt: MinesweeperArtProvider()))
    )

Notes:

• If a per-game asset is missing, the global provider and default theme are used.
• You can override only a few roles and keep the rest global.

How to override only one game’s art

1. Create a focused ArtProvider that only returns assets for that game’s roles.
2. Inject a local theme for that game’s view hierarchy:

GameView()
    .environmentObject(
        ThemeStore(theme: themeStore.theme.applying(overrideArt: MyGameArtProvider()))
    )

How to test art changes quickly

1. Add or update the Image Set assets.
2. Use AssetCatalogArtProvider in your theme (example above).
3. Restart the preview or re-run the app to see changes immediately.