# fantiflex/ufo.recordz architecture

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

- Interactive diagram: https://gitdiagram.com/fantiflex/ufo.recordz
- Repository: https://github.com/fantiflex/ufo.recordz

## Overview

UFO.recordz is a public website for a Paris-based collective and record label. Visitors browse its collective, label, values, contact, and event pages; event listings load and classify Supabase data, while the home page also presents releases and artists who have performed. Separately, a Supabase Edge Function synchronizes SoundCloud track metadata into the releases table. The graph follows the app’s explicit route/component wiring and sampled data calls; unsampled page internals are represented at their page level, with additional capabilities linked only where the README documents the relationship.

Main entry points: [`src/App.tsx`](https://github.com/fantiflex/ufo.recordz/blob/main/src/App.tsx) (Routes and home), [`src/lib/supabase.ts`](https://github.com/fantiflex/ufo.recordz/blob/main/src/lib/supabase.ts) (Browser client), [`src/pages/EventsPage.tsx`](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/EventsPage.tsx) (Events page), [`src/components/sections/UpcomingEvents.tsx`](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/UpcomingEvents.tsx) (Upcoming events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Website shell"]
  node_app["Routes and home<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_contact_page["Contact page<br/>[ContactPage.tsx]"]
  node_contact_section["Contact details<br/>[Contact.tsx]"]
end

subgraph group_collective["Collective presentation"]
  node_collective_page["Collective page<br/>[UFORecordzPage.tsx]"]
  node_home_intro["Home introduction<br/>[Hero.tsx]"]
  node_orb["UFO illustration<br/>[UFOOrb.tsx]"]
  node_who["Who we are<br/>[WhoWeAre.tsx]"]
  node_trusted["Trusted by<br/>[TrustedBy.tsx]"]
  node_played["Featured artists<br/>[PlayedWithUs.tsx]"]
end

subgraph group_events["Event listings"]
  node_events_page["Events page<br/>[EventsPage.tsx]"]
  node_upcoming["Upcoming events<br/>[UpcomingEvents.tsx]"]
  node_past["Past events<br/>[PastEvents.tsx]"]
  node_event_card["Event card<br/>[EventCard.tsx]"]
  node_event_hook["Event state<br/>[useEvents.ts]"]
  node_event_query["Event query<br/>[supabaseEvents.ts]"]
end

subgraph group_catalog["Label and catalogue"]
  node_label_page["Label page<br/>[LabelPage.tsx]"]
  node_releases["Latest releases<br/>[Releases.tsx]"]
  node_values_page["Values page<br/>[ValeursPage.tsx]"]
  node_charter["Conduct charter<br/>[ConductCharter.tsx]"]
  node_charter_pdf["Charter PDF<br/>[charte-ufo.pdf]"]
end

subgraph group_data["Data services"]
  node_supabase_client["Browser client<br/>[supabase.ts]"]
  node_database[("Supabase database")]
  node_sync_function["SoundCloud sync<br/>[index.ts]"]
end

node_visitor(("Visitor"))
node_soundcloud["SoundCloud API"]

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_footer
node_app -->|"routes to"| node_collective_page
node_app -->|"routes to"| node_events_page
node_app -->|"routes to"| node_label_page
node_app -->|"routes to"| node_values_page
node_app -->|"routes to"| node_contact_page
node_app -->|"renders"| node_home_intro
node_app -->|"renders"| node_who
node_app -->|"renders"| node_trusted
node_app -->|"renders"| node_played
node_app -->|"renders"| node_releases
node_home_intro -->|"renders"| node_orb
node_events_page -->|"renders"| node_upcoming
node_events_page -->|"renders"| node_past
node_upcoming -->|"loads state"| node_event_hook
node_past -->|"loads state"| node_event_hook
node_upcoming -->|"renders"| node_event_card
node_past -->|"renders"| node_event_card
node_event_hook -->|"fetches events"| node_event_query
node_event_query -->|"queries through"| node_supabase_client
node_supabase_client -->|"reads"| node_database
node_played -->|"queries artists"| node_supabase_client
node_releases -->|"queries releases"| node_supabase_client
node_label_page -.->|"catalogue sourced from"| node_database
node_values_page -->|"renders"| node_charter
node_charter -.->|"offers download"| node_charter_pdf
node_contact_page -->|"renders"| node_contact_section
node_sync_function -->|"fetches tracks"| node_soundcloud
node_sync_function -->|"writes releases"| node_database

click node_app "https://github.com/fantiflex/ufo.recordz/blob/main/src/App.tsx"
click node_navbar "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/layout/Navbar.tsx"
click node_footer "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/layout/Footer.tsx"
click node_collective_page "https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/UFORecordzPage.tsx"
click node_home_intro "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Hero.tsx"
click node_orb "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/ufo/UFOOrb.tsx"
click node_who "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/WhoWeAre.tsx"
click node_trusted "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/TrustedBy.tsx"
click node_played "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/PlayedWithUs.tsx"
click node_events_page "https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/EventsPage.tsx"
click node_upcoming "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/UpcomingEvents.tsx"
click node_past "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/PastEvents.tsx"
click node_event_card "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/EventCard.tsx"
click node_event_hook "https://github.com/fantiflex/ufo.recordz/blob/main/src/hooks/useEvents.ts"
click node_event_query "https://github.com/fantiflex/ufo.recordz/blob/main/src/data/supabaseEvents.ts"
click node_label_page "https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/LabelPage.tsx"
click node_releases "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Releases.tsx"
click node_values_page "https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/ValeursPage.tsx"
click node_charter "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/ConductCharter.tsx"
click node_charter_pdf "https://github.com/fantiflex/ufo.recordz/blob/main/public/documents/charte-ufo.pdf"
click node_contact_page "https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/ContactPage.tsx"
click node_contact_section "https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Contact.tsx"
click node_supabase_client "https://github.com/fantiflex/ufo.recordz/blob/main/src/lib/supabase.ts"
click node_sync_function "https://github.com/fantiflex/ufo.recordz/blob/main/supabase/functions/sync-soundcloud/index.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_navbar,node_footer,node_contact_page,node_contact_section toneBlue
class node_collective_page,node_home_intro,node_orb,node_who,node_trusted,node_played toneAmber
class node_events_page,node_upcoming,node_past,node_event_card,node_event_hook,node_event_query,node_soundcloud toneMint
class node_label_page,node_releases,node_values_page,node_charter,node_charter_pdf toneRose
class node_supabase_client,node_database,node_sync_function,node_visitor toneIndigo
```

## Components

### Website shell

- [Routes and home](https://github.com/fantiflex/ufo.recordz/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Footer](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`
- [Contact page](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/ContactPage.tsx): `src/pages/ContactPage.tsx`
- [Contact details](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Contact.tsx): `src/components/sections/Contact.tsx`

### Collective presentation

- [Collective page](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/UFORecordzPage.tsx): `src/pages/UFORecordzPage.tsx`
- [Home introduction](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Hero.tsx): `src/components/sections/Hero.tsx`
- [UFO illustration](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/ufo/UFOOrb.tsx): `src/components/ufo/UFOOrb.tsx`
- [Who we are](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/WhoWeAre.tsx): `src/components/sections/WhoWeAre.tsx`
- [Trusted by](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/TrustedBy.tsx): `src/components/sections/TrustedBy.tsx`
- [Featured artists](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/PlayedWithUs.tsx): `src/components/sections/PlayedWithUs.tsx`

### Event listings

- [Events page](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/EventsPage.tsx): `src/pages/EventsPage.tsx`
- [Upcoming events](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/UpcomingEvents.tsx): `src/components/sections/UpcomingEvents.tsx`
- [Past events](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/PastEvents.tsx): `src/components/sections/PastEvents.tsx`
- [Event card](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/EventCard.tsx): `src/components/sections/EventCard.tsx`
- [Event state](https://github.com/fantiflex/ufo.recordz/blob/main/src/hooks/useEvents.ts): `src/hooks/useEvents.ts`
- [Event query](https://github.com/fantiflex/ufo.recordz/blob/main/src/data/supabaseEvents.ts): `src/data/supabaseEvents.ts`

### Label and catalogue

- [Label page](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/LabelPage.tsx): `src/pages/LabelPage.tsx`
- [Latest releases](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/Releases.tsx): `src/components/sections/Releases.tsx`
- [Values page](https://github.com/fantiflex/ufo.recordz/blob/main/src/pages/ValeursPage.tsx): `src/pages/ValeursPage.tsx`
- [Conduct charter](https://github.com/fantiflex/ufo.recordz/blob/main/src/components/sections/ConductCharter.tsx): `src/components/sections/ConductCharter.tsx`
- [Charter PDF](https://github.com/fantiflex/ufo.recordz/blob/main/public/documents/charte-ufo.pdf): `public/documents/charte-ufo.pdf`

### Data services

- [Browser client](https://github.com/fantiflex/ufo.recordz/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- **Supabase database**
- [SoundCloud sync](https://github.com/fantiflex/ufo.recordz/blob/main/supabase/functions/sync-soundcloud/index.ts): `supabase/functions/sync-soundcloud/index.ts`

### Other components

- **Visitor**
- **SoundCloud API**

## Connections

- Visitor → Routes and home: opens (evidence: `src/App.tsx`)
- Routes and home → Navigation: renders (evidence: `src/App.tsx`)
- Routes and home → Footer: renders (evidence: `src/App.tsx`)
- Routes and home → Collective page: routes to (evidence: `src/App.tsx`)
- Routes and home → Events page: routes to (evidence: `src/App.tsx`)
- Routes and home → Label page: routes to (evidence: `src/App.tsx`)
- Routes and home → Values page: routes to (evidence: `src/App.tsx`)
- Routes and home → Contact page: routes to (evidence: `src/App.tsx`)
- Routes and home → Home introduction: renders (evidence: `src/App.tsx`)
- Routes and home → Who we are: renders (evidence: `src/App.tsx`)
- Routes and home → Trusted by: renders (evidence: `src/App.tsx`)
- Routes and home → Featured artists: renders (evidence: `src/App.tsx`)
- Routes and home → Latest releases: renders (evidence: `src/App.tsx`)
- Home introduction → UFO illustration: renders (evidence: `src/components/sections/Hero.tsx`)
- Events page → Upcoming events: renders (evidence: `src/pages/EventsPage.tsx`)
- Events page → Past events: renders (evidence: `src/pages/EventsPage.tsx`)
- Upcoming events → Event state: loads state (evidence: `src/components/sections/UpcomingEvents.tsx`)
- Past events → Event state: loads state (evidence: `src/components/sections/PastEvents.tsx`)
- Upcoming events → Event card: renders (evidence: `src/components/sections/UpcomingEvents.tsx`)
- Past events → Event card: renders (evidence: `src/components/sections/PastEvents.tsx`)
- Event state → Event query: fetches events (evidence: `src/hooks/useEvents.ts`)
- Event query → Browser client: queries through (evidence: `src/data/supabaseEvents.ts`)
- Browser client → Supabase database: reads (evidence: `README.md`)
- Featured artists → Browser client: queries artists (evidence: `src/components/sections/PlayedWithUs.tsx`)
- Latest releases → Browser client: queries releases (evidence: `src/components/sections/Releases.tsx`)
- Label page → Supabase database: catalogue sourced from
- Values page → Conduct charter: renders (evidence: `src/pages/ValeursPage.tsx`)
- Conduct charter → Charter PDF: offers download
- Contact page → Contact details: renders (evidence: `src/pages/ContactPage.tsx`)
- SoundCloud sync → SoundCloud API: fetches tracks (evidence: `README.md`)
- SoundCloud sync → Supabase database: writes releases (evidence: `README.md`)
