mirror of
https://github.com/Dvorinka/SpotifyRecAlg.git
synced 2026-06-04 04:23:02 +00:00
Tomas Dvorak
41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# Flow Web UI
|
|
|
|
A minimal, Tidal-inspired music discovery interface. Paste a song link, get recommendations with links to all streaming services.
|
|
|
|
## Design
|
|
|
|
- **Colors**: Black background (#000), cyan accent (#00d4ff), subtle grays
|
|
- **Typography**: Inter, lightweight with careful tracking
|
|
- **Spacing**: Generous whitespace, breathable layout
|
|
- **Style**: No cards, minimal borders, focused on content
|
|
|
|
## Run
|
|
|
|
```bash
|
|
# Terminal 1: Start the backend
|
|
cd ../backend
|
|
STORE_DRIVER=memory SEED_DEMO_DATA=true go run ./cmd/api
|
|
|
|
# Terminal 2: Serve the frontend (any static server)
|
|
cd apps/web
|
|
npx serve . -p 3000
|
|
# or
|
|
python3 -m http.server 3000
|
|
```
|
|
|
|
Open http://localhost:3000
|
|
|
|
## Features
|
|
|
|
- Paste any Spotify, Apple Music, YouTube Music, Tidal, Deezer, or SoundCloud link
|
|
- Backend imports track and extracts audio features
|
|
- Recommendation engine uses cosine similarity + collaborative filtering
|
|
- Results link to all major streaming services via Songlink
|
|
|
|
## Architecture
|
|
|
|
- `index.html` — Structure and Tidal-inspired styling
|
|
- `app.js` — URL parsing, API calls, recommendation display
|
|
|
|
The backend handles all the heavy lifting: track import, feature extraction, and the recommendation algorithm.
|