# juanes395/proyecto-sinfonia architecture

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

- Interactive diagram: https://gitdiagram.com/juanes395/proyecto-sinfonia
- Repository: https://github.com/juanes395/proyecto-sinfonia

## Overview

Sintonía is a React frontend for a music-streaming platform. Users enter through the app shell, browse a public landing page or catalog, and retrieve genres, popular albums, and genre details from the configured API. The shell also loads localized text and coordinates navigation, cookie consent, and accessibility preferences. The README identifies the backend API configuration; the excerpts show frontend requests, but not the backend implementation or a playback flow, so neither is mapped here.

Main entry points: [`src/App.jsx`](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/App.jsx) (App coordinator), [`src/components/InicioPublico/InicioPublico.jsx`](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/InicioPublico/InicioPublico.jsx) (Public landing), [`src/components/Catalogo/Catalogo.jsx`](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Catalogo/Catalogo.jsx) (Music catalog), [`src/components/Icono.jsx`](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Icono.jsx) (Icon artwork)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_entry["React entry<br/>[main.jsx]"]
  node_app["App coordinator<br/>[App.jsx]"]
end

subgraph group_discovery["Music discovery"]
  node_landing["Public landing<br/>[InicioPublico.jsx]"]
  node_catalog["Music catalog<br/>[Catalogo.jsx]"]
end

subgraph group_shared["Shared interface"]
  node_nav["Navigation bar<br/>[Navbar.jsx]"]
  node_footer["Footer links<br/>[Footer.jsx]"]
  node_genre_card["Genre card<br/>[TarjetaGenero.jsx]"]
  node_track_card["Track card<br/>[TarjetaPista.jsx]"]
  node_icon["Icon artwork<br/>[Icono.jsx]"]
end

subgraph group_preferences["Preferences"]
  node_cookie_notice["Cookie notice<br/>[AvisoCookies.jsx]"]
  node_access_panel["Accessibility panel"]
  node_cookie_store["Cookie helpers<br/>[cookies.js]"]
end

subgraph group_integration["API integration"]
  node_text_hook["Localized text<br/>[useTextos.js]"]
  node_api["Music API client<br/>[api.js]"]
end

node_visitor(("Listener"))
node_backend["Sintonía API"]

node_visitor -.->|"opens"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_cookie_notice
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_catalog
node_app -->|"renders"| node_access_panel
node_app -->|"loads text"| node_text_hook
node_app -->|"reads and writes"| node_cookie_store
node_cookie_notice -->|"uses"| node_cookie_store
node_landing -->|"requests catalog data"| node_api
node_catalog -->|"requests genres"| node_api
node_catalog -->|"renders"| node_genre_card
node_catalog -->|"renders"| node_track_card
node_landing -->|"renders"| node_genre_card
node_landing -->|"renders"| node_track_card
node_landing -->|"renders"| node_icon
node_nav -->|"renders"| node_icon
node_footer -->|"renders"| node_icon
node_access_panel -->|"renders"| node_icon
node_text_hook -->|"fetches text"| node_backend
node_api -->|"fetches music data"| node_backend

click node_entry "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/main.jsx"
click node_app "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/App.jsx"
click node_nav "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Navbar/Navbar.jsx"
click node_footer "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Footer/Footer.jsx"
click node_cookie_notice "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/AvisoCookies/AvisoCookies.jsx"
click node_landing "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/InicioPublico/InicioPublico.jsx"
click node_catalog "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Catalogo/Catalogo.jsx"
click node_genre_card "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/TarjetaGenero/TarjetaGenero.jsx"
click node_track_card "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/TarjetaPista/TarjetaPista.jsx"
click node_icon "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Icono.jsx"
click node_access_panel "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/PanelAccesibilidad/PanelAccesibilidad.jsx"
click node_text_hook "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/hooks/useTextos.js"
click node_cookie_store "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/utils/cookies.js"
click node_api "https://github.com/juanes395/proyecto-sinfonia/blob/main/src/services/api.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_entry,node_app toneBlue
class node_landing,node_catalog toneAmber
class node_nav,node_footer,node_genre_card,node_track_card,node_icon,node_backend toneMint
class node_cookie_notice,node_access_panel,node_cookie_store toneRose
class node_text_hook,node_api,node_visitor toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/main.jsx): `src/main.jsx`
- [App coordinator](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/App.jsx): `src/App.jsx`

