# evafung/mini-memory-game architecture

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

- Interactive diagram: https://gitdiagram.com/evafung/mini-memory-game
- Repository: https://github.com/evafung/mini-memory-game

## Overview

Mini Memory Game is a browser-only React game: the player starts a round, watches a generated shape sequence, repeats it before time expires, and progresses through increasingly difficult rounds for score bonuses. The app also provides settings, audio/haptic feedback, and a personal leaderboard stored locally. App.tsx is the documented screen and transition coordinator. Several component and service links are supported by the source index, but their runtime call sites were not excerpted; those links are marked dashed and unverified.

Main entry points: [`src/App.tsx`](https://github.com/evafung/mini-memory-game/blob/main/src/App.tsx) (Game screens), [`src/components/PersonalLeaderboard.tsx`](https://github.com/evafung/mini-memory-game/blob/main/src/components/PersonalLeaderboard.tsx) (Leaderboard screen), [`src/game/useGameAudio.ts`](https://github.com/evafung/mini-memory-game/blob/main/src/game/useGameAudio.ts) (Game audio), [`src/components/SettingsPage.tsx`](https://github.com/evafung/mini-memory-game/blob/main/src/components/SettingsPage.tsx) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game flow"]
  node_app["Game screens<br/>[App.tsx]"]
  node_engine["Sequence and scoring<br/>[engine.ts]"]
end

subgraph group_experience["Player experience"]
  node_shape_ui["Shape graphics<br/>[ShapeIcons.tsx]"]
  node_home_nav["Home navigation<br/>[HomeNavigation.tsx]"]
  node_page_header["Page header<br/>[PageHeader.tsx]"]
  node_audio["Game audio<br/>[useGameAudio.ts]"]
  node_haptics["Haptic feedback<br/>[hapticService.ts]"]
  node_motion["Reduced-motion preference"]
end

subgraph group_records["Settings and records"]
  node_settings_ui["Settings screen<br/>[SettingsPage.tsx]"]
  node_leaderboard_ui["Leaderboard screen"]
  node_relative_time["Relative time"]
  node_settings_service["Settings persistence<br/>[settingsService.ts]"]
  node_leaderboard_service["Leaderboard records"]
end

subgraph group_platform["Browser services"]
  node_browser_storage[("Browser local storage")]
  node_browser_audio["Browser audio"]
  node_device_vibration["Device vibration"]
end

node_player(("Player"))

node_player -->|"plays"| node_app
node_app -->|"generates sequences"| node_engine
node_app -->|"triggers feedback"| node_haptics
node_app -->|"saves settings"| node_settings_service
node_app -.->|"renders shapes"| node_shape_ui
node_app -.->|"shows navigation"| node_home_nav
node_app -.->|"shows settings"| node_settings_ui
node_app -.->|"shows leaderboard"| node_leaderboard_ui
node_app -.->|"uses audio"| node_audio
node_app -.->|"checks preference"| node_motion
node_home_nav -->|"renders icons"| node_shape_ui
node_settings_ui -->|"renders header"| node_page_header
node_settings_ui -->|"renders icons"| node_shape_ui
node_leaderboard_ui -->|"renders header"| node_page_header
node_leaderboard_ui -->|"formats dates"| node_relative_time
node_leaderboard_ui -.->|"displays entries"| node_leaderboard_service
node_settings_service -->|"reads and writes"| node_browser_storage
node_leaderboard_service -->|"reads and writes"| node_browser_storage
node_audio -.->|"uses settings"| node_settings_service
node_audio -->|"plays sounds"| node_browser_audio
node_haptics -->|"requests vibration"| node_device_vibration

click node_app "https://github.com/evafung/mini-memory-game/blob/main/src/App.tsx"
click node_engine "https://github.com/evafung/mini-memory-game/blob/main/src/game/engine.ts"
click node_shape_ui "https://github.com/evafung/mini-memory-game/blob/main/src/components/ShapeIcons.tsx"
click node_home_nav "https://github.com/evafung/mini-memory-game/blob/main/src/components/HomeNavigation.tsx"
click node_page_header "https://github.com/evafung/mini-memory-game/blob/main/src/components/PageHeader.tsx"
click node_settings_ui "https://github.com/evafung/mini-memory-game/blob/main/src/components/SettingsPage.tsx"
click node_leaderboard_ui "https://github.com/evafung/mini-memory-game/blob/main/src/components/PersonalLeaderboard.tsx"
click node_relative_time "https://github.com/evafung/mini-memory-game/blob/main/src/components/formatRelativeTime.ts"
click node_settings_service "https://github.com/evafung/mini-memory-game/blob/main/src/services/settingsService.ts"
click node_leaderboard_service "https://github.com/evafung/mini-memory-game/blob/main/src/services/leaderboardService.ts"
click node_audio "https://github.com/evafung/mini-memory-game/blob/main/src/game/useGameAudio.ts"
click node_haptics "https://github.com/evafung/mini-memory-game/blob/main/src/services/hapticService.ts"
click node_motion "https://github.com/evafung/mini-memory-game/blob/main/src/hooks/usePrefersReducedMotion.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_app,node_engine toneBlue
class node_shape_ui,node_home_nav,node_page_header,node_audio,node_haptics,node_motion toneAmber
class node_settings_ui,node_leaderboard_ui,node_relative_time,node_settings_service,node_leaderboard_service toneMint
class node_browser_storage,node_browser_audio,node_device_vibration toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Game screens](https://github.com/evafung/mini-memory-game/blob/main/src/App.tsx): `src/App.tsx`
- [Sequence and scoring](https://github.com/evafung/mini-memory-game/blob/main/src/game/engine.ts): `src/game/engine.ts`

### Player experience

- [Shape graphics](https://github.com/evafung/mini-memory-game/blob/main/src/components/ShapeIcons.tsx): `src/components/ShapeIcons.tsx`
- [Home navigation](https://github.com/evafung/mini-memory-game/blob/main/src/components/HomeNavigation.tsx): `src/components/HomeNavigation.tsx`
- [Page header](https://github.com/evafung/mini-memory-game/blob/main/src/components/PageHeader.tsx): `src/components/PageHeader.tsx`
- [Game audio](https://github.com/evafung/mini-memory-game/blob/main/src/game/useGameAudio.ts): `src/game/useGameAudio.ts`
- [Haptic feedback](https://github.com/evafung/mini-memory-game/blob/main/src/services/hapticService.ts): `src/services/hapticService.ts`
- [Reduced-motion preference](https://github.com/evafung/mini-memory-game/blob/main/src/hooks/usePrefersReducedMotion.ts): `src/hooks/usePrefersReducedMotion.ts`

### Settings and records

- [Settings screen](https://github.com/evafung/mini-memory-game/blob/main/src/components/SettingsPage.tsx): `src/components/SettingsPage.tsx`
- [Leaderboard screen](https://github.com/evafung/mini-memory-game/blob/main/src/components/PersonalLeaderboard.tsx): `src/components/PersonalLeaderboard.tsx`
- [Relative time](https://github.com/evafung/mini-memory-game/blob/main/src/components/formatRelativeTime.ts): `src/components/formatRelativeTime.ts`
- [Settings persistence](https://github.com/evafung/mini-memory-game/blob/main/src/services/settingsService.ts): `src/services/settingsService.ts`
- [Leaderboard records](https://github.com/evafung/mini-memory-game/blob/main/src/services/leaderboardService.ts): `src/services/leaderboardService.ts`

### Browser services

- **Browser local storage**
- **Browser audio**
- **Device vibration**

### Other components

- **Player**

## Connections

- Player → Game screens: plays (evidence: `README.md`)
- Game screens → Sequence and scoring: generates sequences (evidence: `src/App.tsx`)
- Game screens → Haptic feedback: triggers feedback (evidence: `src/App.tsx`)
- Game screens → Settings persistence: saves settings (evidence: `src/App.tsx`)
- Game screens → Shape graphics: renders shapes (evidence: `src/App.tsx`)
- Game screens → Home navigation: shows navigation (evidence: `src/App.tsx`)
- Game screens → Settings screen: shows settings (evidence: `src/App.tsx`)
- Game screens → Leaderboard screen: shows leaderboard (evidence: `src/App.tsx`)
- Game screens → Game audio: uses audio (evidence: `src/App.tsx`)
- Game screens → Reduced-motion preference: checks preference (evidence: `src/App.tsx`)
- Home navigation → Shape graphics: renders icons (evidence: `src/components/HomeNavigation.tsx`)
- Settings screen → Page header: renders header (evidence: `src/components/SettingsPage.tsx`)
- Settings screen → Shape graphics: renders icons (evidence: `src/components/SettingsPage.tsx`)
- Leaderboard screen → Page header: renders header (evidence: `src/components/PersonalLeaderboard.tsx`)
- Leaderboard screen → Relative time: formats dates (evidence: `src/components/PersonalLeaderboard.tsx`)
- Leaderboard screen → Leaderboard records: displays entries (evidence: `src/components/PersonalLeaderboard.tsx`)
- Settings persistence → Browser local storage: reads and writes (evidence: `src/services/settingsService.ts`)
- Leaderboard records → Browser local storage: reads and writes (evidence: `src/services/leaderboardService.ts`)
- Game audio → Settings persistence: uses settings (evidence: `src/game/useGameAudio.ts`)
- Game audio → Browser audio: plays sounds (evidence: `src/game/useGameAudio.ts`)
- Haptic feedback → Device vibration: requests vibration (evidence: `src/services/hapticService.ts`)
