vynl/CLAUDE.md

Vynl - AI Music Discovery App

Project Status: Ready to build MVP

Design Doc

See DESIGN.md for full product spec.

Quick Summary

• Import playlists from Spotify/Apple Music/YouTube Music/Tidal
• AI finds new music you'll love and explains why
• Free tier (10 recs/day, 1 playlist) + Pro ($4.99/month, unlimited)
• Cross-platform import/export

Tech Stack

• Backend: Python 3.12+ / FastAPI / PostgreSQL / Redis / Celery
• Frontend: React 19 + TypeScript + Vite + Tailwind CSS
• AI: Claude API for recommendations + Spotify audio features + MusicBrainz + Last.fm
• Auth: Email + OAuth (Spotify, Apple, Google)
• Payments: Stripe
• Mobile: PWA (progressive web app)

MVP Scope (v1.0)

1. User auth (email + Spotify OAuth)
2. Spotify playlist import
3. Manual song/artist search
4. AI recommendations via Claude API
5. "Why you'll like this" explanations
6. Taste profile display
7. Save/bookmark recommendations
8. Responsive web app (PWA)

Brand

• Colors: Deep purple (#7C3AED) + warm cream (#FFF7ED) + charcoal (#1C1917)
• Vibe: Warm analog nostalgia meets modern AI

Domain

• deepcutsai.com (hosted on Hostinger)
• App name remains Vynl

Git

• Repo: Gitea (chrisryn/vynl)
• Branches: master + dev (standard workflow)