### Music discovery

- [Public landing](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/InicioPublico/InicioPublico.jsx): `src/components/InicioPublico/InicioPublico.jsx`
- [Music catalog](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Catalogo/Catalogo.jsx): `src/components/Catalogo/Catalogo.jsx`

### Shared interface

- [Navigation bar](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Navbar/Navbar.jsx): `src/components/Navbar/Navbar.jsx`
- [Footer links](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Footer/Footer.jsx): `src/components/Footer/Footer.jsx`
- [Genre card](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/TarjetaGenero/TarjetaGenero.jsx): `src/components/TarjetaGenero/TarjetaGenero.jsx`
- [Track card](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/TarjetaPista/TarjetaPista.jsx): `src/components/TarjetaPista/TarjetaPista.jsx`
- [Icon artwork](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/Icono.jsx): `src/components/Icono.jsx`

### Preferences

- [Cookie notice](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/AvisoCookies/AvisoCookies.jsx): `src/components/AvisoCookies/AvisoCookies.jsx`
- [Accessibility panel](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/components/PanelAccesibilidad/PanelAccesibilidad.jsx): `src/components/PanelAccesibilidad/PanelAccesibilidad.jsx`
- [Cookie helpers](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/utils/cookies.js): `src/utils/cookies.js`

### API integration

- [Localized text](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/hooks/useTextos.js): `src/hooks/useTextos.js`
- [Music API client](https://github.com/juanes395/proyecto-sinfonia/blob/main/src/services/api.js): `src/services/api.js`

### Other components

- **Listener**
- **Sintonía API**

## Connections

- Listener → React entry: opens
- React entry → App coordinator: renders (evidence: `src/main.jsx`)
- App coordinator → Navigation bar: renders (evidence: `src/App.jsx`)
- App coordinator → Footer links: renders (evidence: `src/App.jsx`)
- App coordinator → Cookie notice: renders (evidence: `src/App.jsx`)
- App coordinator → Public landing: renders (evidence: `src/App.jsx`)
- App coordinator → Music catalog: renders (evidence: `src/App.jsx`)
- App coordinator → Accessibility panel: renders (evidence: `src/App.jsx`)
- App coordinator → Localized text: loads text (evidence: `src/App.jsx`)
- App coordinator → Cookie helpers: reads and writes (evidence: `src/App.jsx`)
- Cookie notice → Cookie helpers: uses (evidence: `src/components/AvisoCookies/AvisoCookies.jsx`)
- Public landing → Music API client: requests catalog data (evidence: `src/components/InicioPublico/InicioPublico.jsx`)
- Music catalog → Music API client: requests genres (evidence: `src/components/Catalogo/Catalogo.jsx`)
- Music catalog → Genre card: renders (evidence: `src/components/Catalogo/Catalogo.jsx`)
- Music catalog → Track card: renders (evidence: `src/components/Catalogo/Catalogo.jsx`)
- Public landing → Genre card: renders (evidence: `src/components/InicioPublico/InicioPublico.jsx`)
- Public landing → Track card: renders (evidence: `src/components/InicioPublico/InicioPublico.jsx`)
- Public landing → Icon artwork: renders (evidence: `src/components/InicioPublico/InicioPublico.jsx`)
- Navigation bar → Icon artwork: renders (evidence: `src/components/Navbar/Navbar.jsx`)
- Footer links → Icon artwork: renders (evidence: `src/components/Footer/Footer.jsx`)
- Accessibility panel → Icon artwork: renders (evidence: `src/components/PanelAccesibilidad/PanelAccesibilidad.jsx`)
- Localized text → Sintonía API: fetches text (evidence: `src/hooks/useTextos.js`)
- Music API client → Sintonía API: fetches music data (evidence: `src/services/api.js`)
