🎵 Maxify - Personal Music Streaming Service

Maxify is a full-stack personal music streaming service built with modern technologies. It allows users to upload, organize, and stream their personal music collection through a beautiful web interface.

🚀 Features

🎵 Music Management

Upload audio files (MP3, WAV, FLAC, AAC, OGG, M4A)
Automatic metadata extraction
Personal music library organization
Advanced search functionality

📋 Playlist System

Create and manage custom playlists
Add/remove tracks from playlists
Playlist sharing and organization
Drag & drop playlist management

▶️ Audio Player

Web-based audio player with full controls
Play/pause, skip, seek functionality
Volume control
Queue management
Real-time progress tracking

🔐 Authentication & Security

JWT-based authentication
Secure user registration and login
Protected routes and API endpoints
Password hashing with bcrypt

🎨 Modern UI/UX

Responsive design with Tailwind CSS
Beautiful components with shadcn/ui
Dark/light theme support
Mobile-friendly interface
Real-time notifications

🛠️ Tech Stack

Backend (Go)

Framework: Gin
Database: PostgreSQL
Cache: Redis
ORM: GORM
Authentication: JWT with golang-jwt
File Storage: Local filesystem

Frontend (Next.js)

Framework: Next.js 14 with App Router
Language: TypeScript
Styling: Tailwind CSS
Components: shadcn/ui
Forms: React Hook Form + Zod
HTTP Client: Axios
Icons: Lucide React

📁 Project Structure

maxify/
├── server/                 # Go backend
│   ├── cmd/server/        # Application entry point
│   ├── internal/          # Internal packages
│   │   ├── config/        # Configuration management
│   │   ├── database/      # Database connections
│   │   ├── models/        # Data models
│   │   ├── services/      # Business logic
│   │   ├── controllers/   # HTTP handlers
│   │   ├── middleware/    # HTTP middleware
│   │   └── routes/        # Route definitions
│   ├── docker-compose.yml # Docker services
│   ├── go.mod            # Go dependencies
│   └── Makefile          # Build commands
├── client/                # Next.js frontend
│   ├── src/
│   │   ├── app/          # Next.js app router pages
│   │   ├── components/   # React components
│   │   ├── contexts/     # React contexts
│   │   └── lib/          # Utilities and API client
│   ├── package.json      # Node.js dependencies
│   └── tailwind.config.js # Tailwind configuration
└── docs/                 # Project documentation

🚀 Quick Start

Prerequisites

Go 1.21+
Node.js 18+
Docker and Docker Compose
Git

1. Clone the Repository

git clone <repository-url>
cd maxify

2. Start Backend Services

cd server

# Copy environment file
cp env.example .env

# Start PostgreSQL and Redis
docker-compose up -d

# Install Go dependencies
go mod tidy

# Run the server
go run cmd/server/main.go

The backend will be available at http://localhost:8080

3. Start Frontend

cd client

# Copy environment file
cp env.local.example .env.local

# Install dependencies
npm install

# Start development server
npm run dev

The frontend will be available at http://localhost:3000

4. Access the Application

Open http://localhost:3000 in your browser
Register a new account or login
Upload your first audio file
Create playlists and start streaming!

📚 API Documentation

Authentication Endpoints

POST /api/v1/auth/register - Register new user
POST /api/v1/auth/login - User login
POST /api/v1/auth/logout - User logout

User Endpoints

GET /api/v1/users/profile - Get user profile
PUT /api/v1/users/profile - Update user profile
GET /api/v1/users/stats - Get user statistics

Track Endpoints

POST /api/v1/tracks/upload - Upload audio file
GET /api/v1/tracks - Get user's tracks
GET /api/v1/tracks/:id - Get specific track
DELETE /api/v1/tracks/:id - Delete track
GET /api/v1/tracks/:id/stream - Stream audio file

Playlist Endpoints

POST /api/v1/playlists - Create playlist
GET /api/v1/playlists - Get user's playlists
GET /api/v1/playlists/:id - Get specific playlist
PUT /api/v1/playlists/:id - Update playlist
DELETE /api/v1/playlists/:id - Delete playlist
POST /api/v1/playlists/:id/tracks - Add track to playlist
DELETE /api/v1/playlists/:id/tracks/:trackId - Remove track from playlist

Search Endpoints

GET /api/v1/search?q=query - General search
GET /api/v1/search/tracks?q=query - Search tracks
GET /api/v1/search/playlists?q=query - Search playlists
GET /api/v1/search/suggestions?q=query - Get search suggestions

🐳 Docker Deployment

Backend Services

cd server
docker-compose up -d

Production Build

# Build backend
cd server
go build -o bin/maxify cmd/server/main.go

# Build frontend
cd client
npm run build

🧪 Testing

Backend Tests

cd server
go test ./...

Frontend Tests

cd client
npm test

📝 Development

Backend Development

cd server
go run cmd/server/main.go

Frontend Development

cd client
npm run dev

Code Formatting

# Backend
cd server
go fmt ./...

# Frontend
cd client
npm run lint
npm run format

🔧 Configuration

Backend Configuration

Edit server/.env:

DB_HOST=localhost
DB_PORT=5432
DB_USER=maxify_user
DB_PASSWORD=maxify_password
DB_NAME=maxify

REDIS_HOST=localhost
REDIS_PORT=6379

JWT_SECRET=your-secret-key
JWT_EXPIRY=24h

PORT=8080
UPLOAD_DIR=./uploads
MAX_FILE_SIZE=50MB

Frontend Configuration

Edit client/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8080/api/v1

📄 Documentation

Software Requirements Specification: SRS
Domain Model: DM
Use Cases: UC
Architecture Diagrams: Component, Deployment

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is for educational purposes only.

🙏 Acknowledgments

Gin - HTTP web framework
Next.js - React framework
shadcn/ui - UI components
Tailwind CSS - CSS framework
Lucide - Beautiful icons

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
client		client
docs		docs
server		server
.gitignore		.gitignore
README.md		README.md

maks2134/maxify

Folders and files

Latest commit

History

Repository files navigation