Profile List Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Manage reusable launch configuration profiles.

Secondary Purpose

  • Navigate to a profile to manage its settings
  • Rename or delete a profile
  • Set the default profile

The Profiles screen is reached from the Admin Hub. Profiles are reusable launch configurations (key mappings, environment variables, and VICE arguments) that can be applied to one or more games. At most one profile may be marked as the default. The default profile is automatically applied to any game whose launch configuration does not explicitly reference any profiles.

Main Screen Design

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Profiles                                                     [Add]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  LIST                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │   Profile                                                    Default   │  │
│  ├────────────────────────────────────────────────────────────────────────┤  │
│  │ > Default                                                          ✓   │  │
│  │   Multiplayer                                                      —   │  │
│  │   Shmups                                                           —   │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

If no profiles exist:

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

TOP BAR

Focusable: [Add] and [Back] CTAs only
Interactive: [Add] and [Back] CTAs only
Purpose: Identify the current screen and provide access to create profiles

[Add] CTA

Navigates to the Edit Profile 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: Alphabetically by profile name
Purpose: Browse and select profiles

Each row shows:

  • Profile name
  • (default) label if the profile is the default

Selecting an entry navigates to the Profile Detail screen.

Context Menu

Action Behaviour
Set Default Marks the focused profile as the default. Takes effect immediately with no confirmation step.
Rename Navigates to the Edit Profile screen pre-populated with the current name
Delete Opens the Delete confirmation overlay

Set Default is not shown when the focused profile is already the default.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display confirmation messages after creating, renaming, deleting, or changing the default profile

After creating a profile:

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

After renaming a profile:

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

After deleting a profile:

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

After setting the default:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Profile Name> set as default                                               │
└──────────────────────────────────────────────────────────────────────────────┘

Delete Confirmation

Opens when Delete is selected from the context menu for the focused profile.

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

If the profile is referenced by one or more games, a warning is shown:

<Profile Name> is used by <n> game(s). Deleting it will remove their profile reference.
Option Behaviour
Yes Delete the profile and return focus to the nearest remaining profile
No Close the overlay and return focus to the list

Deleting a profile also permanently deletes all of its key mappings, environment variables, and VICE arguments.

⚠️ **GitHub.com Fallback** ⚠️