A SoundCloud-inspired social music streaming platform — built as a full-stack university Software Engineering project.

Rythmify is a full-featured music streaming platform supporting audio upload, social interaction, real-time messaging, playback, and premium subscriptions. It is developed across five parallel sub-teams — Backend, Frontend, Cross-Platform, Testing, and DevOps — following a structured phased delivery model.

The platform targets feature parity with SoundCloud, covering artist and listener roles, social graphs, waveform-timestamped comments, notifications, playlists, and an admin moderation dashboard.

Rythmify follows a layered, service-oriented architecture across three client surfaces:

┌─────────────────────────────────────────────────────────────────┐
│                         CLIENT LAYER                            │
│   React 18 (Web)       Flutter (iOS/Android)                    │
└───────────────────────────┬─────────────────────────────────────┘
                            │ REST + Socket.IO
┌───────────────────────────▼─────────────────────────────────────┐
│                      APPLICATION LAYER                          │
│   Node.js + Express.js API · Socket.IO (notifications, chat)    │
│   Layered: Routes → Controllers → Services → Models             │
└───────┬──────────────────────────────────────┬──────────────────┘
        │                                      │
┌───────▼──────────┐                  ┌────────▼─────────────────┐
│   DATA LAYER     │                  │   STORAGE LAYER          │
│   PostgreSQL 16  │                  │   Azure Blob Storage     │
│   (primary DB)   │                  │   (audio + media files)  │
└──────────────────┘                  └──────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                        DEVOPS LAYER                             │
│   GitHub Actions CI/CD · Docker · Azure Container Apps          │
│   Azure Static Web Apps · Azure PostgreSQL · Monitoring         │
└─────────────────────────────────────────────────────────────────┘

• Runtime: Node.js + Express.js
• Database: PostgreSQL 16 (full-text search via tsvector, JSONB metadata)
• Auth: JWT (15-min access tokens) + refresh token rotation in httpOnly cookies
• Real-Time: Socket.IO (live notifications, 1-to-1 messaging)
• File Storage: Azure Blob Storage (audio + cover art; URLs stored in DB)
• Payments: Stripe SDK (mocked checkout flow)
• API Spec: OpenAPI 3.0 (openapi.yaml — shared contract across all teams)

• Framework: React 18 + TypeScript
• Styling: Tailwind CSS + CSS Variables
• State: Zustand (auth, player, notifications stores)
• HTTP: Axios (shared interceptors for auth headers + error handling)
• Forms: React Hook Form + Zod
• Build: Vite

• Framework: Flutter + Dart
• Architecture: Clean Architecture (Data / Domain / Presentation)
• State: Riverpod
• HTTP: Dio (interceptors, retry logic)
• Navigation: GoRouter
• Local Storage: Hive / SharedPreferences

• Web E2E: Cypress (Page Object Model, selector abstraction)
• Mobile E2E: Appium (Android + iOS automation)
• Performance: k6 (load, stress, and API throughput)
• Task Tracking: ClickUp

• CI/CD: GitHub Actions
• Containerisation: Docker + Docker Compose
• Cloud: Azure (Container Apps, Static Web Apps, ACR, Blob Storage, PostgreSQL)
• Monitoring: Grafana + internal resource monitoring

Team Leader & DevOps Engineer: Mohamed Alabasy

The full API is documented as an OpenAPI 3.0.3 specification (openapi.yaml) in rythmify-backend.

Rate Limits

• General API: 100 requests / 15 min
• Auth endpoints: 5 requests / 15 min
• File uploads: 20 requests / hour

File Upload Limits

• Audio: 100 MB max (MP3, WAV, FLAC, AAC)
• Avatar / Cover Photo: 5 MB (JPG, PNG, WEBP)

Each repo contains its own setup guide. The DevOps repo provides a unified Docker Compose environment for local development.

# Clone the DevOps repo for local environment setup
git clone https://github.com/Rythmify/devops
cd devops

# Start all services (backend, frontend, database, Azurite blob emulator)
docker compose up

See devops/README.md for full local setup instructions, environment variable templates, and service port mappings.

• main — production-ready code only; protected branch
• dev — integration branch for all feature work
• Feature branches follow the pattern: feature-<short-description>
  • Example: feature-trending-feed, feature-player-controls

All PRs require review before merging into dev. Huge commits are forbidden — keep changes focused and atomic.

This project is developed for academic purposes as part of a university Software Engineering course.

Rythmify · Phase 4 Complete · Built with ❤️ by a team of 19