Compilation List Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Manage game compilations.

Secondary Purpose

  • Navigate to a compilation to add or remove games
  • Rename or delete a user-defined compilation
  • Select a compilation to browse on the Game Carousel

The Compilations screen is reached from the Admin Hub (admin mode) or from the [Compilations] CTA on the Game Carousel (browse mode). Compilations are named collections of games used to organise the library.

Main Screen Design

Admin mode

Reached from the Admin Hub. "All Games" is not shown as games cannot be meaningfully added to or removed from it.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Compilations                                                 [Add]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  LIST                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │   Name                                    Working   Broken    Total    │  │
│  ├────────────────────────────────────────────────────────────────────────┤  │
│  │ > Favourites                                    3        0        3    │  │
│  │   Multiplayer                                  10        2       12    │  │
│  │   Platform Games                                6        2        8    │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

If no compilations exist in admin mode:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Compilations                                                 [Add]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  Select Add to create a compilation.                                         │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

Browse mode

Reached from the [Compilations] CTA on the Game Carousel. No management CTAs are shown. "All Games" is included as it is a valid compilation to browse.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Compilations                                                        [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  LIST                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │   Name                                    Working   Broken    Total    │  │
│  ├────────────────────────────────────────────────────────────────────────┤  │
│  │ > All Games                                   130       12      142    │  │
│  │   Favourites                                    3        0        3    │  │
│  │   Multiplayer                                  10        2       12    │  │
│  │   Platform Games                                6        2        8    │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: [Add] and [Back] CTAs only (admin mode); [Back] CTA only (browse mode)
Interactive: [Add] and [Back] CTAs only (admin mode); [Back] CTA only (browse mode)
Purpose: Identify the current screen and, in admin mode, provide access to create compilations

[Add] CTA

Admin mode only. Navigates to the Compilation Edit screen with an empty input.

[Back] CTA

Returns to the previous screen.

LIST

Type: Single-selection vertical list
Focusable: Yes (primary focus region)
Interactive: Yes
Order: All Games first (browse mode only), then user-defined compilations alphabetically by name
Purpose: Browse and select compilations

Each row shows:

  • Compilation name
  • Working — number of games in the compilation with at least one working ROM
  • Broken — number of games with no working ROMs
  • Total — total number of games in the compilation
Mode Selecting an entry
Admin mode Navigate to the Compilation Detail screen
Browse mode Return to the Game Carousel screen with the selected compilation active

Context Menu (admin mode only)

The context menu is available on all compilations.

Action Behaviour
Rename Navigates to the Compilation Edit screen pre-populated with the current name
Delete Opens the Delete confirmation overlay

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display confirmation messages after creating, renaming, or deleting a compilation (admin mode only)

After creating a compilation:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Compilation Name> created                                                  │
└──────────────────────────────────────────────────────────────────────────────┘

After renaming a compilation:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Old Compilation Name> renamed to <New Compilation Name>                    │
└──────────────────────────────────────────────────────────────────────────────┘

After deleting a compilation:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Compilation Name> deleted                                                  │
└──────────────────────────────────────────────────────────────────────────────┘

Delete Confirmation

Admin mode only. Opens when [Delete] is activated for the focused compilation.

┌──────────────────────────────────────────────────────────────────────────────┐
│                    ┌──────────────────────────────┐                          │
│                    │ Delete <Compilation Name>?   │                          │
│                    │                              │                          │
│                    │   > Yes                      │                          │
│                    │     No                       │                          │
│                    └──────────────────────────────┘                          │
└──────────────────────────────────────────────────────────────────────────────┘

If the compilation contains games, a warning is shown:

<Compilation Name> contains <n> game(s). Deleting it will not remove the games from your library.
Option Behaviour
Yes Delete the compilation and return focus to the nearest remaining compilation
No Close the overlay and return focus to the compilation
⚠️ **GitHub.com Fallback** ⚠️