Welcome to Beat App
Beat App is a modern, responsive web-based music player that delivers a premium streaming experience. Built with React 18 and Vite, it allows users to search for tracks, artists, and albums, manage playback queues, and stream audio seamlessly with native-feeling controls.Quick Start
Get up and running with Beat App in under 5 minutes
Installation
Detailed installation instructions for all package managers
API Reference
Explore the API services and store architecture
Deployment
Deploy Beat App with Docker and NGINX
Key Features
Music Playback & Streaming
Stream audio tracks fetched via a custom API with seamless playback controls
Advanced Search
Dedicated search interfaces for tracks, albums, artists, and playlists
Queue Management
Add songs to queue, play next, play previous, and manage persistent queue drawer
Media Session API
Control playback from your OS or browser’s built-in media controls
Premium UI Design
Beautiful, responsive interface built with Material-UI and Emotion
Dark Mode Support
Full light/dark theme support with custom color schemes
Technology Stack
Beat App is built with modern web technologies for optimal performance and developer experience:- Frontend Framework: React 18 with Vite for lightning-fast development
- Routing: React Router DOM for seamless navigation
- UI Library: Material-UI (MUI) with custom theming and Emotion for styling
- State Management: Nanostores for efficient, reactive state management
- API Integration: Axios and Fetch API for YouTube music streaming
- Deployment: Docker, Docker Compose, and NGINX for production
Beat App integrates with a YouTube Music API backend to provide access to millions of tracks, albums, and artists.
Architecture Overview
The application follows a modular architecture:What Makes Beat App Special
Native Media Controls
Integrates with the browser’s Media Session API, allowing users to control playback from OS-level media controls, keyboard shortcuts, and lock screens.
Reactive State Management
Uses Nanostores for lightweight, atomic state management that keeps the UI in sync with player state across all components.
Premium Design System
Custom Material-UI theme with gradient effects, rounded corners, and a carefully crafted dark mode for a premium music streaming experience.
Quick Example
Here’s how the player store manages audio playback:The player store automatically handles Media Session metadata, audio element events, and queue management.
Next Steps
Get Started
Follow our quickstart guide to start streaming music in minutes
Learn the Architecture
Understand how Beat App’s components and stores work together