# kekmacska/gamelibrary architecture

> Architecture diagram of the GitHub repository kekmacska/gamelibrary, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kekmacska/gamelibrary
- Repository: https://github.com/kekmacska/gamelibrary

## Overview

1. **Overall shape**
   - This is a single Android app built in **native Kotlin + Jetpack Compose**.
   - The architecture is a classic mobile layering: **UI/screens → ViewModels → service/cache/providers → backend/API and local storage**.
   - There is no separate server code here; the app consumes an external backend that the README says is **Laravel 12** with a **MariaDB** database.

2. **App entry and navigation**
   - `MainActivity.kt` is the Android entry point.
   - `NavHost.kt` centralizes screen routing with **Navigation Compose**, so navigation is a shared cross-cutting concern rather than being embedded inside individual screens.
   - This is the top-level app shell that decides whether the user sees auth, main content, game details, or error states.

3. **Feature screens**
   - The `screens/` package contains the app’s primary user-facing flows:
     - `Login.kt`, `Register.kt` for authentication
     - `Main.kt` for the main game browsing experience
     - `GameDetails.kt` for a selected game’s detail view
     - `Collectibles.kt` for collectible-related data
     - `Error.kt` for failure states
   - These screens are the composition layer that binds ViewModel state to UI and orchestrates navigation.

4. **State and presentation logic**
   - The `viewModels/` package holds stateful presentation logic:
     - `Auth.kt` handles login/register/session-related state
     - `Main.kt` manages the main game list/search/browsing state
     - `Collectibles.kt` manages collectible-specific state
   - The ViewModels are the main boundary between Compose UI and data access; they likely expose observable state and user intents, keeping screens mostly declarative.

5. **Backend/data access layer**
   - `services/DataService.kt` is the main data-fetching abstraction.
   - This is the likely gateway to the remote backend API, keeping HTTP/network details out of UI and ViewModels.
   - The README says networking uses **Ktor Client**, so this service layer is where API calls, request/response mapping, and serialization concerns live.

6. **Models and serialized domain data**
   - `models/` contains the app’s core data contracts:
     - `Game`, `Collectible`, `Publisher` for catalog data
     - `User`, `Login`, `Register` for auth/account flows
   - These are the data shapes that flow from backend → service → ViewModel → screen, and they are probably also used for KotlinX serialization.

7. **Local storage and session persistence**
   - `preferences/UserPreferences.kt` and `cache/EncryptedUserPreferences.kt` indicate persistent local storage for user/session data.
   - `cache/PublisherCache.kt` suggests a small local cache for publisher-related data, likely to reduce repeated remote fetches.
   - The “encrypted” preference layer is an important boundary: sensitive user state is stored separately from ordinary app state.

8. **Platform and device-specific providers**
   - `providers/` contains platform-adjacent utilities:
     - `BiometricAuthentication.kt` for biometric sign-in / auth gating
     - `Clipboard.kt` for copy/share interactions
     - `EmulatorDetection.kt` for runtime device integrity checks
     - `Activity.kt` for activity access/interop
     - `Validator.kt` for input validation rules
   - These are not core business logic, but they shape how the app behaves on-device and how auth/security flows are enforced.

9. **Reusable UI components**
   - `components/` is the app’s shared Compose widget library.
   - It contains UI building blocks such as:
     - `GameCard`, `GameList`, `Table`, `SearchBar`, `PaginationBar`
     - `ImageCarousel`, `ImageControls`, `FullScreenImage`
     - `AuthScreenLayout`, `AuthTextField`, `SidebarLeft`
     - `GithubIssuesLink` for external navigation/help
   - These components keep screens thin and consistent, especially for list/detail/search-heavy views.

10. **Loading and skeleton states**
   - `components/shimmer/` holds placeholder versions of key screens and image/text elements.
   - This suggests the app uses a “loading skeleton” pattern while remote content is being fetched, which is a distinct UI state alongside success and error.

11. **Theme and visual system**
   - `themes/Theme.kt` defines the app’s Material 3 styling, including **dynamic color / Monet** support mentioned in the README.
   - The app is designed to inherit system colors where available, so theming is a cross-cutting presentation layer rather than a per-screen concern.

