🎬 Streamify

A Modern Full-Stack Video Streaming Platform

Streamify is a production-ready video streaming platform similar to YouTube, featuring video uploads, user authentication, playlists, subscriptions, and more. Built with modern technologies and best practices.

Features · Demo · Installation · Documentation · Contributing

✨ Features

🎥 Video Management

Feature	Description
Video Upload	Upload videos up to 2GB with drag-and-drop support
Auto Compression	Server-side video compression using FFmpeg
Custom Player	Built-in video player with playback controls
Thumbnails	Auto-generated or custom thumbnail upload
Publish Control	Publish/unpublish videos with one click
Video Editing	Update title, description, tags, and thumbnail

👤 User System

Feature	Description
Email Verification	Secure email verification on registration
Password Reset	Email-based password recovery
Profile Management	Custom avatars and cover images
Channel System	Each user has their own channel
JWT Authentication	Secure token-based authentication
Session Management	Auto token refresh, graceful logout

📺 Social Features

Feature	Description
Subscriptions	Subscribe to channels you love
Like/Dislike	React to videos
Comments	Comment on videos with replies
Watch History	Track your viewing history
Watch Later	Save videos to watch later
Playlists	Create and manage playlists

🛡️ Security & Performance

Feature	Description
Rate Limiting	Protection against brute force attacks
Helmet	HTTP security headers
CORS	Configurable cross-origin settings
Input Validation	Express-validator for all inputs
Lazy Loading	React.lazy for code splitting
GZIP Compression	Reduced response sizes

🖼️ Demo

📸 Screenshots

Home Page	Video Player	User Profile

🎥 Live Demo

Live Link: https://streamify-demo.vercel.app (Coming Soon)

❓ Troubleshooting

MongoDB Connection Error

Ensure your IP is whitelisted in MongoDB Atlas or allow all IPs (0.0.0.0/0).
Check if MONGODB_URL in .env is correct and includes username/password.
If password has special characters, URL encode them.

Cloudinary Upload Failed

Verify CLOUD_NAME, API_KEY, and API_SECRET in backend/.env.
Ensure your internet connection is stable.
Check file size limits in constants.js (default 2GB for video).

Email Not Sending

Ensure you are using an App Password for Gmail, not your login password.
Check if SMTP_HOST and SMTP_PORT are correct.
Verify EMAIL_FROM is a valid email address.

CORS Error

