Initial MVP: full-stack music discovery app

Backend (FastAPI):
- User auth with email/password and Spotify OAuth
- Spotify playlist import with audio feature extraction
- AI recommendation engine using Claude API with taste profiling
- Save/bookmark recommendations
- Rate limiting for free tier (10 recs/day, 1 playlist)
- PostgreSQL models with Alembic migrations
- Redis-ready configuration

Frontend (React 19 + TypeScript + Vite + Tailwind):
- Landing page, auth flows (email + Spotify OAuth)
- Dashboard with stats and quick discover
- Playlist management and import from Spotify
- Discover page with custom query support
- Recommendation cards with explanations and save toggle
- Taste profile visualization
- Responsive layout with mobile navigation
- PWA-ready configuration

Infrastructure:
- Docker Compose with PostgreSQL, Redis, backend, frontend
- Environment-based configuration

CLAUDE.md

@@ -0,0 +1,38 @@
+# 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)