Admin Hub Screen - cressie176/Load64 GitHub Wiki
Provide the primary navigation entry point for LoadC64 administrative configuration.
- Warn the user when attention is needed before the application is usable
- Provide access to the Audit screen
- Quit the application
The Admin Hub is reached from the [Admin] CTA on the Game Carousel, or opened automatically on startup when any warning condition is true. This screen performs no state mutation. It is strictly navigational.
When no warning conditions are active:
┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR │
│ Admin [Back] │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ LIST │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ SYSTEM CONFIGURATION │ │
│ │ > General Settings │ │
│ │ Binaries │ │
│ │ │ │
│ │ GAMING CONFIGURATION │ │
│ │ Controller Families │ │
│ │ Controllers │ │
│ │ Profiles │ │
│ │ Compilations │ │
│ │ │ │
│ │ TOOLS │ │
│ │ Import Games │ │
│ │ Update LoadC64 Catalogue │ │
│ │ Audit │ │
│ │ │ │
│ │ DANGER ZONE │ │
│ │ Quit LoadC64 │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR │
└──────────────────────────────────────────────────────────────────────────────┘
When warning conditions are active (e.g. games directory not set, no games imported):
┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR │
│ Admin [Back] │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ LIST │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ SYSTEM CONFIGURATION │ │
│ │ > General Settings ⚠ │ │
│ │ Binaries │ │
│ │ │ │
│ │ GAMING CONFIGURATION │ │
│ │ Controller Families │ │
│ │ Controllers │ │
│ │ Profiles │ │
│ │ Compilations │ │
│ │ │ │
│ │ TOOLS │ │
│ │ Import Games ⚠ │ │
│ │ Update LoadC64 Catalogue │ │
│ │ Audit │ │
│ │ │ │
│ │ DANGER ZONE │ │
│ │ Quit LoadC64 │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR │
└──────────────────────────────────────────────────────────────────────────────┘
Focusable: [Back] CTA only
Interactive: [Back] CTA only
Purpose: Identify the current screen and provide navigation back to the carousel
Returns to the Game Carousel screen.
Type: Single-selection vertical list with group headers
Focusable: Yes (primary focus region)
Interactive: Yes
Order: Fixed
Purpose: Navigate to administrative sub-screens or quit the application
Items are organised into four named groups. Group headers (SYSTEM CONFIGURATION, GAMING CONFIGURATION, TOOLS, DANGER ZONE) are non-selectable; directional navigation skips them. Focus wraps vertically. Returning from a sub-screen restores focus to the previously selected item.
The DANGER ZONE group contains destructive or irreversible actions. It is rendered with a distinct visual treatment (e.g. red or warning colour) to make its nature immediately obvious. The exact treatment is an implementation decision but must be applied consistently.
Items with unresolved warning conditions display a ⚠ indicator after their label. Warning conditions are re-evaluated each time the Admin Hub is shown.
| Item | Group | Warning condition | Behaviour |
|---|---|---|---|
| General Settings | SYSTEM CONFIGURATION | Games directory is not set | Navigate to the General Settings screen |
| Binaries | SYSTEM CONFIGURATION | At least one system binary is not configured | Navigate to the Binary List screen |
| Controller Families | GAMING CONFIGURATION | — | Navigate to the Controller Family List screen |
| Controllers | GAMING CONFIGURATION | A connected controller is not configured | Navigate to the Controller List screen |
| Profiles | GAMING CONFIGURATION | — | Navigate to the Profile List screen |
| Compilations | GAMING CONFIGURATION | — | Navigate to the Compilation List screen |
| Import Games | TOOLS | No games in the library | Disabled when the games directory is not set; otherwise navigate to the Import Games screen |
| Update LoadC64 Catalogue | TOOLS | — | Navigate to the LoadC64 Catalogue Update screen |
| Audit | TOOLS | — | Navigate to the Audit screen |
| Quit LoadC64 | DANGER ZONE | — | Opens the Quit confirmation overlay |
┌──────────────────────────────────────────────────────────────────────────────┐
│ ┌──────────────────────────────┐ │
│ │ Quit LoadC64? │ │
│ │ │ │
│ │ > Yes │ │
│ │ No │ │
│ └──────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────────┘
| Option | Behaviour |
|---|---|
| Yes | Exit the application |
| No | Close the overlay and return focus to the list |
Focusable: No
Interactive: No
Purpose: Display a message when focus is on a disabled item
When Import Games is focused and disabled:
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR │
│ Set the games directory in General Settings before importing. │
└──────────────────────────────────────────────────────────────────────────────┘
Otherwise the bottom bar is empty.