43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# 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)
|