SoundWave adalah platform streaming musik modern yang memadukan keunggulan Spotify dan YouTube Music, dibungkus dengan desain dark premium yang elegan. Kamu bisa mencari lagu, memutar lewat player yang lengkap, membaca lirik, membuat playlist, dan menyimpan lagu favorit ke akunmu.
📋 Daftar Isi
| Fitur | Keterangan | |
|---|---|---|
| 🔍 | Pencarian | Cari lagu, artis, dan album langsung dari halaman Search |
| 🎵 | Player lengkap | Play/pause, seek, volume, mute, shuffle, repeat, dan antrean (queue) |
| ♾️ | Autoplay | Lanjut memutar lagu berikutnya otomatis |
| 📝 | Lirik | Halaman lirik khusus untuk lagu yang sedang diputar |
| 📂 | Playlist | Buat playlist sendiri dan tambahkan lagu ke playlist mana pun |
| ❤️ | Liked Songs | Simpan lagu favorit ke akun |
| 🕘 | Riwayat putar | Catatan lagu yang pernah kamu dengar |
| 👤 | Akun | Daftar dan login dengan email/password atau Google |
| ⚙️ | Pengaturan | Kualitas putar & unduh, autoplay, tema, dan bahasa (English / Bahasa Indonesia) |
| 📱 | Responsif | Sidebar di desktop, navigasi bawah dan drawer di HP |
| ⚡ | Cepat | Cache respons API di sisi server dan klien |
Note
Data akun, playlist, dan lagu favorit disimpan di Firebase (Authentication + Firestore), jadi tersinkron di semua perangkat.
📚 Library utama
| Kategori | Yang dipakai |
|---|---|
| UI | React 19, Tailwind CSS 4, Motion, Lucide React |
| Build | Vite, TypeScript, tsx |
| Server | Express (proxy API + static serving) |
| Backend as a Service | Firebase Auth & Firestore |
| Font | Plus Jakarta Sans |
Prasyarat: Node.js 18+ (atau Bun)
🐧 Linux / macOS
git clone https://github.com/ItsMeMal/SoundWave.git
cd SoundWave
npm install
cp .env.example .env
npm run dev🪟 Windows (PowerShell)
git clone https://github.com/ItsMeMal/SoundWave.git
cd SoundWave
npm install
Copy-Item .env.example .env
npm run dev📱 Termux (Android)
pkg update && pkg upgrade -y
pkg install git nodejs -y
git clone https://github.com/ItsMeMal/SoundWave.git
cd SoundWave
npm install
cp .env.example .env
npm run dev🥟 Bun
bun install
bun run devSetelah berjalan, buka http://localhost:3000.
Tip
Setiap blok kode di GitHub punya tombol Copy di pojok kanan atas.
Salin .env.example menjadi .env, lalu sesuaikan:
| Variabel | Wajib | Default | Keterangan |
|---|---|---|---|
GEMINI_API_KEY |
❌ | – | Kunci Gemini API (disiapkan di template, opsional) |
APP_URL |
❌ | – | URL tempat aplikasi di-host |
PORT |
❌ | 3000 |
Port server |
NODE_ENV |
❌ | – | Isi production agar server menyajikan folder dist |
DISABLE_HMR |
❌ | – | Isi true untuk mematikan hot reload |
🔥 Pakai Firebase project sendiri
- Buat project di Firebase Console, aktifkan Authentication (Email/Password dan Google) dan Firestore.
- Ganti isi
firebase-applet-config.jsondengan konfigurasi web app Firebase kamu. - Terapkan aturan keamanan dari file
firestore.rules.
Skema data (UserProfile, Playlist, LikedTrack, PlaybackHistory) ada di firebase-blueprint.json.
Warning
Jangan commit file .env ke repository publik.
| Perintah | Fungsi |
|---|---|
npm run dev |
Jalankan server development (Express + Vite) |
npm run build |
Build frontend ke folder dist |
npm start |
Jalankan server (set NODE_ENV=production untuk mode produksi) |
npm run preview |
Preview hasil build dengan Vite |
npm run lint |
Cek tipe TypeScript (tsc --noEmit) |
npm run clean |
Hapus dist dan server.js |
Mode produksi:
npm run build
NODE_ENV=production npm startflowchart LR
U[👤 Pengguna] --> FE[React + Vite<br/>Frontend]
FE -->|/api/music/*| PX[Express Proxy<br/>cache 10 menit]
PX --> API[(Music API)]
FE -->|Auth & data| FB[(Firebase<br/>Auth + Firestore)]
FE --> PL[Player Context<br/>queue • shuffle • repeat]
sequenceDiagram
participant U as Pengguna
participant FE as Frontend
participant S as Express Server
participant M as Music API
U->>FE: Cari lagu
FE->>FE: Cek cache klien (5 menit)
FE->>S: GET /api/music/...
S->>S: Cek cache server
S->>M: Teruskan permintaan
M-->>S: Hasil pencarian
S-->>FE: JSON
FE-->>U: Daftar lagu
Server Express meneruskan semua permintaan /api/music/* ke Music API eksternal, dilengkapi cache dan timeout. Endpoint /api/health tersedia untuk cek status server.
SoundWave/
├── src/
│ ├── components/
│ │ ├── layout/ # Sidebar, Navbar, BottomPlayerBar, RightPlayerPanel, MobileNav
│ │ └── modals/ # AuthModal, CreatePlaylistModal, AddToPlaylistModal
│ ├── context/ # AuthContext, PlayerContext
│ ├── services/ # firebase.ts, musicApi.ts
│ ├── types/ # Tipe data (Track, Playlist, UserSettings, ...)
│ ├── utils/ # formatters, playerLogic (+ test)
│ ├── views/ # Home, Search, Library, LikedSongs, Artist, Playlist, Lyrics, Settings
│ ├── App.tsx
│ ├── main.tsx
│ └── index.css
├── server.ts # Express: proxy API + serve frontend
├── vite.config.ts
├── vercel.json # Rewrites untuk deploy di Vercel
├── firestore.rules
├── firebase-blueprint.json
├── .env.example
└── package.json
Project ini sudah menyertakan vercel.json berisi rewrite untuk route /api/music/* dan fallback SPA, jadi bisa langsung di-deploy ke Vercel:
- Import repository di Vercel.
- Framework preset: Vite.
- Deploy.
Untuk VPS, jalankan npm run build lalu NODE_ENV=production npm start (disarankan memakai PM2 atau reverse proxy).
Apakah saya perlu akun untuk memutar lagu?
Akun dipakai untuk menyimpan playlist, lagu favorit, dan riwayat. Daftar atau login lewat email/password atau Google.
Lagu tidak muncul atau gagal diputar?
Musik diambil dari Music API eksternal lewat proxy server. Pastikan server berjalan dan koneksi internet stabil, lalu coba lagi beberapa saat.
Bagaimana melaporkan bug?
Buka Issues dan sertakan langkah untuk mereproduksi masalahnya beserta screenshot jika ada.
Kontribusi sangat diterima!
- Fork repository ini
- Buat branch:
git checkout -b fitur/nama-fitur - Commit:
git commit -m "feat: tambah fitur" - Push:
git push origin fitur/nama-fitur - Buka Pull Request
Kode sumber memakai header lisensi Apache-2.0. Tambahkan file LICENSE di root repository agar GitHub bisa menampilkannya.
