# 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

## Git
- Repo: To be created on Gitea (chrisryn/vynl)
- Branches: master + dev (standard workflow)