B-Side

B-Side ist eine deutschsprachige Musik-Community-App im Vite-Frontend, die es erlaubt, Songs zu suchen, zu bewerten und als Kurzrezension zu speichern. Das Projekt kombiniert lokale Persistenz mit einem Supabase-Backend für Community-Reviews und nutzt optional die Last.fm-API für Live-Suche.

Features

• Song-Suche mit Fallback-Mock-Daten, falls kein Last.fm-API-Key verfügbar ist
• Bewertung auf einer 5-Sterne-Skala inklusive halber Sterne
• Nutzerrezensionen und Feed mit Community-Aktivität
• Heavy Rotation: 4 Slot-Profile für persönliche Lieblingssongs
• Profilseite mit Review-Anzahl und Durchschnittsbewertung
• Persistenz über localStorage für Nutzername, API-Key und Rotation

Technologie

• Vite
• Vanilla JavaScript (ES Modules)
• Tailwind CSS
• Supabase für Review-Daten
• Last.fm API (optional)

Installation

1. Projektabhängigkeiten installieren:

npm install

2. Entwicklung starten:

npm run dev

3. Produktion bauen:

npm run build

Konfiguration

Last.fm API

Die App nutzt optional die Last.fm-API für Live-Song-Suche. Wenn kein eigener API-Key hinterlegt ist, verwendet die App eine Mock-Suchdatenbank für ein Demo-Erlebnis.

• API-Key in den Einstellungen der App eingeben
• Wird kein Key hinterlegt, bleibt der Demo-Modus aktiv

Supabase

Das Projekt verwendet bereits eine voreingestellte Supabase-Clientverbindung in src/supabase.js. Die Review-Daten werden aus der Tabelle reviews geladen.

Projektstruktur

• index.html – Hauptseite der App
• src/main.js – App-Logik, Rendering und DOM-Interaktionen
• src/api.js – Song-Suche und Last.fm-Abfragen / Mock-Fallback
• src/supabase.js – Supabase-Clientkonfiguration
• src/style.css – globale Styles und Tailwind-Konfiguration
• package.json – Projekt- und Build-Skripte

Hinweise

• Die App ist bewusst als statisches Frontend mit lokalem Zustand und Supabase-Integration aufgebaut.
• Für echtes Produktions-Deployment sollte der Supabase-Key sicherer verwaltet werden, z. B. über Umgebungsvariablen oder ein serverseitiges Backend.

Kontakt

Dieses Projekt wurde als Demo-Anwendung für eine analoge Musik-Community entwickelt. Anpassungen für Styles, Funktionserweiterungen oder Backend-Sicherheit sind jederzeit möglich.