Ensure CORS_ORIGIN in backend/.env matches your frontend URL (e.g., http://localhost:5173).
If testing from a different device, ensure backend is accessible via network IP.

🛠️ Tech Stack

Frontend

Technology	Version	Purpose
React	18.3	UI library with hooks
Vite	6.0	Build tool & dev server
TailwindCSS	3.4	Utility-first CSS
Framer Motion	12.6	Animations
React Router	7.1	Client-side routing
Axios	1.9	HTTP client
React Hot Toast	2.5	Toast notifications
Heroicons	2.2	Icon library

Backend

Technology	Version	Purpose
Node.js	18+	JavaScript runtime
Express	4.21	Web framework
MongoDB	7.0	NoSQL database
Mongoose	8.9	MongoDB ODM
Cloudinary	2.5	Media storage & CDN
Nodemailer	6.9	Email service
FFmpeg	-	Video processing
JWT	9.0	Authentication

DevOps & Tools

Tool	Purpose
ESLint	Code linting
Prettier	Code formatting
Nodemon	Dev auto-reload
Handlebars	Email templates

🏗️ Architecture

System Overview

System Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                              🖥️ CLIENT LAYER                                │
│                     ┌──────────────┐  ┌──────────────┐                      │
│                     │ Web Browser  │  │Mobile Browser│                      │
│                     └──────┬───────┘  └──────┬───────┘                      │
└─────────────────────────────┼────────────────┼──────────────────────────────┘
                              │                │
                              ▼                ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                        ⚛️ FRONTEND (React + Vite)                           │
│  ┌─────────┐  ┌─────────────┐  ┌────────────┐  ┌───────┐  ┌──────────────┐  │
│  │ App.jsx │→ │React Router │→ │  Context   │→ │ Hooks │→ │ API Services │  │
│  └─────────┘  └─────────────┘  └────────────┘  └───────┘  └──────┬───────┘  │
└──────────────────────────────────────────────────────────────────┼──────────┘
                                                                   │ HTTP
                                                                   ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                      🚀 BACKEND (Node.js + Express)                         │
│  ┌─────────┐  ┌────────┐  ┌────────────┐  ┌─────────────┐  ┌─────────────┐  │
│  │ Express │→ │ Routes │→ │ Middleware │→ │ Controllers │→ │   Models    │  │
│  └─────────┘  └────────┘  └────────────┘  └──────┬──────┘  └──────┬──────┘  │
└──────────────────────────────────────────────────┼───────────────┼──────────┘
                                                   │               │
                              ┌────────────────────┼───────────────┘
                              ▼                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           ☁️ EXTERNAL SERVICES                              │
│         ┌──────────────┐      ┌──────────────┐      ┌──────────────┐        │
│         │   MongoDB    │      │  Cloudinary  │      │ Email Server │        │
│         │    Atlas     │      │     CDN      │      │    (SMTP)    │        │
│         └──────────────┘      └──────────────┘      └──────────────┘        │
└─────────────────────────────────────────────────────────────────────────────┘

Request Flow

  ┌──────────┐          ┌──────────┐          ┌────────────┐          ┌──────────┐
  │  Client  │          │   API    │          │ Middleware │          │Controller│
  └────┬─────┘          └────┬─────┘          └─────┬──────┘          └────┬─────┘
       │                     │                      │                      │
       │  HTTP Request       │                      │                      │
       │────────────────────>│                      │                      │
       │                     │                      │                      │
       │                     │  Rate Limit Check    │                      │
       │                     │─────────────────────>│                      │
       │                     │                      │                      │
       │                     │                      │  Auth Validation     │
       │                     │                      │──────────────────────>
       │                     │                      │                      │
       │                     │                      │                      │  ┌──────────┐
       │                     │                      │                      │─>│ Database │
       │                     │                      │                      │  └────┬─────┘
       │                     │                      │                      │       │
       │                     │                      │                      │<──────┘
       │                     │                      │                      │
       │                     │                      │<─────────────────────│
       │                     │<─────────────────────│                      │
       │<────────────────────│                      │                      │
       │   JSON Response     │                      │                      │
       │                     │                      │                      │

Authentication Flow

                                    ┌─────────────────┐
                                    │ Unauthenticated │
                                    └────────┬────────┘
                                             │
                    ┌────────────────────────┼────────────────────────┐
                    │                        │                        │
                    ▼                        ▼                        ▼
            ┌───────────────┐        ┌──────────────┐        ┌────────────────┐
            │   Register    │        │    Login     │        │Forgot Password │
            └───────┬───────┘        └──────┬───────┘        └───────┬────────┘
                    │                       │                        │
                    ▼                       │                        ▼
            ┌───────────────┐               │                ┌────────────────┐
            │  Email Sent   │               │                │  Reset Email   │
            └───────┬───────┘               │                └───────┬────────┘
                    │                       │                        │
                    ▼                       │                        ▼
            ┌───────────────┐               │                ┌────────────────┐
            │   Verified    │               │                │ Password Reset │
            └───────┬───────┘               │                └───────┬────────┘
                    │                       │                        │
                    └───────────┬───────────┘                        │
                                │                                    │
                                ▼                                    │
                    ┌───────────────────────┐                        │
                    │    Authenticated      │<───────────────────────┘
                    └───────────┬───────────┘
                                │
                    ┌───────────┼───────────┐
                    │           │           │
                    ▼           │           ▼
         ┌──────────────────┐   │   ┌───────────────┐
         │  Token Refresh   │   │   │    Logout     │
         └────────┬─────────┘   │   └───────┬───────┘
                  │             │           │
                  └─────────────┘           │
                                            ▼
                                ┌─────────────────┐
                                │ Unauthenticated │
                                └─────────────────┘

🚀 Installation

Prerequisites

Before you begin, ensure you have the following installed:

Requirement	Version	Check Command
Node.js	18+	`node --version`
npm	9+	`npm --version`
MongoDB	6+	`mongod --version`
FFmpeg	4+	`ffmpeg -version`
Git	2+	`git --version`

Step 1: Clone Repository

git clone https://github.com/Anurag-Basuri/streamify.git
cd streamify

Step 2: Install Dependencies

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

Step 3: Environment Setup

Create environment files in both directories (see Configuration section).

Step 4: Start Development Servers

Terminal 1 - Backend:

cd backend
npm run dev

Terminal 2 - Frontend:

cd frontend
npm run dev

Step 5: Access Application

Service	URL
Frontend	http://localhost:5173
Backend API	http://localhost:8000
Health Check	http://localhost:8000/health
API Status	http://localhost:8000/status

⚙️ Configuration

Backend Environment Variables

Create backend/.env:

# ═══════════════════════════════════════════
# SERVER CONFIGURATION
# ═══════════════════════════════════════════
PORT=8000
NODE_ENV=development

# ═══════════════════════════════════════════
# DATABASE
# ═══════════════════════════════════════════
MONGODB_URL=mongodb+srv://username:password@cluster.mongodb.net
DB_NAME=streamify

# ═══════════════════════════════════════════
# AUTHENTICATION
# ═══════════════════════════════════════════
ACCESS_TOKEN_SECRET=your_super_secret_access_key_min_32_chars
REFRESH_TOKEN_SECRET=your_super_secret_refresh_key_min_32_chars
ACCESS_TOKEN_EXPIRY=15m
REFRESH_TOKEN_EXPIRY=7d
SESSION_SECRET=your_session_secret

# ═══════════════════════════════════════════
# CLOUDINARY (Media Storage)
# ═══════════════════════════════════════════
CLOUD_NAME=your_cloudinary_cloud_name
API_KEY=your_cloudinary_api_key
API_SECRET=your_cloudinary_api_secret

# ═══════════════════════════════════════════
# EMAIL CONFIGURATION (Optional)
# ═══════════════════════════════════════════
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASS=your_app_password
EMAIL_FROM="Streamify <noreply@streamify.com>"

# ═══════════════════════════════════════════
# CORS & FRONTEND
# ═══════════════════════════════════════════
CORS_ORIGIN=http://localhost:5173
FRONTEND_URL=http://localhost:5173

Frontend Environment Variables

Create frontend/.env:

VITE_API_URL=http://localhost:8000

Getting Required Credentials

📧 Gmail App Password (for Email)

Go to Google Account Security
Enable 2-Step Verification
Go to App passwords
Generate a new app password for "Mail"
Use this password as SMTP_PASS

☁️ Cloudinary Credentials

Sign up at Cloudinary
Go to Dashboard
Copy Cloud Name, API Key, and API Secret
Use these in your .env file

🍃 MongoDB Atlas

Sign up at MongoDB Atlas
Create a new cluster
Create a database user
Get connection string from "Connect" button
Replace <password> with your database user password

📚 API Reference

Base URL

http://localhost:8000/api/v1

Authentication Endpoints

POST /users/register - Register new user

Request Body (multipart/form-data):

{
  "userName": "johndoe",
  "fullName": "John Doe",
  "email": "john@example.com",
  "password": "securepassword123",
  "avatar": "[file]"
}

Success Response (201):

{
  "statusCode": 201,
  "data": {
    "_id": "...",
    "userName": "johndoe",
    "email": "john@example.com",
    "isEmailVerified": false
  },
  "message": "Registration successful! Please check your email.",
  "success": true
}

POST /users/login - User login

Request Body:

{
  "email": "john@example.com",
  "password": "securepassword123"
}

Success Response (200):

{
  "statusCode": 200,
  "data": {
    "user": { ... },
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG..."
  },
  "message": "User logged in successfully",
  "success": true
}

GET /users/verify-email/:token - Verify email

Success Response (200):

{
  "statusCode": 200,
  "data": { "isEmailVerified": true },
  "message": "Email verified successfully",
  "success": true
}

POST /users/forgot-password - Request password reset

Request Body:

{
  "email": "john@example.com"
}

Response (200):

{
  "statusCode": 200,
  "data": null,
  "message": "If an account exists, a password reset email has been sent",
  "success": true
}

Video Endpoints

GET /videos - Get all videos

Query Parameters:

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	10	Items per page
sort	string	-createdAt	Sort field

Success Response (200):

{
  "statusCode": 200,
  "data": {
    "videos": [...],
    "totalDocs": 100,
    "page": 1,
    "limit": 10,
    "hasNextPage": true,
    "hasPrevPage": false
  },
  "success": true
}

POST /videos/upload - Upload video

Headers:

Authorization: Bearer <accessToken>
Content-Type: multipart/form-data

Request Body:

Field	Type	Required	Description
videoFile	file	Yes	Video file (mp4, webm)
thumbnail	file	Yes	Thumbnail image
title	string	Yes	Video title
description	string	Yes	Video description
tags	string	Yes	JSON array of tags

Complete API Endpoint List

Category	Method	Endpoint	Auth	Description
Auth	POST	/users/register	❌	Register user
	POST	/users/login	❌	Login
	POST	/users/logout	✅	Logout
	POST	/users/refresh-token	❌	Refresh tokens
	GET	/users/verify-email/:token	❌	Verify email
	POST	/users/forgot-password	❌	Request reset
	POST	/users/reset-password/:token	❌	Reset password
User	GET	/users/current-user	✅	Get profile
	PATCH	/users/change-password	✅	Change password
	PATCH	/users/change-avatar	✅	Update avatar
	PATCH	/users/update-details	✅	Update profile
	GET	/users/c/:username	❌	Get channel
Videos	GET	/videos	❌	List videos
	GET	/videos/:id	❌	Get video
	POST	/videos/upload	✅	Upload video
	PATCH	/videos/update/:id	✅	Update video
	DELETE	/videos/:id	✅	Delete video
	PATCH	/videos/:id/publish	✅	Toggle publish
	POST	/videos/:id/views	❌	Increment views
Playlists	GET	/playlists	✅	Get playlists
	POST	/playlists	✅	Create playlist
	PATCH	/playlists/:id	✅	Update playlist
	DELETE	/playlists/:id	✅	Delete playlist
Comments	GET	/comments/:videoId	❌	Get comments
	POST	/comments/:videoId	✅	Add comment
	DELETE	/comments/:id	✅	Delete comment
Likes	POST	/likes/video/:id	✅	Like video
	POST	/likes/comment/:id	✅	Like comment
Subscriptions	POST	/subscriptions/:channelId	✅	Toggle subscribe
	GET	/subscriptions	✅	Get subscriptions
History	GET	/history	✅	Get history
	DELETE	/history	✅	Clear history
Watch Later	GET	/watchlater	✅	Get watch later
	POST	/watchlater/:videoId	✅	Add to watch later

💾 Database Schema

Entity Relationships

┌──────────────────────────────────────────────────────────────────────────────┐
│                            DATABASE RELATIONSHIPS                            │
└──────────────────────────────────────────────────────────────────────────────┘

    ┌──────────┐         ┌──────────┐         ┌──────────┐
    │   USER   │────────<│  VIDEO   │>────────│ PLAYLIST │
    └────┬─────┘         └────┬─────┘         └──────────┘
         │                    │
         │    ┌───────────────┼───────────────┐
         │    │               │               │
         ▼    ▼               ▼               ▼
    ┌──────────┐         ┌──────────┐    ┌──────────┐
    │  LIKE    │         │ COMMENT  │    │ HISTORY  │
    └──────────┘         └──────────┘    └──────────┘
         │
         ▼
    ┌──────────────┐         ┌──────────────┐
    │ SUBSCRIPTION │         │ WATCH LATER  │
    └──────────────┘         └──────────────┘

    Legend:
    ──────< One-to-Many     >────── Many-to-One
    ──────○ Optional        ●────── Required

Collections Schema

👤 User Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`userName`	String	Unique username
`email`	String	Unique email
`fullName`	String	Display name
`password`	String	Hashed password
`avatar`	String	Profile image URL
`coverImage`	String	Banner image URL
`isEmailVerified`	Boolean	Email verification status
`emailVerificationToken`	String	Token for email verification
`emailVerificationExpires`	Date	Token expiry
`passwordResetToken`	String	Password reset token
`passwordResetExpires`	Date	Reset token expiry
`refreshToken`	String	JWT refresh token
`createdAt`	Date	Account creation date
`updatedAt`	Date	Last update date

🎥 Video Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`title`	String	Video title
`description`	String	Video description
`videoUrl`	String	Cloudinary video URL
`thumbnailUrl`	String	Thumbnail URL
`videoPublicId`	String	Cloudinary public ID
`thumbnailPublicId`	String	Thumbnail public ID
`duration`	Number	Video length in seconds
`views`	Number	View count
`isPublished`	Boolean	Publish status
`isDeleted`	Boolean	Soft delete flag
`owner`	ObjectId	Reference to User
`tags`	String[]	Video tags

📁 Playlist Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`name`	String	Playlist name
`description`	String	Playlist description
`owner`	ObjectId	Reference to User
`videos`	ObjectId[]	Array of Video references

💬 Comment Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`content`	String	Comment text
`video`	ObjectId	Reference to Video
`owner`	ObjectId	Reference to User

❤️ Like Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`video`	ObjectId	Reference to Video (optional)
`comment`	ObjectId	Reference to Comment (optional)
`likedBy`	ObjectId	Reference to User

🔔 Subscription Collection

Field	Type	Description
`_id`	ObjectId	Primary key
`subscriber`	ObjectId	User who subscribed
`channel`	ObjectId	Channel being subscribed to

📂 Project Structure

streamify/
│
├── 📂 frontend/                          # React Frontend Application
│   ├── 📂 public/                        # Static assets
│   ├── 📂 src/
│   │   ├── 📂 components/                # Reusable UI components
│   │   │   ├── 📂 Video/                 # Video player, cards, list
│   │   │   ├── 📂 Playlist/              # Playlist components
│   │   │   ├── 📂 Upload/                # File upload components
│   │   │   ├── 📂 Profile/               # Profile components
│   │   │   ├── 📂 Form/                  # Form components
│   │   │   ├── 📄 Header.jsx             # Navigation header
│   │   │   ├── 📄 Sidebar.jsx            # Side navigation
│   │   │   └── 📄 Modal.jsx              # Modal component
│   │   │
│   │   ├── 📂 pages/                     # Route page components
│   │   │   ├── 📂 Display/               # Home, Tweet, Subscription
│   │   │   ├── 📂 Account/               # History, Playlist, Videos
│   │   │   └── 📂 You/                   # Profile, Auth, Create
│   │   │
│   │   ├── 📂 context/                   # React Context providers
│   │   │   ├── 📄 AuthContext.jsx        # Authentication state
│   │   │   └── 📄 ThemeContext.jsx       # Theme management
│   │   │
│   │   ├── 📂 services/                  # API client & services
│   │   │   ├── 📄 api.js                 # Axios instance & config
│   │   │   ├── 📄 authService.js         # Auth API calls
│   │   │   └── 📄 videoService.js        # Video API calls
│   │   │
│   │   ├── 📂 hooks/                     # Custom React hooks
│   │   │   ├── 📄 useAuth.js             # Auth hook
│   │   │   ├── 📄 useDebounce.js         # Debounce hook
│   │   │   ├── 📄 useLocalStorage.js     # LocalStorage hook
│   │   │   └── 📄 useVideos.js           # Videos hook
│   │   │
│   │   ├── 📂 routes/                    # Route definitions
│   │   │   ├── 📄 AppRoutes.jsx          # All routes (lazy loaded)
│   │   │   └── 📄 ProtectedRoute.jsx     # Auth guard
│   │   │
│   │   ├── 📂 constants/                 # App constants
│   │   │   └── 📄 index.js               # Centralized constants
│   │   │
│   │   ├── 📄 App.jsx                    # Root component
│   │   ├── 📄 main.jsx                   # Entry point
│   │   └── 📄 index.css                  # Global styles
│   │
│   ├── 📄 package.json
│   ├── 📄 vite.config.js
│   └── 📄 tailwind.config.js
│
├── 📂 backend/                           # Node.js Backend Application
│   ├── 📂 src/
│   │   ├── 📂 controllers/               # Request handlers
│   │   │   ├── 📄 user.controller.js     # User operations
│   │   │   ├── 📄 video.controller.js    # Video CRUD
│   │   │   ├── 📄 email.controller.js    # Email verification
│   │   │   ├── 📄 playlist.controller.js # Playlist operations
│   │   │   ├── 📄 comment.controller.js  # Comment operations
│   │   │   ├── 📄 like.controller.js     # Like operations
│   │   │   └── 📄 subscription.controller.js
│   │   │
│   │   ├── 📂 routes/                    # Express routes
│   │   │   ├── 📄 user.routes.js         # /api/v1/users
│   │   │   ├── 📄 video.routes.js        # /api/v1/videos
│   │   │   └── 📄 ...                    # Other routes
│   │   │
│   │   ├── 📂 models/                    # Mongoose schemas
│   │   │   ├── 📄 user.model.js
│   │   │   ├── 📄 video.model.js
│   │   │   └── 📄 ...
│   │   │
│   │   ├── 📂 middlewares/               # Express middleware
│   │   │   ├── 📄 auth.middleware.js     # JWT verification
│   │   │   ├── 📄 multer.middleware.js   # File upload
│   │   │   └── 📄 validate.middleware.js # Input validation
│   │   │
│   │   ├── 📂 utils/                     # Utility functions
│   │   │   ├── 📄 cloudinary.js          # Cloudinary helpers
│   │   │   ├── 📄 email.js               # Email service
│   │   │   ├── 📄 APIerror.js            # Error class
│   │   │   └── 📄 APIresponse.js         # Response class
│   │   │
│   │   ├── 📂 templates/                 # Email templates
│   │   │   ├── 📄 verify-email.hbs
│   │   │   ├── 📄 welcome.hbs
│   │   │   ├── 📄 password-reset.hbs
│   │   │   └── 📄 password-changed.hbs
│   │   │
│   │   ├── 📂 database/                  # Database connection
│   │   │   └── 📄 index.js               # MongoDB connection
│   │   │
│   │   ├── 📄 app.js                     # Express app setup
│   │   ├── 📄 index.js                   # Server entry point
│   │   └── 📄 constants.js               # Backend constants
│   │
│   ├── 📄 package.json
│   └── 📄 .env.example
│
├── 📄 README.md
└── 📄 LICENSE

🔧 Development

Available Scripts

Backend:

npm run dev      # Start with nodemon (hot reload)
npm run start    # Production start

Frontend:

npm run dev      # Start Vite dev server
npm run build    # Production build
npm run preview  # Preview production build
npm run lint     # Run ESLint

Code Style

ESLint for JavaScript linting
Prettier for code formatting
Conventional Commits for commit messages

Testing API Endpoints

Use the following tools to test API:

Postman
Insomnia
Thunder Client (VS Code extension)

🚢 Deployment

Frontend (Vercel/Netlify)

Connect your GitHub repository
Set build command: npm run build
Set output directory: dist
Add environment variables

Backend (Railway/Render)

Connect your GitHub repository
Set root directory: backend
Set start command: npm start
Add all environment variables

Docker (Coming Soon)

docker-compose up -d

🗺️ Roadmap

🎯 Short-Term Goals (1-3 Months)

Category	Feature	Priority	Status
🎨 UI/UX	Dark/Light theme toggle	🔴 High	🟡 In Progress
	Mobile-responsive video player	🔴 High	📋 Planned
	Skeleton loading states	🟠 Medium	📋 Planned
	Improved error messages & feedback	🟠 Medium	📋 Planned
🔧 Backend	Redis caching for videos	🔴 High	📋 Planned
	Video quality selection (360p, 720p, 1080p)	🔴 High	📋 Planned
	Improved video compression pipeline	🟠 Medium	📋 Planned
	API documentation with Swagger	🟠 Medium	📋 Planned
🔐 Security	Two-factor authentication (2FA)	🟠 Medium	📋 Planned
	OAuth providers (GitHub, Discord)	🟢 Low	📋 Planned
	Account activity logging	🟢 Low	📋 Planned
✨ Features	Video chapters/timestamps	🟠 Medium	📋 Planned
	Nested comment replies	🟠 Medium	📋 Planned
	Share video to social media	🟢 Low	📋 Planned

🚀 Long-Term Goals (3-12 Months)

Category	Feature	Description
📺 Streaming	Live Streaming	Real-time video broadcasting with WebRTC/HLS
	Adaptive Bitrate Streaming	Auto-adjust quality based on network conditions
	Live Chat	Real-time chat during live streams with WebSocket
💰 Monetization	Creator Payments	Stripe integration for channel memberships
	Super Chat / Tips	Allow viewers to tip creators during streams
	Premium Subscriptions	Ad-free experience for paying users
🤖 AI Features	Auto-generated Captions	Speech-to-text for video subtitles
	Content Moderation	AI-powered comment and video moderation
	Video Recommendations	ML-based personalized video suggestions
📱 Platform	Mobile Apps	React Native apps for iOS and Android
	Desktop App	Electron app for Windows/Mac/Linux
	TV Apps	Smart TV applications (Android TV, Roku)
🔧 Infrastructure	Microservices Architecture	Split into video, user, notification services
	Kubernetes Deployment	Container orchestration for scalability
	Global CDN	Multi-region video delivery network
📊 Analytics	Creator Dashboard	Detailed analytics for video performance
	Viewer Insights	Watch time, retention, demographics
	Revenue Reports	Earnings breakdown and payout history

📌 Feature Request

Have an idea? Open an issue with the enhancement label!

🤝 Contributing

Contributions are welcome! Please follow these steps:

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

Commit Convention

Prefix	Description
`feat:`	New feature
`fix:`	Bug fix
`docs:`	Documentation
`style:`	Formatting
`refactor:`	Code restructuring
`test:`	Tests
`chore:`	Maintenance

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

Anurag Basuri

⭐ Star this repo if you find it helpful!

Made with ❤️ and lots of ☕

Name		Name	Last commit message	Last commit date
.github		.github
apps		apps
infra		infra
packages		packages
.dockerignore		.dockerignore
.env.docker.example		.env.docker.example
.gitignore		.gitignore
.hadolint.yaml		.hadolint.yaml
.prettierignore		.prettierignore
.prettierrc		.prettierrc
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
mermaid_urls.txt		mermaid_urls.txt
package.json		package.json
turbo.json		turbo.json

Latest commit

History

Folders and files

Repository files navigation

🎬 Streamify

A Modern Full-Stack Video Streaming Platform

📑 Table of Contents

✨ Features

🎥 Video Management

👤 User System

📺 Social Features

🛡️ Security & Performance

🖼️ Demo

📸 Screenshots

🎥 Live Demo

❓ Troubleshooting

🛠️ Tech Stack

Frontend

Backend

DevOps & Tools

🏗️ Architecture

System Overview

Request Flow

Authentication Flow

🚀 Installation

Prerequisites

Step 1: Clone Repository

Step 2: Install Dependencies

Step 3: Environment Setup

Step 4: Start Development Servers

Step 5: Access Application

⚙️ Configuration

Backend Environment Variables

Frontend Environment Variables

Getting Required Credentials

📚 API Reference

Base URL

Authentication Endpoints

Video Endpoints

Complete API Endpoint List

💾 Database Schema

Entity Relationships

Collections Schema

📂 Project Structure

🔧 Development

Available Scripts

Code Style

Testing API Endpoints

🚢 Deployment

Frontend (Vercel/Netlify)

Backend (Railway/Render)

Docker (Coming Soon)

🗺️ Roadmap

🎯 Short-Term Goals (1-3 Months)

🚀 Long-Term Goals (3-12 Months)

📌 Feature Request

🤝 Contributing

Commit Convention

📄 License

👤 Author

⭐ Star this repo if you find it helpful!

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages