🎬 StreamSphere

Enterprise-Grade Video Streaming Platform built with Full Stack TypeScript

A scalable cloud-based video streaming platform featuring secure authentication, high-performance media delivery, AWS cloud integration, and modern full-stack architecture.

---

🚀 Overview

StreamSphere is a production-ready video streaming platform inspired by modern OTT applications. It allows users to securely upload, manage, stream, and organize video content while leveraging AWS cloud services for scalable media storage.

The project follows industry-standard backend architecture using NestJS, Next.js, MongoDB, AWS S3, Docker, and JWT Authentication.

✨ Features

🔐 Authentication	🎥 Video Management	☁️ Media Storage
✅ User Registration	✅ Upload Videos	✅ AWS S3 Upload
✅ Secure Login	✅ Delete Videos	✅ Secure File Storage
✅ JWT Authentication	✅ Edit Metadata	✅ Signed URLs
✅ Refresh Tokens	✅ Categories	✅ Thumbnail Storage
✅ Protected APIs	✅ Thumbnail Upload	✅ Automatic File Removal
✅ Role-Based Authorization	✅ Video Details

👤 User Features	🛠 Admin Features
✅ Profile Management	✅ Dashboard
✅ Watch History	✅ User Management
✅ Continue Watching	✅ Content Management
✅ Search Videos	✅ Analytics Ready
✅ Responsive UI

🛠 Tech Stack

Category	Technologies
Frontend
Backend
Database
Cloud
DevOps
API Documentation & Testing
Version Control

🏗 System Architecture

---

📁 Project Structure

StreamSphere

├── frontend
│   ├── app
│   ├── components
│   ├── hooks
│   ├── services
│   └── utils
│
├── backend
│   ├── src
│   │   ├── auth
│   │   ├── users
│   │   ├── videos
│   │   ├── uploads
│   │   ├── common
│   │   └── config
│   │
│   └── Dockerfile
│
├── docker-compose.yml
├── README.md
└── .env.example

---

⚙ Installation

Clone Repository

git clone https://github.com/jyoti1900/StreamSphere.git

cd StreamSphere

Backend

cd backend

npm install

Frontend

cd frontend

npm install

---

🔑 Environment Variables

Backend

PORT=3000
MONGO_URI=<your_mongodb_connection_string>
JWT_SECRET=<your_jwt_secret>
JWT_REFRESH_SECRET=<your_jwt_refresh_secret>
AWS_REGION=<your_aws_region>
AWS_ACCESS_KEY_ID=<your_access_key_id>
AWS_SECRET_ACCESS_KEY=<your_secret_access_key>
AWS_BUCKET_NAME=<your_s3_bucket_name>
CLOUDFRONT_URL=<your_cloudfront_distribution_url>

Frontend

NEXT_PUBLIC_API_URL=http://localhost:3000

---

▶ Running Locally

Backend

npm run start:dev

Frontend

npm run dev

---

🐳 Docker

Build

docker-compose build

Run

docker-compose up -d

Stop

docker-compose down

---

☁ Deployment Flow

---

🔐 Authentication Flow

---

📦 API Modules

Module	Description
🔐 Authentication	User registration, login, JWT, refresh tokens
👤 Users	User profile and account management
🎥 Videos	Upload, update, delete, and stream videos
☁️ Uploads	Media upload and file handling
🗂 Categories	Video categorization and organization
🔍 Search	Search and filter videos
📊 Dashboard	Analytics and administrative overview

🔒 Security

Security Feature	Purpose
🔑 JWT Authentication	Secure user authentication
🔒 Password Hashing	Encrypt user passwords
🛡 Protected Routes	Restrict unauthorized access
⚙ Environment Variables	Secure configuration management
☁️ AWS IAM Permissions	Controlled cloud resource access
📤 Secure File Upload	Safe media upload handling
✅ Input Validation	Prevent invalid or malicious input
📋 Request Validation	Ensure API request integrity

⚡ Performance Optimizations

Optimization	Benefit
⚡ Lazy Loading	Faster initial page load
🍃 Optimized MongoDB Queries	Reduced database response time
🖼 Image Compression	Lower bandwidth usage
🔗 Efficient API Design	Improved backend performance
🏗 Modular Architecture	Better scalability and maintainability
☁️ Cloud Storage	Reliable and scalable media storage
🐳 Dockerized Deployment	Consistent development and production environments
📘 TypeScript Strict Mode	Improved code quality and reliability

📈 Future Improvements

Feature	Description
📡 Live Streaming	Real-time video broadcasting
🤖 Video Recommendations	AI-powered personalized suggestions
💳 Subscription Plans	Premium membership support
💰 Payment Gateway	Secure online payments
🔎 AI Video Search	Intelligent content discovery
🔔 Notifications	Real-time user alerts
👥 Watch Together	Shared viewing experience
🌐 Multi-language Support	Localization for global users
📊 Analytics Dashboard	Advanced insights and reporting

---

🤝 Contributing

Contributions are welcome.

1. Fork the repository

2. Create your feature branch

git checkout -b feature/new-feature

3. Commit changes

git commit -m "Add new feature"

4. Push

git push origin feature/new-feature

5. Create Pull Request

---

📄 License

This project is licensed under the MIT License.

---

👨‍💻 Developed By

Team Member	Contribution
Jyotipriya Das	🚀 Project Lead, Backend Development, Cloud Infrastructure (AWS), CI/CD Pipeline, Docker, System Architecture
Sayan Pal	💻 Full Stack Development, Testing, Debugging, UI/UX Implementation
Indrajit Sahu	🎨 Frontend Development, UI Components, User Experience

---

⭐ If you found this project helpful, consider giving it a Star!