# gsmoura033/conversor-wav-mp3-mp4 architecture

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

- Interactive diagram: https://gitdiagram.com/gsmoura033/conversor-wav-mp3-mp4
- Repository: https://github.com/gsmoura033/conversor-wav-mp3-mp4

## Overview

WAVECRAFT is a desktop-capable WAV converter with a React interface and an Express conversion API. The main workflow selects WAV files, queues them with output format, quality, and optional MP4 cover settings, then submits each conversion and offers playback, download, and history. Backend conversion uses FFmpeg and serves generated files; history is held in memory. The README also documents Electron desktop use. Its integration details are not included in the excerpts, so no Electron-to-server call is asserted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/App.jsx) (Queue and settings), [`backend/routes/convert.js`](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/routes/convert.js) (Conversion routes), [`frontend/src/utils/api.js`](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/utils/api.js) (HTTP client), [`frontend/src/components/DropZone.jsx`](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/DropZone.jsx) (WAV selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Conversion interface"]
  node_app["Queue and settings<br/>[App.jsx]"]
  node_drop["WAV selection<br/>[DropZone.jsx]"]
  node_filecard["File status card<br/>[FileCard.jsx]"]
  node_player["Audio preview<br/>[AudioPlayer.jsx]"]
  node_waveform["Waveform visual<br/>[WaveformIcon.jsx]"]
  node_toast["Notifications<br/>[Toast.jsx]"]
  node_historyui["History view"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_backend["Conversion service"]
  node_server["HTTP server<br/>[server.js]"]
  node_convert["Conversion routes<br/>[convert.js]"]
  node_history[("In-memory history<br/>[convert.js]")]
  node_outputs[("Converted files<br/>[server.js]")]
end

subgraph group_desktop["Desktop runtime"]
  node_electron["Electron shell<br/>[main.js]"]
end

node_user(("User"))
node_ffmpeg["FFmpeg"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_drop
node_drop -->|"supplies files"| node_app
node_app -->|"renders"| node_filecard
node_app -->|"requests conversion"| node_api
node_app -->|"shows notices"| node_toast
node_app -->|"shows history"| node_historyui
node_filecard -->|"renders"| node_player
node_filecard -->|"formats metadata"| node_api
node_drop -->|"renders"| node_waveform
node_player -->|"renders"| node_waveform
node_historyui -->|"loads history"| node_api
node_api -->|"sends HTTP requests"| node_server
node_server -->|"mounts routes"| node_convert
node_convert -->|"runs conversion"| node_ffmpeg
node_convert -->|"records results"| node_history
node_convert -->|"writes files"| node_outputs
node_server -->|"serves downloads"| node_outputs

click node_app "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/App.jsx"
click node_drop "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/DropZone.jsx"
click node_filecard "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/FileCard.jsx"
click node_player "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/AudioPlayer.jsx"
click node_waveform "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/WaveformIcon.jsx"
click node_toast "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/Toast.jsx"
click node_historyui "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/ConversionHistory.jsx"
click node_api "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/utils/api.js"
click node_server "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/server.js"
click node_convert "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/routes/convert.js"
click node_history "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/routes/convert.js"
click node_outputs "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/server.js"
click node_electron "https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/electron/main.js"

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_drop,node_filecard,node_player,node_waveform,node_toast,node_historyui,node_api,node_user toneBlue
class node_server,node_convert,node_history,node_outputs toneAmber
class node_electron toneMint
class node_ffmpeg toneIndigo
```

## Components

### Conversion interface

- [Queue and settings](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [WAV selection](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/DropZone.jsx): `frontend/src/components/DropZone.jsx`
- [File status card](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/FileCard.jsx): `frontend/src/components/FileCard.jsx`
- [Audio preview](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/AudioPlayer.jsx): `frontend/src/components/AudioPlayer.jsx`
- [Waveform visual](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/WaveformIcon.jsx): `frontend/src/components/WaveformIcon.jsx`
- [Notifications](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/Toast.jsx): `frontend/src/components/Toast.jsx`
- [History view](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/components/ConversionHistory.jsx): `frontend/src/components/ConversionHistory.jsx`
- [HTTP client](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### Conversion service

- [HTTP server](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/server.js): `backend/server.js`
- [Conversion routes](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/routes/convert.js): `backend/routes/convert.js`
- [In-memory history](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/routes/convert.js): `backend/routes/convert.js`
- [Converted files](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/backend/server.js): `backend/server.js`

### Desktop runtime

- [Electron shell](https://github.com/gsmoura033/conversor-wav-mp3-mp4/blob/main/electron/main.js): `electron/main.js`

### Other components

- **User**
- **FFmpeg**

## Connections

- User → Queue and settings: uses (evidence: `README.md`)
- Queue and settings → WAV selection: renders (evidence: `frontend/src/App.jsx`)
- WAV selection → Queue and settings: supplies files (evidence: `frontend/src/App.jsx`)
- Queue and settings → File status card: renders (evidence: `frontend/src/App.jsx`)
- Queue and settings → HTTP client: requests conversion (evidence: `frontend/src/App.jsx`)
- Queue and settings → Notifications: shows notices (evidence: `frontend/src/App.jsx`)
- Queue and settings → History view: shows history (evidence: `frontend/src/App.jsx`)
- File status card → Audio preview: renders (evidence: `frontend/src/components/FileCard.jsx`)
- File status card → HTTP client: formats metadata (evidence: `frontend/src/components/FileCard.jsx`)
- WAV selection → Waveform visual: renders (evidence: `frontend/src/components/DropZone.jsx`)
- Audio preview → Waveform visual: renders (evidence: `frontend/src/components/AudioPlayer.jsx`)
- History view → HTTP client: loads history (evidence: `frontend/src/components/ConversionHistory.jsx`)
- HTTP client → HTTP server: sends HTTP requests (evidence: `frontend/src/utils/api.js`)
- HTTP server → Conversion routes: mounts routes (evidence: `backend/server.js`)
- Conversion routes → FFmpeg: runs conversion (evidence: `backend/routes/convert.js`)
- Conversion routes → In-memory history: records results (evidence: `backend/routes/convert.js`)
- Conversion routes → Converted files: writes files (evidence: `backend/routes/convert.js`)
- HTTP server → Converted files: serves downloads (evidence: `backend/server.js`)
