# devsushant03/git-push-sound architecture

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

- Interactive diagram: https://gitdiagram.com/devsushant03/git-push-sound
- Repository: https://github.com/devsushant03/git-push-sound

## Overview

Git Push Sound is a small VS Code extension that detects successful `git push` commands in integrated terminals and plays a configured WAV. Users can also toggle playback or test it through contributed commands. The runtime is centered on one extension controller and one playback module, with bundled or custom audio sent to native OS utilities. The README documents the terminal event and platform capabilities; source excerpts show the dispatch and playback logic. No other runtime subsystems are evident in the supplied tree.

Main entry points: [`src/player.ts`](https://github.com/devsushant03/git-push-sound/blob/main/src/player.ts) (Sound Player), [`package.json`](https://github.com/devsushant03/git-push-sound/blob/main/package.json) (Commands & Settings), [`src/extension.ts`](https://github.com/devsushant03/git-push-sound/blob/main/src/extension.ts) (Extension Controller), [`media/Om_Phat_Swaha.wav`](https://github.com/devsushant03/git-push-sound/blob/main/media/Om_Phat_Swaha.wav) (Bundled WAV)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["VS Code Extension"]
  node_commands["Commands &amp; Settings<br/>[package.json]"]
  node_controller["Extension Controller<br/>[extension.ts]"]
end

subgraph group_audio["Sound Playback"]
  node_player["Sound Player<br/>[player.ts]"]
  node_bundled["Bundled WAV<br/>[Om_Phat_Swaha.wav]"]
end

node_user(("User"))
node_terminal["Integrated Terminal"]
node_custom["Custom WAV"]
node_os["OS Audio Utilities"]

node_user -->|"invokes"| node_commands
node_commands -->|"registers"| node_controller
node_terminal -->|"reports completion"| node_controller
node_controller -->|"plays sound"| node_player
node_player -->|"reads settings"| node_commands
node_player -->|"reads fallback"| node_bundled
node_player -->|"reads configured file"| node_custom
node_player -->|"dispatches playback"| node_os

click node_commands "https://github.com/devsushant03/git-push-sound/blob/main/package.json"
click node_controller "https://github.com/devsushant03/git-push-sound/blob/main/src/extension.ts"
click node_player "https://github.com/devsushant03/git-push-sound/blob/main/src/player.ts"
click node_bundled "https://github.com/devsushant03/git-push-sound/blob/main/media/Om_Phat_Swaha.wav"

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_commands,node_controller,node_user toneBlue
class node_player,node_bundled toneAmber
class node_terminal,node_custom,node_os toneIndigo
```

## Components

### VS Code Extension

- [Commands & Settings](https://github.com/devsushant03/git-push-sound/blob/main/package.json): `package.json`
- [Extension Controller](https://github.com/devsushant03/git-push-sound/blob/main/src/extension.ts): `src/extension.ts`

### Sound Playback

- [Sound Player](https://github.com/devsushant03/git-push-sound/blob/main/src/player.ts): `src/player.ts`
- [Bundled WAV](https://github.com/devsushant03/git-push-sound/blob/main/media/Om_Phat_Swaha.wav): `media/Om_Phat_Swaha.wav`

### Other components

- **User**
- **Integrated Terminal**
- **Custom WAV**
- **OS Audio Utilities**

## Connections

- User → Commands & Settings: invokes (evidence: `README.md`)
- Commands & Settings → Extension Controller: registers (evidence: `src/extension.ts`)
- Integrated Terminal → Extension Controller: reports completion (evidence: `README.md`)
- Extension Controller → Sound Player: plays sound (evidence: `src/extension.ts`)
- Sound Player → Commands & Settings: reads settings (evidence: `src/player.ts`)
- Sound Player → Bundled WAV: reads fallback (evidence: `src/player.ts`)
- Sound Player → Custom WAV: reads configured file (evidence: `src/player.ts`)
- Sound Player → OS Audio Utilities: dispatches playback (evidence: `src/player.ts`)
