# itsmika987/uma-web architecture

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

- Interactive diagram: https://gitdiagram.com/itsmika987/uma-web
- Repository: https://github.com/itsmika987/uma-web

## Overview

Uma-Web is a browser-based reconstruction of Umamusume, with a hub for home, scouting, enhancement, and race access. The clearest evidenced workflow is entering the home hub, opening Enhance, choosing trainee or support-card lists, and viewing roster-derived entries. The repository also has separate race, selection, settings, and game-area routes, plus local browser state and save import/export. Those routes’ internal wiring is not established by the excerpts, so their connections are omitted rather than inferred.

Main entry points: [`src/routes/home/+page.svelte`](https://github.com/itsmika987/uma-web/blob/main/src/routes/home/%2Bpage.svelte) (Home Hub), [`src/lib/stores/game.ts`](https://github.com/itsmika987/uma-web/blob/main/src/lib/stores/game.ts) (Game State), [`src/lib/ui/EnhanceContent.svelte`](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/EnhanceContent.svelte) (Enhance Menu), [`src/routes/select/+page.svelte`](https://github.com/itsmika987/uma-web/blob/main/src/routes/select/%2Bpage.svelte) (Race Selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hub["Game Hub"]
  node_home["Home Hub<br/>[+page.svelte]"]
  node_homecontent["Home View<br/>[HomeContent.svelte]"]
end

subgraph group_collection["Roster &amp; Collection"]
  node_enhance["Enhance Menu"]
  node_trainee["Trainee Menu"]
  node_traineelist["Trainee List"]
  node_support["Support Menu"]
  node_supportlist["Support List"]
  node_scout["Scouting"]
end

subgraph group_gameplay["Game Areas"]
  node_raceentry["Race Selection<br/>[+page.svelte]"]
  node_race["Race Views<br/>[RacePC.svelte]"]
  node_racemobile["Mobile Race<br/>[RaceMobile.svelte]"]
  node_settings["Settings<br/>[+page.svelte]"]
  node_gameareas["Other Game Routes"]
end

subgraph group_state["Data &amp; State"]
  node_gamestate["Game State<br/>[game.ts]"]
  node_characters["Character Data<br/>[characters.ts]"]
  node_supportdata["Support Card Data<br/>[supportCards.ts]"]
  node_theme["Theme State<br/>[theme.ts]"]
end

node_player(("Player"))

node_player -.->|"opens"| node_home
node_home -->|"renders"| node_homecontent
node_home -->|"renders"| node_enhance
node_home -->|"renders"| node_scout
node_home -->|"navigates"| node_raceentry
node_home -->|"navigates"| node_settings
node_enhance -->|"renders"| node_trainee
node_enhance -->|"renders"| node_support
node_trainee -->|"renders"| node_traineelist
node_support -->|"renders"| node_supportlist
node_traineelist -->|"reads roster"| node_gamestate
node_supportlist -->|"reads roster"| node_gamestate
node_gamestate -->|"reads"| node_characters
node_gamestate -->|"reads"| node_supportdata
node_home -.->|"offers routes"| node_gameareas
node_raceentry -.->|"selects view"| node_race
node_raceentry -.->|"selects view"| node_racemobile

click node_home "https://github.com/itsmika987/uma-web/blob/main/src/routes/home/%2Bpage.svelte"
click node_homecontent "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/HomeContent.svelte"
click node_enhance "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/EnhanceContent.svelte"
click node_trainee "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/TraineeContent.svelte"
click node_traineelist "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/TraineeListContent.svelte"
click node_support "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/SupportCardContent.svelte"
click node_supportlist "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/SupportCardListContent.svelte"
click node_scout "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/ScoutContent.svelte"
click node_raceentry "https://github.com/itsmika987/uma-web/blob/main/src/routes/select/%2Bpage.svelte"
click node_race "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/RacePC.svelte"
click node_racemobile "https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/RaceMobile.svelte"
click node_settings "https://github.com/itsmika987/uma-web/blob/main/src/routes/settings/%2Bpage.svelte"
click node_gameareas "https://github.com/itsmika987/uma-web/tree/main/src/routes/0"
click node_gamestate "https://github.com/itsmika987/uma-web/blob/main/src/lib/stores/game.ts"
click node_characters "https://github.com/itsmika987/uma-web/blob/main/src/lib/data/characters.ts"
click node_supportdata "https://github.com/itsmika987/uma-web/blob/main/src/lib/data/supportCards.ts"
click node_theme "https://github.com/itsmika987/uma-web/blob/main/src/lib/stores/theme.ts"

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_home,node_homecontent toneBlue
class node_enhance,node_trainee,node_traineelist,node_support,node_supportlist,node_scout toneAmber
class node_raceentry,node_race,node_racemobile,node_settings,node_gameareas toneMint
class node_gamestate,node_characters,node_supportdata,node_theme toneRose
class node_player toneIndigo
```

## Components

### Game Hub

- [Home Hub](https://github.com/itsmika987/uma-web/blob/main/src/routes/home/%2Bpage.svelte): `src/routes/home/+page.svelte`
- [Home View](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/HomeContent.svelte): `src/lib/ui/HomeContent.svelte`

### Roster & Collection

- [Enhance Menu](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/EnhanceContent.svelte): `src/lib/ui/EnhanceContent.svelte`
- [Trainee Menu](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/TraineeContent.svelte): `src/lib/ui/TraineeContent.svelte`
- [Trainee List](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/TraineeListContent.svelte): `src/lib/ui/TraineeListContent.svelte`
- [Support Menu](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/SupportCardContent.svelte): `src/lib/ui/SupportCardContent.svelte`
- [Support List](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/SupportCardListContent.svelte): `src/lib/ui/SupportCardListContent.svelte`
- [Scouting](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/ScoutContent.svelte): `src/lib/ui/ScoutContent.svelte`

### Game Areas

- [Race Selection](https://github.com/itsmika987/uma-web/blob/main/src/routes/select/%2Bpage.svelte): `src/routes/select/+page.svelte`
- [Race Views](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/RacePC.svelte): `src/lib/ui/RacePC.svelte`
- [Mobile Race](https://github.com/itsmika987/uma-web/blob/main/src/lib/ui/RaceMobile.svelte): `src/lib/ui/RaceMobile.svelte`
- [Settings](https://github.com/itsmika987/uma-web/blob/main/src/routes/settings/%2Bpage.svelte): `src/routes/settings/+page.svelte`
- [Other Game Routes](https://github.com/itsmika987/uma-web/tree/main/src/routes/0): `src/routes/0`

### Data & State

- [Game State](https://github.com/itsmika987/uma-web/blob/main/src/lib/stores/game.ts): `src/lib/stores/game.ts`
- [Character Data](https://github.com/itsmika987/uma-web/blob/main/src/lib/data/characters.ts): `src/lib/data/characters.ts`
- [Support Card Data](https://github.com/itsmika987/uma-web/blob/main/src/lib/data/supportCards.ts): `src/lib/data/supportCards.ts`
- [Theme State](https://github.com/itsmika987/uma-web/blob/main/src/lib/stores/theme.ts): `src/lib/stores/theme.ts`

### Other components

- **Player**

## Connections

- Player → Home Hub: opens
- Home Hub → Home View: renders (evidence: `src/routes/home/+page.svelte`)
- Home Hub → Enhance Menu: renders (evidence: `src/routes/home/+page.svelte`)
- Home Hub → Scouting: renders (evidence: `src/routes/home/+page.svelte`)
- Home Hub → Race Selection: navigates (evidence: `src/routes/home/+page.svelte`)
- Home Hub → Settings: navigates (evidence: `src/routes/home/+page.svelte`)
- Enhance Menu → Trainee Menu: renders (evidence: `src/lib/ui/EnhanceContent.svelte`)
- Enhance Menu → Support Menu: renders (evidence: `src/lib/ui/EnhanceContent.svelte`)
- Trainee Menu → Trainee List: renders (evidence: `src/lib/ui/TraineeContent.svelte`)
- Support Menu → Support List: renders (evidence: `src/lib/ui/SupportCardContent.svelte`)
- Trainee List → Game State: reads roster (evidence: `src/lib/ui/TraineeListContent.svelte`)
- Support List → Game State: reads roster (evidence: `src/lib/ui/SupportCardListContent.svelte`)
- Game State → Character Data: reads (evidence: `src/lib/stores/game.ts`)
- Game State → Support Card Data: reads (evidence: `src/lib/stores/game.ts`)
- Home Hub → Other Game Routes: offers routes
- Race Selection → Race Views: selects view
- Race Selection → Mobile Race: selects view
