first commit

This commit is contained in:
Tomas Dvorak
2026-04-13 17:46:58 +02:00
commit 6e8fedf534
234 changed files with 53808 additions and 0 deletions
+40
View File
@@ -0,0 +1,40 @@
# 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.
+329
View File
@@ -0,0 +1,329 @@
const API_BASE = window.location.hostname === 'localhost' ? 'http://localhost:8080' : '';
const urlInput = document.getElementById('urlInput');
const submitBtn = document.getElementById('submitBtn');
const loading = document.getElementById('loading');
const error = document.getElementById('error');
const seedTrack = document.getElementById('seedTrack');
const recommendations = document.getElementById('recommendations');
const emptyState = document.getElementById('emptyState');
const seedArtwork = document.getElementById('seedArtwork');
const seedTitle = document.getElementById('seedTitle');
const seedArtist = document.getElementById('seedArtist');
const recList = document.getElementById('recList');
const STREAMING_SERVICES = [
{ id: 'spotify', name: 'Spotify', color: '#1DB954' },
{ id: 'apple', name: 'Apple', color: '#FA2D48' },
{ id: 'youtube', name: 'YouTube', color: '#FF0000' },
{ id: 'tidal', name: 'Tidal', color: '#00D4FF' },
{ id: 'deezer', name: 'Deezer', color: '#FF0092' },
{ id: 'soundcloud', name: 'SoundCloud', color: '#FF5500' },
];
function showError(msg) {
error.textContent = msg;
error.classList.add('visible');
}
function hideError() {
error.classList.remove('visible');
}
function setLoading(isLoading) {
loading.classList.toggle('visible', isLoading);
submitBtn.disabled = isLoading;
}
function parseUrl(url) {
const trimmed = url.trim();
if (!trimmed) return null;
const uriMatch = trimmed.match(/^spotify:(track|album|playlist|artist):([a-zA-Z0-9]+)$/i);
if (uriMatch) {
return { type: 'spotify', itemType: uriMatch[1].toLowerCase(), id: uriMatch[2], url: trimmed };
}
let parsed;
try {
parsed = new URL(trimmed.includes('://') ? trimmed : `https://${trimmed}`);
} catch {
return null;
}
const host = parsed.hostname.toLowerCase().replace(/^www\./, '');
const parts = parsed.pathname.split('/').filter(Boolean);
if (parts[0]?.startsWith('intl-')) parts.shift();
if (parts[0] === 'embed') parts.shift();
if ((host === 'open.spotify.com' || host === 'play.spotify.com') && parts.length >= 2) {
const itemType = parts[0].toLowerCase();
if (['track', 'album', 'playlist', 'artist'].includes(itemType)) {
return { type: 'spotify', itemType, id: parts[1], url: trimmed };
}
}
if (host === 'music.apple.com' && parts.length >= 3) {
const itemType = parts.includes('playlist') ? 'playlist' : parsed.searchParams.has('i') ? 'song' : parts[2];
const id = parsed.searchParams.get('i') || parts.at(-1);
return { type: 'apple', itemType, id, url: trimmed };
}
if (host === 'music.youtube.com' || host === 'youtube.com' || host === 'm.youtube.com' || host === 'youtu.be') {
const id = parsed.searchParams.get('v') || parsed.searchParams.get('list') || parts[0];
const itemType = parsed.searchParams.has('list') && !parsed.searchParams.has('v') ? 'playlist' : 'video';
if (id) return { type: host === 'music.youtube.com' ? 'youtube_music' : 'youtube', itemType, id, url: trimmed };
}
if (host === 'tidal.com' || host === 'listen.tidal.com') {
const itemIndex = parts.findIndex(part => ['track', 'album', 'playlist', 'artist'].includes(part));
if (itemIndex >= 0 && parts[itemIndex + 1]) {
return { type: 'tidal', itemType: parts[itemIndex], id: parts[itemIndex + 1], url: trimmed };
}
}
if (host.endsWith('deezer.com')) {
const itemIndex = parts.findIndex(part => ['track', 'album', 'playlist', 'artist'].includes(part));
if (itemIndex >= 0 && parts[itemIndex + 1]) {
return { type: 'deezer', itemType: parts[itemIndex], id: parts[itemIndex + 1], url: trimmed };
}
}
if (host === 'soundcloud.com' && parts.length >= 2) {
const itemType = parts[1] === 'sets' ? 'playlist' : 'track';
const id = itemType === 'playlist' ? `${parts[0]}/sets/${parts[2] || ''}` : `${parts[0]}/${parts[1]}`;
return { type: 'soundcloud', itemType, id, url: trimmed };
}
if (host.endsWith('bandcamp.com') && parts.length >= 2 && ['track', 'album'].includes(parts[0])) {
return { type: 'bandcamp', itemType: parts[0], id: `${host.split('.')[0]}/${parts.slice(1).join('/')}`, url: trimmed };
}
return null;
}
async function importTrack(parsed) {
// The backend imports Spotify directly and resolves other supported song URLs through Song.link.
const resp = await fetch(`${API_BASE}/v1/providers/spotify/import`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
source: { type: 'url', value: parsed.url },
market: 'US',
enrich_musicbrainz: true,
persist: true
})
});
if (!resp.ok) {
const err = await resp.json().catch(() => ({}));
throw new Error(err.detail || 'Failed to import track');
}
return await resp.json();
}
async function getRecommendations(seedTrackId, limit = 10) {
const resp = await fetch(`${API_BASE}/v1/recommendations`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
user_id: 'anonymous-user',
seed_track_ids: [seedTrackId],
limit: limit,
mode: 'balanced'
})
});
if (!resp.ok) {
const err = await resp.json().catch(() => ({}));
throw new Error(err.detail || 'Failed to get recommendations');
}
const data = await resp.json();
return data.data;
}
async function getSonglinkUrls(title, artist) {
try {
const resp = await fetch(`https://api.song.link/v1-alpha.1/links?userCountry=US&songTitle=${encodeURIComponent(title)}&artistName=${encodeURIComponent(artist)}`);
if (!resp.ok) return {};
const data = await resp.json();
return data.linksByPlatform || {};
} catch {
return {};
}
}
function displaySeedTrack(track) {
seedTitle.textContent = track.title;
seedArtist.textContent = track.artist;
if (track.external?.spotify) {
const img = document.createElement('img');
img.src = `https://open.spotify.com/oembed?url=${encodeURIComponent(track.external.spotify)}`;
// Note: In production, use proper album art from the API
seedArtwork.innerHTML = '♪';
}
seedTrack.classList.add('visible');
}
function createServiceLinks(songlinkData, track) {
const links = [];
const serviceMap = {
spotify: 'Spotify',
appleMusic: 'Apple',
youtubeMusic: 'YouTube',
youtube: 'YouTube',
tidal: 'Tidal',
deezer: 'Deezer',
soundcloud: 'SoundCloud'
};
for (const [platform, label] of Object.entries(serviceMap)) {
const data = songlinkData[platform];
if (data?.url) {
const svc = STREAMING_SERVICES.find(s =>
s.id === platform.toLowerCase().replace('music', '') ||
s.name === label
) || { name: label, color: '#666' };
links.push({
name: svc.name,
url: data.url,
color: svc.color
});
}
}
// Fallback: always include search links
const query = encodeURIComponent(`${track.title} ${track.artist}`);
const fallbacks = [
{ name: 'Spotify', url: `https://open.spotify.com/search/${query}` },
{ name: 'YouTube', url: `https://music.youtube.com/search?q=${query}` },
{ name: 'Apple', url: `https://music.apple.com/us/search?term=${query}` },
{ name: 'Tidal', url: `https://tidal.com/search?q=${query}` },
];
// Add any missing services
for (const fb of fallbacks) {
if (!links.find(l => l.name === fb.name)) {
const svc = STREAMING_SERVICES.find(s => s.name === fb.name);
links.push({ ...fb, color: svc?.color || '#666' });
}
}
return links.slice(0, 6);
}
function displayRecommendations(recs) {
recList.innerHTML = '';
recs.forEach((rec, i) => {
const item = document.createElement('div');
item.className = 'rec-item';
const rank = document.createElement('div');
rank.className = 'rec-rank';
rank.textContent = rec.rank || i + 1;
const info = document.createElement('div');
info.className = 'rec-info';
const title = document.createElement('div');
title.className = 'rec-title';
title.textContent = rec.track.title;
const artist = document.createElement('div');
artist.className = 'rec-artist';
artist.textContent = rec.track.artist;
const reason = document.createElement('div');
reason.className = 'rec-reason';
reason.textContent = rec.reason || '';
info.appendChild(title);
info.appendChild(artist);
if (rec.reason) info.appendChild(reason);
const links = document.createElement('div');
links.className = 'rec-links';
// Generate links for this track
const serviceLinks = createServiceLinks({}, rec.track);
serviceLinks.forEach(svc => {
const a = document.createElement('a');
a.className = 'service-link';
a.href = svc.url;
a.target = '_blank';
a.rel = 'noopener';
a.title = `Open in ${svc.name}`;
a.textContent = svc.name.charAt(0);
a.style.borderColor = svc.color + '40';
a.style.color = svc.color;
links.appendChild(a);
});
item.appendChild(rank);
item.appendChild(info);
item.appendChild(links);
recList.appendChild(item);
});
recommendations.classList.add('visible');
}
async function handleSubmit() {
const url = urlInput.value.trim();
if (!url) {
showError('Please enter a song URL');
return;
}
const parsed = parseUrl(url);
if (!parsed) {
showError('Unsupported URL format. Try a Spotify, Apple Music, or YouTube Music link.');
return;
}
hideError();
setLoading(true);
emptyState.style.display = 'none';
seedTrack.classList.remove('visible');
recommendations.classList.remove('visible');
try {
// Import the track
const imported = await importTrack(parsed);
if (!imported.track) {
throw new Error('Could not extract track information');
}
displaySeedTrack(imported.track);
// Get recommendations
const recs = await getRecommendations(imported.track.id, 10);
displayRecommendations(recs);
} catch (err) {
showError(err.message || 'Something went wrong. Please try again.');
console.error(err);
} finally {
setLoading(false);
}
}
submitBtn.addEventListener('click', handleSubmit);
urlInput.addEventListener('keydown', (e) => {
if (e.key === 'Enter') {
handleSubmit();
}
});
// Focus input on load
urlInput.focus();
+457
View File
@@ -0,0 +1,457 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Flow — Music Discovery</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600&display=swap" rel="stylesheet">
<style>
:root {
--bg-primary: #000000;
--bg-secondary: #0a0a0a;
--bg-tertiary: #121212;
--bg-input: #181818;
--text-primary: #ffffff;
--text-secondary: #a0a0a0;
--text-muted: #6a6a6a;
--accent: #00d4ff;
--accent-dim: rgba(0, 212, 255, 0.1);
--border: #2a2a2a;
--radius: 12px;
--radius-sm: 6px;
--space-xs: 0.5rem;
--space-sm: 0.75rem;
--space-md: 1.25rem;
--space-lg: 2rem;
--space-xl: 3rem;
--space-2xl: 5rem;
}
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
background: var(--bg-primary);
color: var(--text-primary);
line-height: 1.6;
min-height: 100vh;
-webkit-font-smoothing: antialiased;
}
.container {
max-width: 720px;
margin: 0 auto;
padding: var(--space-xl) var(--space-lg);
}
/* Header */
.header {
text-align: center;
margin-bottom: var(--space-2xl);
}
.logo {
font-size: 1.5rem;
font-weight: 600;
letter-spacing: -0.02em;
margin-bottom: var(--space-sm);
}
.logo span {
color: var(--accent);
}
.tagline {
color: var(--text-secondary);
font-size: 1rem;
font-weight: 300;
letter-spacing: 0.02em;
}
/* Input Section */
.input-section {
background: var(--bg-secondary);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: var(--space-xl);
margin-bottom: var(--space-xl);
}
.input-label {
display: block;
font-size: 0.75rem;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.1em;
color: var(--text-muted);
margin-bottom: var(--space-sm);
}
.url-input-wrapper {
display: flex;
gap: var(--space-sm);
}
.url-input {
flex: 1;
background: var(--bg-input);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
padding: var(--space-md);
color: var(--text-primary);
font-size: 1rem;
font-family: inherit;
outline: none;
transition: border-color 0.2s, box-shadow 0.2s;
}
.url-input::placeholder {
color: var(--text-muted);
}
.url-input:focus {
border-color: var(--accent);
box-shadow: 0 0 0 3px var(--accent-dim);
}
.submit-btn {
background: var(--accent);
color: var(--bg-primary);
border: none;
border-radius: var(--radius-sm);
padding: var(--space-md) var(--space-lg);
font-size: 0.9rem;
font-weight: 600;
cursor: pointer;
transition: opacity 0.2s, transform 0.1s;
white-space: nowrap;
}
.submit-btn:hover {
opacity: 0.9;
}
.submit-btn:active {
transform: scale(0.98);
}
.submit-btn:disabled {
opacity: 0.5;
cursor: not-allowed;
}
/* Seed Track */
.seed-track {
background: var(--bg-tertiary);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: var(--space-lg);
margin-bottom: var(--space-xl);
display: none;
}
.seed-track.visible {
display: block;
}
.seed-header {
font-size: 0.75rem;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.1em;
color: var(--accent);
margin-bottom: var(--space-md);
}
.track-info {
display: flex;
align-items: center;
gap: var(--space-md);
}
.track-artwork {
width: 64px;
height: 64px;
background: var(--bg-input);
border-radius: var(--radius-sm);
display: flex;
align-items: center;
justify-content: center;
color: var(--text-muted);
font-size: 1.5rem;
flex-shrink: 0;
}
.track-artwork img {
width: 100%;
height: 100%;
object-fit: cover;
border-radius: var(--radius-sm);
}
.track-meta h3 {
font-size: 1.1rem;
font-weight: 500;
margin-bottom: 0.25rem;
}
.track-meta p {
color: var(--text-secondary);
font-size: 0.9rem;
}
/* Recommendations */
.recommendations {
display: none;
}
.recommendations.visible {
display: block;
}
.section-title {
font-size: 0.75rem;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.1em;
color: var(--text-muted);
margin-bottom: var(--space-md);
}
.rec-list {
display: flex;
flex-direction: column;
gap: var(--space-sm);
}
.rec-item {
background: var(--bg-secondary);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: var(--space-md);
display: flex;
align-items: center;
gap: var(--space-md);
transition: border-color 0.2s, background 0.2s;
}
.rec-item:hover {
border-color: var(--accent);
background: var(--bg-tertiary);
}
.rec-rank {
width: 28px;
height: 28px;
display: flex;
align-items: center;
justify-content: center;
font-size: 0.75rem;
font-weight: 600;
color: var(--accent);
background: var(--accent-dim);
border-radius: 50%;
flex-shrink: 0;
}
.rec-info {
flex: 1;
min-width: 0;
}
.rec-title {
font-weight: 500;
margin-bottom: 0.15rem;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.rec-artist {
color: var(--text-secondary);
font-size: 0.85rem;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.rec-reason {
font-size: 0.75rem;
color: var(--text-muted);
margin-top: 0.25rem;
}
.rec-links {
display: flex;
gap: var(--space-xs);
flex-shrink: 0;
}
.service-link {
width: 32px;
height: 32px;
display: flex;
align-items: center;
justify-content: center;
background: var(--bg-input);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
color: var(--text-secondary);
text-decoration: none;
font-size: 0.75rem;
transition: all 0.2s;
}
.service-link:hover {
background: var(--accent-dim);
border-color: var(--accent);
color: var(--accent);
}
/* Loading */
.loading {
text-align: center;
padding: var(--space-2xl);
color: var(--text-secondary);
display: none;
}
.loading.visible {
display: block;
}
.spinner {
width: 40px;
height: 40px;
border: 2px solid var(--border);
border-top-color: var(--accent);
border-radius: 50%;
animation: spin 0.8s linear infinite;
margin: 0 auto var(--space-md);
}
@keyframes spin {
to { transform: rotate(360deg); }
}
/* Error */
.error {
background: rgba(255, 50, 50, 0.1);
border: 1px solid rgba(255, 50, 50, 0.3);
border-radius: var(--radius-sm);
padding: var(--space-md);
color: #ff6666;
margin-top: var(--space-md);
display: none;
}
.error.visible {
display: block;
}
/* Empty State */
.empty-state {
text-align: center;
padding: var(--space-2xl) var(--space-lg);
color: var(--text-muted);
}
.empty-state p {
font-size: 0.9rem;
}
/* Footer */
.footer {
text-align: center;
padding-top: var(--space-2xl);
color: var(--text-muted);
font-size: 0.8rem;
}
.footer a {
color: var(--accent);
text-decoration: none;
}
/* Responsive */
@media (max-width: 600px) {
.container {
padding: var(--space-lg) var(--space-md);
}
.url-input-wrapper {
flex-direction: column;
}
.rec-links {
flex-wrap: wrap;
max-width: 100px;
}
.track-info {
flex-wrap: wrap;
}
}
</style>
</head>
<body>
<div class="container">
<header class="header">
<div class="logo">Flow<span>.</span></div>
<p class="tagline">Paste a song link. Discover more.</p>
</header>
<section class="input-section">
<label class="input-label">Song Link</label>
<div class="url-input-wrapper">
<input
type="text"
class="url-input"
id="urlInput"
placeholder="https://open.spotify.com/track/..."
autocomplete="off"
>
<button class="submit-btn" id="submitBtn">Discover</button>
</div>
<div class="error" id="error"></div>
</section>
<div class="loading" id="loading">
<div class="spinner"></div>
<p>Finding similar music...</p>
</div>
<div class="seed-track" id="seedTrack">
<div class="seed-header">Starting From</div>
<div class="track-info">
<div class="track-artwork" id="seedArtwork"></div>
<div class="track-meta">
<h3 id="seedTitle"></h3>
<p id="seedArtist"></p>
</div>
</div>
</div>
<div class="recommendations" id="recommendations">
<div class="section-title">Recommendations</div>
<div class="rec-list" id="recList"></div>
</div>
<div class="empty-state" id="emptyState">
<p>Supports Spotify, Apple Music, YouTube Music, Tidal, Deezer, SoundCloud</p>
</div>
<footer class="footer">
<p>Powered by <a href="https://developer.spotify.com/documentation/web-api" target="_blank">Spotify API</a> & <a href="https://song.link" target="_blank">Songlink</a></p>
</footer>
</div>
<script src="app.js"></script>
</body>
</html>
+9
View File
@@ -0,0 +1,9 @@
{
"name": "flow-web",
"version": "1.0.0",
"description": "Minimal music discovery UI",
"scripts": {
"start": "npx serve . -p 3000 -s",
"dev": "npx serve . -p 3000 -s"
}
}