Raaga Music Player

A modern music streaming web application built with React and TypeScript.

Technologies Used

• React
• Tailwind CSS
• shadcn/ui
• TanStack Query

Local Setup

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

# Clone the repository
git clone <repository-url>

# Navigate to project directory
cd harmony-stream

# Install dependencies
npm install

# Start development server
npm run dev

The application will be available at http://localhost:5173

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

Important Notes

API Limitations

This application uses the iTunes Search API for music data, which has the following limitations:

• 30-second preview only - All audio tracks are limited to 30-second previews due to iTunes API restrictions
• Free tier limitations - The iTunes API is free but provides only preview clips, not full-length songs
• No authentication required for the iTunes API

Features

• Browse and search music catalog
• Create and manage playlists
• Like/favorite songs
• Music player with playback controls
• User authentication (mock implementation)
• Responsive design for mobile and desktop

Development

The project uses mock data for development purposes. Real API integration with iTunes Search API can be implemented for production use.