- Video & Image Sharing - Upload and share multimedia content
- User Authentication - Secure registration and login system
- Interactive Comments - Nested comments with reactions
- User Profiles - Customizable user profiles with subscriptions
- Content Discovery - Search and explore content
- Admin Dashboard - Content moderation and user management
- Node.js 18.0 or higher
- MongoDB database
- SMTP server (for emails)
-
Clone and install dependencies
git clone https://github.com/Lumeroo/lumeroo.git cd lumeroo npm install cd Backend && npm install && cd ..
-
Configure environment
Frontend (.env.local)
NEXT_PUBLIC_API_URL=http://localhost:3002
Backend (.env)
DATABASE_URL=mongodb://localhost:27017/lumeroo JWT_SECRET=your_jwt_secret SMTP_USERNAME=your_smtp_username SMTP_PASSWORD=your_smtp_password
-
Start development servers
# Terminal 1 - Backend cd Backend && npm run dev # Terminal 2 - Frontend npm run dev
lumeroo/
├── app/ # Next.js App Router
│ ├── page.tsx # Homepage
│ ├── layout.tsx # Root layout
│ ├── globals.css # Global styles
│ ├── watch/ # Content viewing pages
│ │ └── page.tsx # Video/image viewer
│ ├── upload/ # Content upload
│ │ └── page.jsx # Upload interface
│ ├── profile/ # User profiles
│ │ └── page.tsx # Profile pages
│ ├── search/ # Search functionality
│ │ └── page.tsx # Search results
│ ├── admin/ # Admin dashboard
│ │ └── page.tsx # Admin interface
│ ├── youtube-downloader/ # YouTube download feature
│ │ └── page.jsx # YouTube downloader
│ ├── terms-of-service/ # Legal pages
│ │ └── page.jsx # Terms of Service
│ ├── privacy-policy/ # Privacy policy
│ │ └── page.jsx # Privacy Policy
│ └── dmca/ # DMCA notice
│ └── page.jsx # DMCA compliance
├── components/ # React components
│ ├── NavBar.tsx # Navigation component
│ ├── Footer.jsx # Footer component
│ ├── VideoGrid.tsx # Video grid display
│ ├── ImageGrid.tsx # Image grid display
│ ├── HLSVideoPlayer.tsx # Custom HLS video player
│ ├── authModel.jsx # Authentication modal
│ ├── UploadModal.jsx # Upload modal component
│ ├── ProfileVideoGrid.jsx # Profile video grid
│ ├── ProfileImageGrid.jsx # Profile image grid
│ ├── SubscriptionGrid.jsx # Subscription content grid
│ └── Types.ts # TypeScript type definitions
├── hooks/ # Custom React hooks
│ └── useUserAvatar.js # Avatar management hook
├── lib/ # Utility libraries
├── public/ # Static assets
├── Backend/ # Server application
│ ├── server.js # Main server entry point
│ ├── package.json # Backend dependencies
│ ├── .env # Environment variables
│ ├── temp/ # Temporary file storage
│ ├── models/ # Database models
│ │ ├── User.js # User schema
│ │ ├── Video.js # Video schema
│ │ ├── Image.js # Image schema
│ │ ├── Comment.js # Comment schema
│ │ ├── Report.js # Report schema
│ │ ├── PendingUser.js # Email verification schema
│ │ ├── PendingPasswordReset.js # Password reset schema
│ │ └── index.js # Model exports
│ ├── utils/ # Utility functions
│ │ └── emailUtils.js # Email sending utilities
│ └── routes/ # API endpoints
│ ├── check.js # Health check
│ ├── signin.js # User login
│ ├── signup.js # User registration
│ ├── verify.js # Email verification
│ ├── resetPass.js # Password reset request
│ ├── resetVerify.js # Password reset verification
│ ├── resetDone.js # Password reset completion
│ ├── resend.js # Resend verification email
│ ├── googleAuth.js # Google OAuth authentication
│ ├── uploadVideo.js # Video upload & processing
│ ├── uploadImage.js # Image upload & processing
│ ├── content.js # Content retrieval
│ ├── video.js # Video streaming (HLS)
│ ├── image.js # Image serving
│ ├── comments.js # Comment system
│ ├── interactions.js # Likes/subscriptions
│ ├── search.js # Search functionality
│ ├── profile.js # User profiles
│ ├── updateAvatar.js # Profile avatar updates
│ ├── updateBio.js # Profile bio updates
│ ├── updateUsername.js # Username updates
│ ├── recommended.js # Content recommendations
│ ├── related.js # Related content
│ ├── discover.js # Content discovery
│ ├── discoverImages.js # Image discovery
│ ├── reports.js # Content reporting
│ ├── content.js # Content deletion
│ ├── user.js # User deletion
│ ├── youtubeDown.js # YouTube content download
│ └── youtubeUpload.js # YouTube content processing
├── config.json # Frontend configuration
├── LICENSE # MIT License
├── package.json # Frontend dependencies
├── tsconfig.json # TypeScript configuration
├── tailwind.config.ts # Tailwind CSS configuration
├── next.config.ts # Next.js configuration
├── eslint.config.mjs # ESLint configuration
├── postcss.config.mjs # PostCSS configuration
├── next-env.d.ts # Next.js type definitions
├── .gitignore # Git ignore rules
└── README.md # Project documentation
Lumeroo includes a custom self-hosted video streaming solution built into the backend with HLS (HTTP Live Streaming) support. You can easily replace this with your preferred video hosting service (Cloudflare Stream, AWS S3, etc.) by modifying the upload and streaming endpoints.
- Frontend: Next.js 15, TypeScript, Tailwind CSS
- Backend: Node.js, Hono framework, MongoDB
- Authentication: JWT with email verification
- Video Streaming: Custom HLS implementation with FFmpeg processing
POST /api/signin- User loginPOST /api/signup- User registrationPOST /api/verify- Email verification
POST /api/uploadVideo- Upload videoPOST /api/uploadImage- Upload imagesGET /api/content/:slug- Get contentGET /api/video/:id- Stream video
GET /api/comments/:type/:id- Get commentsPOST /api/interactions/toggle-like- Like contentPOST /api/interactions/subscribe- Subscribe to users
The default implementation uses a custom backend streaming solution. To use external services:
- Replace upload endpoints in
Backend/routes/uploadVideo.js - Update streaming logic in
Backend/routes/video.js - Modify frontend player in
app/watch/page.tsx
- Theme colors: Edit
tailwind.config.ts - Global styles: Modify
app/globals.css
We welcome contributions from the community! Here's how you can help:
- Fork the repository and clone your fork
- Create a feature branch from
maingit checkout -b feature/your-feature-name
- Make your changes following our coding standards
- Test your changes thoroughly
- Commit with clear messages
git commit -m "feat: add new feature description" - Push and create a Pull Request
- ESLint - Follow the existing linting rules
- TypeScript - Use proper type annotations
- Commit Messages - Use conventional commits (feat:, fix:, docs:, etc.)
- Code Style - Match the existing code formatting
- 🐛 Bug Fixes - Report and fix issues
- ✨ Features - Add new functionality
- 📚 Documentation - Improve guides and comments
- 🎨 UI/UX - Enhance design and user experience
- ⚡ Performance - Optimize code and loading times
- 🧪 Testing - Add unit and integration tests
- Ensure your PR has a clear title and description
- Reference any related issues
- Include screenshots for UI changes
- Update documentation if needed
- Make sure all tests pass
MIT License - see LICENSE for details.
Built with ❤️ for the community