12. **External integration and runtime dependencies**
   - The app depends on an external **API backend** configured via `local.properties` rather than checked into source control.
   - It also uses **Coil 3** for image loading, which means remote image URLs are a major data path for game artwork and detail screens.
   - Serialization and networking are handled by **Ktor Client + Kotlinx Serialization**, which strongly influences the data boundary between backend responses and app models.

13. **Functional flow to draw in an architecture diagram**
   - Typical flow is: **Android activity → navigation host → screen → ViewModel → service/network or local cache → backend/local storage → state back to Compose UI**.
   - Auth flows additionally pass through **biometric/provider and encrypted preferences**.
   - Content browsing flows pass through **game/publisher models, caching, and image loading**.

14. **Key architectural boundaries**
   - **UI boundary:** `screens/` and `components/`
   - **State boundary:** `viewModels/`
   - **Data boundary:** `services/`, `cache/`, `preferences/`
   - **Platform boundary:** `providers/`
   - **Shared contract boundary:** `models/`
   - This separation is what makes the repo diagram-able as a layered Compose app rather than a monolithic UI dump.

Main entry points: [`composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Auth.kt`](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Auth.kt) (Auth VM), [`composeApp/src/main/kotlin/org/kekmacska/gamelibrary/services/DataService.kt`](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/services/DataService.kt) (DataService), [`composeApp/src/main/kotlin/org/kekmacska/gamelibrary/NavHost.kt`](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/NavHost.kt) (NavHost), [`composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Main.kt`](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Main.kt) (Main VM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_main_activity["MainActivity<br/>android entry<br/>[MainActivity.kt]"]
  node_nav_host["NavHost<br/>navigation<br/>[NavHost.kt]"]
end

subgraph group_ui["UI layer"]
  node_main_screen["Main screen<br/>[Main.kt]"]
  node_login_screen["Login<br/>screen<br/>[Login.kt]"]
  node_register_screen["Register<br/>screen<br/>[Register.kt]"]
  node_details_screen["Game details<br/>screen<br/>[GameDetails.kt]"]
  node_collectibles_screen["Collectibles<br/>screen<br/>[Collectibles.kt]"]
  node_error_screen["Error<br/>screen<br/>[Error.kt]"]
  node_theme["Theme<br/>[Theme.kt]"]
end

subgraph group_state["State layer"]
  node_auth_vm["Auth VM<br/>viewmodel<br/>[Auth.kt]"]
  node_main_vm["Main VM<br/>viewmodel<br/>[Main.kt]"]
  node_collectibles_vm["Collectibles VM<br/>viewmodel<br/>[Collectibles.kt]"]
end

subgraph group_data["Data layer"]
  node_data_service[("DataService<br/>api gateway<br/>[DataService.kt]")]
  node_user_prefs[("User prefs<br/>persistent prefs<br/>[UserPreferences.kt]")]
  node_encrypted_prefs[("Encrypted prefs<br/>secure storage")]
  node_publisher_cache[("Publisher cache<br/>[PublisherCache.kt]")]
end

subgraph group_platform["Platform helpers"]
  node_biometric{{"Biometric auth<br/>device auth"}}
  node_validator{{"Validator<br/>input rules<br/>[Validator.kt]"}}
end

subgraph group_domain["Domain models"]
  node_game_model["Game<br/>model<br/>[Game.kt]"]
  node_collectible_model["Collectible<br/>model<br/>[Collectible.kt]"]
  node_publisher_model["Publisher<br/>model<br/>[Publisher.kt]"]
  node_user_model["User<br/>model<br/>[User.kt]"]
  node_login_model["Login<br/>model<br/>[Login.kt]"]
  node_register_model["Register<br/>model<br/>[Register.kt]"]
end

node_main_activity -->|"hosts"| node_nav_host
node_nav_host -->|"routes"| node_login_screen
node_nav_host -->|"routes"| node_register_screen
node_nav_host -->|"routes"| node_main_screen
node_nav_host -->|"routes"| node_details_screen
node_nav_host -->|"routes"| node_collectibles_screen
node_nav_host -->|"routes"| node_error_screen
node_main_screen -->|"reads state"| node_main_vm
node_details_screen -->|"reads state"| node_main_vm
node_collectibles_screen -->|"reads state"| node_collectibles_vm
node_login_screen -->|"reads state"| node_auth_vm
node_register_screen -->|"reads state"| node_auth_vm
node_auth_vm -->|"auth API"| node_data_service
node_main_vm -->|"catalog API"| node_data_service
node_collectibles_vm -->|"collectibles API"| node_data_service
node_auth_vm -->|"session"| node_user_prefs
node_auth_vm -->|"secure session"| node_encrypted_prefs
node_main_vm -->|"cache hits"| node_publisher_cache
node_auth_vm -->|"gates login"| node_biometric
node_auth_vm -->|"validates"| node_validator
node_register_screen -->|"validates"| node_validator
node_main_screen -->|"styles"| node_theme
node_login_screen -->|"styles"| node_theme
node_register_screen -->|"styles"| node_theme
node_details_screen -->|"styles"| node_theme
node_main_vm -->|"uses"| node_game_model
node_collectibles_vm -->|"uses"| node_collectible_model
node_data_service -->|"maps"| node_game_model
node_data_service -->|"maps"| node_collectible_model
node_data_service -->|"maps"| node_publisher_model
node_auth_vm -->|"maps"| node_user_model
node_data_service -->|"maps"| node_login_model
node_data_service -->|"maps"| node_register_model

click node_main_activity "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/MainActivity.kt"
click node_nav_host "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/NavHost.kt"
click node_main_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Main.kt"
click node_login_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Login.kt"
click node_register_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Register.kt"
click node_details_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/GameDetails.kt"
click node_collectibles_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Collectibles.kt"
click node_error_screen "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Error.kt"
click node_theme "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/themes/Theme.kt"
click node_auth_vm "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Auth.kt"
click node_main_vm "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Main.kt"
click node_collectibles_vm "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Collectibles.kt"
click node_data_service "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/services/DataService.kt"
click node_user_prefs "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/preferences/UserPreferences.kt"
click node_encrypted_prefs "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/EncryptedUserPreferences.kt"
click node_publisher_cache "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/PublisherCache.kt"
click node_biometric "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/BiometricAuthentication.kt"
click node_validator "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/Validator.kt"
click node_game_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Game.kt"
click node_collectible_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Collectible.kt"
click node_publisher_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Publisher.kt"
click node_user_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/User.kt"
click node_login_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Login.kt"
click node_register_model "https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Register.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main_activity,node_nav_host toneBlue
class node_main_screen,node_login_screen,node_register_screen,node_details_screen,node_collectibles_screen,node_error_screen,node_theme toneAmber
class node_auth_vm,node_main_vm,node_collectibles_vm toneMint
class node_data_service,node_user_prefs,node_encrypted_prefs,node_publisher_cache toneRose
class node_biometric,node_validator toneIndigo
class node_game_model,node_collectible_model,node_publisher_model,node_user_model,node_login_model,node_register_model toneTeal
```

## Components

### App shell

Android entry point and navigation scaffold.

- [MainActivity](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/MainActivity.kt): android entry · App launch activity and Compose host. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/MainActivity.kt`
- [NavHost](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/NavHost.kt): navigation · Central screen routing for the app. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/NavHost.kt`

### UI layer

Screens, reusable Compose components, and theming.

- [Main screen](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Main.kt): screen · Primary game browsing and search UI. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Main.kt`
- [Login](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Login.kt): screen · Authentication sign-in screen. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Login.kt`
- [Register](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Register.kt): screen · Account creation screen. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Register.kt`
- [Game details](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/GameDetails.kt): screen · Selected game detail view. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/GameDetails.kt`
- [Collectibles](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Collectibles.kt): screen · Collectible-related content and state display. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Collectibles.kt`
- [Error](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Error.kt): screen · Failure and fallback UI state. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/screens/Error.kt`
- [Theme](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/themes/Theme.kt): material theme · Material 3 styling and dynamic color setup. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/themes/Theme.kt`

### State layer

ViewModels coordinating UI state and user actions.

- [Auth VM](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Auth.kt): viewmodel · Login, register, and session state. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Auth.kt`
- [Main VM](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Main.kt): viewmodel · Game browsing, search, and list state. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Main.kt`
- [Collectibles VM](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Collectibles.kt): viewmodel · Collectible-specific state and actions. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/viewModels/Collectibles.kt`

### Data layer

Remote access, local storage, and caches.

- [DataService](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/services/DataService.kt): api gateway · Remote API access and response mapping. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/services/DataService.kt`
- [User prefs](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/preferences/UserPreferences.kt): persistent prefs · Local session and user preference storage. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/preferences/UserPreferences.kt`
- [Encrypted prefs](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/EncryptedUserPreferences.kt): secure storage · Encrypted user/session persistence. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/EncryptedUserPreferences.kt`
- [Publisher cache](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/PublisherCache.kt): cache · Local cache for publisher data. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/cache/PublisherCache.kt`

### Platform helpers

Device-specific providers and runtime checks.

- [Biometric auth](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/BiometricAuthentication.kt): device auth · Biometric sign-in and auth gating. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/BiometricAuthentication.kt`
- [Validator](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/Validator.kt): input rules · Input and form validation utilities. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/providers/Validator.kt`

### Domain models

Shared data contracts passed through the app.

- [Game](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Game.kt): model · Game catalog data contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Game.kt`
- [Collectible](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Collectible.kt): model · Collectible domain contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Collectible.kt`
- [Publisher](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Publisher.kt): model · Publisher domain contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Publisher.kt`
- [User](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/User.kt): model · Authenticated user/account contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/User.kt`
- [Login](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Login.kt): model · Login request/response contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Login.kt`
- [Register](https://github.com/kekmacska/gamelibrary/blob/main/composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Register.kt): model · Registration request/response contract. · `composeApp/src/main/kotlin/org/kekmacska/gamelibrary/models/Register.kt`

## Connections

- MainActivity → NavHost: hosts · Launch activity installs the navigation shell.
- NavHost → Login: routes · Navigation selects the auth flow.
- NavHost → Register: routes · Navigation selects the registration flow.
- NavHost → Main screen: routes · Navigation selects the main browsing flow.
- NavHost → Game details: routes · Navigation opens a selected game detail view.
- NavHost → Collectibles: routes · Navigation opens collectibles content.
- NavHost → Error: routes · Navigation falls back to error states.
- Main screen → Main VM: reads state · Main UI binds browsing and search state.
- Game details → Main VM: reads state · Detail UI shares game selection state.
- Collectibles → Collectibles VM: reads state · Collectibles UI binds to its ViewModel.
- Login → Auth VM: reads state · Login UI binds auth state and actions.
- Register → Auth VM: reads state · Register UI binds auth state and actions.
- Auth VM → DataService: auth API · Authentication flows call the remote API.
- Main VM → DataService: catalog API · Game browsing and search fetch remote content.
- Collectibles VM → DataService: collectibles API · Collectible data is fetched from the backend.
- Auth VM → User prefs: session · Session state is persisted locally.
- Auth VM → Encrypted prefs: secure session · Sensitive auth data uses encrypted storage.
- Main VM → Publisher cache: cache hits · Publisher lookups can reuse local cache.
- Auth VM → Biometric auth: gates login · Biometric checks can unlock auth flows.
- Auth VM → Validator: validates · Auth forms use shared validation rules.
- Register → Validator: validates · Registration inputs are validated before submit.
- Main screen → Theme: styles · Screens consume the shared Material theme.
- Login → Theme: styles · Auth screens share the app theme.
- Register → Theme: styles · Auth screens share the app theme.
- Game details → Theme: styles · Detail screens share the app theme.
- Main VM → Game: uses · Game state is shaped by the game model.
- Collectibles VM → Collectible: uses · Collectible state is shaped by the collectible model.
- DataService → Game: maps · Remote responses are mapped into game data.
- DataService → Collectible: maps · Remote responses are mapped into collectible data.
- DataService → Publisher: maps · Remote responses are mapped into publisher data.
- Auth VM → User: maps · Auth state is shaped by the user model.
- DataService → Login: maps · Login payloads use the login contract.
- DataService → Register: maps · Registration payloads use the register contract.
