Beatdle

Real-time multiplayer music guessing game with daily challenges

Live Demo

---

A music guessing game inspired by Wordle. Listen to audio snippets and guess the song in 5 tries. Play the daily challenge solo or compete with friends in real-time multiplayer.

Features

• Daily song challenge (new song every day)
• Custom games with filter options (genre, artist, decade)
• Real-time multiplayer lobbies with custom game settings
• Progressive audio reveals (3s → 15s)
• Hint system (reveal year, artist initial, or album name)
• User profiles and leaderboards
• Spotify API integration

Tech Stack

Frontend: React, TypeScript, Vite, Tailwind CSS

Backend: Node.js, Express, PostgreSQL, WebSocket (ws), Spotify Web API

How to Run

1. Clone the repo

git clone https://github.com/Vn0m/Beatdle.git
cd Beatdle

2. Install dependencies

cd backend && npm install
cd ../frontend && npm install

3. Set up environment variables

Create backend/.env:

DATABASE_URL=your_postgres_url
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret

Create frontend/.env:

VITE_API_URL=http://localhost:8000
VITE_WS_URL=ws://localhost:8000

4. Start the servers

In one terminal:

cd backend && npm run dev

In another terminal:

cd frontend && npm run dev

Visit http://localhost:5173