# vyk2rr/music-memory architecture

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

- Interactive diagram: https://gitdiagram.com/vyk2rr/music-memory
- Repository: https://github.com/vyk2rr/music-memory

## Overview

This is a React/TypeScript piano-chord memory game. A player flips chord cards; the game generates and matches chord pairs, updates attempts and win state, and sends the selected chord to the piano for playback and visual highlighting. The piano also supports direct key clicks, with Tone.js handling synthesis. The graph reflects the sampled components and README; other possible capabilities suggested by types or unsampled files are not treated as verified workflows.

Main entry points: [`src/PianoMemoryGame/PianoMemoryGame.tsx`](https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/PianoMemoryGame.tsx) (Memory game), [`src/PianoBase/PianoBase.tsx`](https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.tsx) (Piano keys and display), [`src/PianoBase/PianoBase.types.ts`](https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.types.ts) (Musical types), [`src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx`](https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx) (Memory board)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Game experience"]
  node_app["React entry app<br/>[App.tsx]"]
  node_game["Memory game"]
  node_board["Memory board<br/>[MemoryBoard.tsx]"]
end

subgraph group_piano["Piano interaction"]
  node_piano["Piano keys and display<br/>[PianoBase.tsx]"]
  node_piano_utils["Key layout utilities<br/>[PianoBase.utils.ts]"]
  node_observer["Piano event observer<br/>[PianoObserver.ts]"]
end

subgraph group_audio["Audio and feedback"]
  node_highlight["Highlight state<br/>[useHighlight.ts]"]
  node_tone_hook["Tone playback hook<br/>[useToneJs.tsx]"]
  node_tone["Tone.js"]
end

subgraph group_domain["Music domain"]
  node_chord_rules["Chord and color rules"]
  node_types["Musical types<br/>[PianoBase.types.ts]"]
end

node_player(("Player"))

node_player -->|"opens game"| node_app
node_app -->|"renders"| node_game
node_player -->|"plays cards"| node_game
node_game -->|"generates chords"| node_chord_rules
node_game -->|"renders cards"| node_board
node_board -->|"reports clicks"| node_game
node_game -->|"sets chord"| node_piano
node_game -->|"creates synth and reverb"| node_tone
node_piano -->|"builds key layout"| node_piano_utils
node_piano -->|"tracks highlights"| node_highlight
node_piano -->|"delegates playback"| node_tone_hook
node_piano -->|"notifies events"| node_observer
node_tone_hook -->|"synthesizes and schedules"| node_tone
node_piano_utils -->|"uses note definitions"| node_types
node_chord_rules -->|"uses chord definitions"| node_types
node_board -->|"uses chord data"| node_types
node_piano -->|"uses piano contracts"| node_types
node_observer -->|"uses event types"| node_types
node_tone_hook -->|"uses playback types"| node_types

click node_app "https://github.com/vyk2rr/music-memory/blob/main/src/App.tsx"
click node_game "https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/PianoMemoryGame.tsx"
click node_board "https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx"
click node_chord_rules "https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/MemoryBoard/MemoryBoard.utils.tsx"
click node_piano "https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.tsx"
click node_piano_utils "https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.utils.ts"
click node_highlight "https://github.com/vyk2rr/music-memory/blob/main/src/hooks/useHighlight/useHighlight.ts"
click node_tone_hook "https://github.com/vyk2rr/music-memory/blob/main/src/hooks/useToneJs/useToneJs.tsx"
click node_observer "https://github.com/vyk2rr/music-memory/blob/main/src/PianoObserver/PianoObserver.ts"
click node_types "https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.types.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_game,node_board toneBlue
class node_piano,node_piano_utils,node_observer toneAmber
class node_highlight,node_tone_hook,node_tone toneMint
class node_chord_rules,node_types toneRose
class node_player toneIndigo
```

## Components

### Game experience

- [React entry app](https://github.com/vyk2rr/music-memory/blob/main/src/App.tsx): `src/App.tsx`
- [Memory game](https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/PianoMemoryGame.tsx): `src/PianoMemoryGame/PianoMemoryGame.tsx`
- [Memory board](https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx): `src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx`

### Piano interaction

- [Piano keys and display](https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.tsx): `src/PianoBase/PianoBase.tsx`
- [Key layout utilities](https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.utils.ts): `src/PianoBase/PianoBase.utils.ts`
- [Piano event observer](https://github.com/vyk2rr/music-memory/blob/main/src/PianoObserver/PianoObserver.ts): `src/PianoObserver/PianoObserver.ts`

### Audio and feedback

- [Highlight state](https://github.com/vyk2rr/music-memory/blob/main/src/hooks/useHighlight/useHighlight.ts): `src/hooks/useHighlight/useHighlight.ts`
- [Tone playback hook](https://github.com/vyk2rr/music-memory/blob/main/src/hooks/useToneJs/useToneJs.tsx): `src/hooks/useToneJs/useToneJs.tsx`
- **Tone.js**

### Music domain

- [Chord and color rules](https://github.com/vyk2rr/music-memory/blob/main/src/PianoMemoryGame/MemoryBoard/MemoryBoard.utils.tsx): `src/PianoMemoryGame/MemoryBoard/MemoryBoard.utils.tsx`
- [Musical types](https://github.com/vyk2rr/music-memory/blob/main/src/PianoBase/PianoBase.types.ts): `src/PianoBase/PianoBase.types.ts`

### Other components

- **Player**

## Connections

- Player → React entry app: opens game (evidence: `README.md`)
- React entry app → Memory game: renders (evidence: `src/App.tsx`)
- Player → Memory game: plays cards (evidence: `README.md`)
- Memory game → Chord and color rules: generates chords (evidence: `src/PianoMemoryGame/PianoMemoryGame.tsx`)
- Memory game → Memory board: renders cards (evidence: `src/PianoMemoryGame/PianoMemoryGame.tsx`)
- Memory board → Memory game: reports clicks (evidence: `src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx`)
- Memory game → Piano keys and display: sets chord (evidence: `src/PianoMemoryGame/PianoMemoryGame.tsx`)
- Memory game → Tone.js: creates synth and reverb (evidence: `src/PianoMemoryGame/PianoMemoryGame.tsx`)
- Piano keys and display → Key layout utilities: builds key layout (evidence: `src/PianoBase/PianoBase.tsx`)
- Piano keys and display → Highlight state: tracks highlights (evidence: `src/PianoBase/PianoBase.tsx`)
- Piano keys and display → Tone playback hook: delegates playback (evidence: `src/PianoBase/PianoBase.tsx`)
- Piano keys and display → Piano event observer: notifies events (evidence: `src/PianoBase/PianoBase.tsx`)
- Tone playback hook → Tone.js: synthesizes and schedules (evidence: `src/hooks/useToneJs/useToneJs.tsx`)
- Key layout utilities → Musical types: uses note definitions (evidence: `src/PianoBase/PianoBase.utils.ts`)
- Chord and color rules → Musical types: uses chord definitions (evidence: `src/PianoMemoryGame/MemoryBoard/MemoryBoard.utils.tsx`)
- Memory board → Musical types: uses chord data (evidence: `src/PianoMemoryGame/MemoryBoard/MemoryBoard.tsx`)
- Piano keys and display → Musical types: uses piano contracts (evidence: `src/PianoBase/PianoBase.tsx`)
- Piano event observer → Musical types: uses event types (evidence: `src/PianoObserver/PianoObserver.ts`)
- Tone playback hook → Musical types: uses playback types (evidence: `src/hooks/useToneJs/useToneJs.tsx`)
