# pravosleva/sounds-in-access-2025 architecture

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

- Interactive diagram: https://gitdiagram.com/pravosleva/sounds-in-access-2025
- Repository: https://github.com/pravosleva/sounds-in-access-2025

## Overview

This is a React soundboard with project-based sound collections and user-managed randomizer packs. Users enter through the home page, browse sound projects, open a project, and play sounds; they can also create and manage randomizer packs from the randomizers page. The central `vi` module owns catalog state, pack operations, and audio playback. The excerpts show routing, persistence, and randomizer interactions; the project detail implementation is sampled but its calls are not, so that connection is left unverified.

Main entry points: [`src/pages/home/HomePage.tsx`](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/home/HomePage.tsx) (Home page), [`src/pages/sounds/SoundsPages.tsx`](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/sounds/SoundsPages.tsx) (Sound catalog), [`src/pages/randomizers/RandomizersPage.tsx`](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/randomizers/RandomizersPage.tsx) (Randomizer manager), [`src/main.tsx`](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/main.tsx) (Route shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_router["Route shell<br/>[main.tsx]"]
  node_home["Home page<br/>[HomePage.tsx]"]
  node_template["Template page<br/>[TemplatePage.tsx]"]
end

subgraph group_sound_domain["Sound experience"]
  node_sounds["Sound catalog<br/>[SoundsPages.tsx]"]
  node_project["Project player<br/>[ProjectPage.tsx]"]
  node_sound_engine["Catalog and audio<br/>[vi.ts]"]
  node_browser_audio["Browser audio"]
end

subgraph group_randomizers["Randomizer packs"]
  node_randomizer_page["Randomizer manager"]
  node_pack_state["Pack operations<br/>[vi.ts]"]
  node_local_context["Persistence context"]
  node_local_storage[("Local storage")]
end

subgraph group_shared["Shared runtime"]
  node_layout["Page layout<br/>[Layout.tsx]"]
  node_item_picture["Picture card<br/>[ItemAsPicture.tsx]"]
  node_responsive["Responsive blocks"]
  node_tape["Tape display<br/>[Tape.tsx]"]
  node_button["Action buttons<br/>[Button.tsx]"]
  node_fast_context["Fast context helper"]
end

node_user(("Listener"))

node_user -->|"opens app"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_sounds
node_router -->|"routes to"| node_project
node_router -->|"routes to"| node_randomizer_page
node_router -->|"routes to"| node_template
node_home -->|"links to"| node_sounds
node_home -->|"links to"| node_randomizer_page
node_home -->|"renders"| node_tape
node_sounds -->|"reads projects"| node_sound_engine
node_sounds -->|"links to"| node_randomizer_page
node_project -.->|"uses catalog"| node_sound_engine
node_randomizer_page -->|"manages packs"| node_pack_state
node_randomizer_page -->|"controls playback"| node_sound_engine
node_pack_state -->|"shares state"| node_sound_engine
node_sound_engine -->|"plays audio"| node_browser_audio
node_local_context -->|"creates provider"| node_fast_context
node_local_context -->|"subscribes to"| node_sound_engine
node_local_context -->|"writes packs"| node_local_storage
node_home -->|"renders"| node_layout
node_home -->|"renders"| node_item_picture
node_home -->|"renders"| node_responsive
node_sounds -.->|"renders"| node_layout
node_sounds -->|"renders"| node_item_picture
node_sounds -->|"renders"| node_responsive
node_randomizer_page -->|"renders"| node_layout
node_randomizer_page -->|"renders"| node_button

click node_router "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/main.tsx"
click node_home "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/home/HomePage.tsx"
click node_sounds "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/sounds/SoundsPages.tsx"
click node_project "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/sounds/%5Bproject%5D/ProjectPage.tsx"
click node_sound_engine "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/vi/vi.ts"
click node_randomizer_page "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/randomizers/RandomizersPage.tsx"
click node_pack_state "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/vi/vi.ts"
click node_local_context "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/context/LocalStorageInspectorContext.tsx"
click node_template "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/template/TemplatePage.tsx"
click node_layout "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Layout/Layout.tsx"
click node_item_picture "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/ItemAsPicture/ItemAsPicture.tsx"
click node_responsive "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/ResponsiveBlock/ResponsiveBlock.tsx"
click node_tape "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Tape/Tape.tsx"
click node_button "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Button/Button.tsx"
click node_fast_context "https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/context/utils/createFastContext.tsx"

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_router,node_home,node_template toneBlue
class node_sounds,node_project,node_sound_engine,node_browser_audio toneAmber
class node_randomizer_page,node_pack_state,node_local_context,node_local_storage toneMint
class node_layout,node_item_picture,node_responsive,node_tape,node_button,node_fast_context toneRose
class node_user toneIndigo
```

## Components

### App navigation

- [Route shell](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/main.tsx): `src/main.tsx`
- [Home page](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/home/HomePage.tsx): `src/pages/home/HomePage.tsx`
- [Template page](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/template/TemplatePage.tsx): `src/pages/template/TemplatePage.tsx`

### Sound experience

- [Sound catalog](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/sounds/SoundsPages.tsx): `src/pages/sounds/SoundsPages.tsx`
- [Project player](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/sounds/%5Bproject%5D/ProjectPage.tsx): `src/pages/sounds/[project]/ProjectPage.tsx`
- [Catalog and audio](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/vi/vi.ts): `src/common/vi/vi.ts`
- **Browser audio**

### Randomizer packs

- [Randomizer manager](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/pages/randomizers/RandomizersPage.tsx): `src/pages/randomizers/RandomizersPage.tsx`
- [Pack operations](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/vi/vi.ts): `src/common/vi/vi.ts`
- [Persistence context](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/context/LocalStorageInspectorContext.tsx): `src/common/context/LocalStorageInspectorContext.tsx`
- **Local storage**

### Shared runtime

- [Page layout](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Layout/Layout.tsx): `src/common/components/Layout/Layout.tsx`
- [Picture card](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/ItemAsPicture/ItemAsPicture.tsx): `src/common/components/ItemAsPicture/ItemAsPicture.tsx`
- [Responsive blocks](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/ResponsiveBlock/ResponsiveBlock.tsx): `src/common/components/ResponsiveBlock/ResponsiveBlock.tsx`
- [Tape display](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Tape/Tape.tsx): `src/common/components/Tape/Tape.tsx`
- [Action buttons](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/components/Button/Button.tsx): `src/common/components/Button/Button.tsx`
- [Fast context helper](https://github.com/pravosleva/sounds-in-access-2025/blob/main/src/common/context/utils/createFastContext.tsx): `src/common/context/utils/createFastContext.tsx`

### Other components

- **Listener**

## Connections

- Listener → Route shell: opens app
- Route shell → Home page: routes to (evidence: `src/main.tsx`)
- Route shell → Sound catalog: routes to (evidence: `src/main.tsx`)
- Route shell → Project player: routes to (evidence: `src/main.tsx`)
- Route shell → Randomizer manager: routes to (evidence: `src/main.tsx`)
- Route shell → Template page: routes to (evidence: `src/main.tsx`)
- Home page → Sound catalog: links to (evidence: `src/pages/home/HomePage.tsx`)
- Home page → Randomizer manager: links to (evidence: `src/pages/home/HomePage.tsx`)
- Home page → Tape display: renders (evidence: `src/pages/home/HomePage.tsx`)
- Sound catalog → Catalog and audio: reads projects (evidence: `src/pages/sounds/SoundsPages.tsx`)
- Sound catalog → Randomizer manager: links to (evidence: `src/pages/sounds/SoundsPages.tsx`)
- Project player → Catalog and audio: uses catalog
- Randomizer manager → Pack operations: manages packs (evidence: `src/pages/randomizers/RandomizersPage.tsx`)
- Randomizer manager → Catalog and audio: controls playback (evidence: `src/pages/randomizers/RandomizersPage.tsx`)
- Pack operations → Catalog and audio: shares state (evidence: `src/common/vi/vi.ts`)
- Catalog and audio → Browser audio: plays audio (evidence: `src/common/vi/vi.ts`)
- Persistence context → Fast context helper: creates provider (evidence: `src/common/context/LocalStorageInspectorContext.tsx`)
- Persistence context → Catalog and audio: subscribes to (evidence: `src/common/context/LocalStorageInspectorContext.tsx`)
- Persistence context → Local storage: writes packs (evidence: `src/common/context/LocalStorageInspectorContext.tsx`)
- Home page → Page layout: renders (evidence: `src/pages/home/HomePage.tsx`)
- Home page → Picture card: renders (evidence: `src/pages/home/HomePage.tsx`)
- Home page → Responsive blocks: renders (evidence: `src/pages/home/HomePage.tsx`)
- Sound catalog → Page layout: renders
- Sound catalog → Picture card: renders (evidence: `src/pages/sounds/SoundsPages.tsx`)
- Sound catalog → Responsive blocks: renders (evidence: `src/pages/sounds/SoundsPages.tsx`)
- Randomizer manager → Page layout: renders (evidence: `src/pages/randomizers/RandomizersPage.tsx`)
- Randomizer manager → Action buttons: renders (evidence: `src/pages/randomizers/RandomizersPage.tsx`)
