MusicPliz

A React Native web music player inspired by Spotify's web UI. Powered by YouTube Music via yt-dlp + youtubei.js.

Features

• Home Feed – Browse recommended songs, albums, playlists, and artists
• Search – Find songs, albums, artists, and playlists with suggestions
• Library – Your playlists, favorites, and listening history
• Full Player – Now-playing screen with album art, controls, and progress bar
• Mini Player – Persistent Spotify-style bottom bar while browsing
• Playlist Management – Create and manage custom playlists
• Local Storage – Favorites and history saved locally
• Spotify-inspired Design – Green accent (#1DB954), dark theme, clean typography

Tech Stack

• Expo + React Native Web
• React Navigation – Bottom tabs + stack navigation
• Zustand – State management
• AsyncStorage – Local persistence
• YouTube.js – YouTube Music API
• yt-dlp – Audio URL extraction
• TypeScript – Type safety

Getting Started

1. Install dependencies

npm install
cd server && npm install && cd ..

2. Install yt-dlp (required for audio streaming)

pip install yt-dlp

3. Start the API server

cd server && node index.js

The server starts on port 3001. Initial startup takes ~15s to create a YouTube session.

4. Start the web app

npm run web

Production build

npm run build:web

Deployment

cPanel / Static Hosting

1. Copy dist/ to your server's public directory
2. Run the API server on a Node.js process (ensure yt-dlp is installed)
3. Set EXPO_PUBLIC_API_URL to your API server URL

GitHub Pages

The repo includes a GitHub Actions workflow (.github/workflows/deploy.yml) that auto-builds and deploys to GitHub Pages on push to main.

Screenshots

Home	Search	Library

Project Structure

src/
├── components/   # Reusable UI components
├── navigation/   # React Navigation setup
├── screens/      # App screens
├── services/     # API, audio player, storage
├── store/        # Zustand state stores
├── theme/        # Colors, spacing, typography
└── types/        # TypeScript type definitions
server/
└── index.js      # YouTube Music API proxy

Credits

Inspired by SimpMusic and Spotify Web.

License

MIT